#string-interning #servo #cache #cargo-toml #atom #part

string_cache

A string interning library for Rust, developed as part of the Servo project

67 releases

0.8.7 Mar 7, 2023
0.8.5 Feb 22, 2023
0.8.4 Mar 27, 2022
0.8.2 Oct 12, 2021
0.1.10 Jul 30, 2015

#22 in Caching

Download history 325706/week @ 2024-07-17 344065/week @ 2024-07-24 338104/week @ 2024-07-31 372035/week @ 2024-08-07 354324/week @ 2024-08-14 374847/week @ 2024-08-21 366798/week @ 2024-08-28 393136/week @ 2024-09-04 369820/week @ 2024-09-11 356459/week @ 2024-09-18 407087/week @ 2024-09-25 418718/week @ 2024-10-02 373273/week @ 2024-10-09 400514/week @ 2024-10-16 388211/week @ 2024-10-23 373683/week @ 2024-10-30

1,613,830 downloads per month
Used in 2,389 crates (55 directly)

MIT/Apache

32KB
482 lines

string-cache

Build Status

Documentation

A string interning library for Rust, developed as part of the Servo project.

Simple usage

In Cargo.toml:

[dependencies]
string_cache = "0.8"

In lib.rs:

extern crate string_cache;
use string_cache::DefaultAtom as Atom;

With static atoms

In Cargo.toml:

[package]
build = "build.rs"

[dependencies]
string_cache = "0.8"

[build-dependencies]
string_cache_codegen = "0.5"

In build.rs:

extern crate string_cache_codegen;

use std::env;
use std::path::Path;

fn main() {
    string_cache_codegen::AtomType::new("foo::FooAtom", "foo_atom!")
        .atoms(&["foo", "bar"])
        .write_to_file(&Path::new(&env::var("OUT_DIR").unwrap()).join("foo_atom.rs"))
        .unwrap()
}

In lib.rs:

extern crate string_cache;

mod foo {
    include!(concat!(env!("OUT_DIR"), "/foo_atom.rs"));
}

The generated code will define a FooAtom type and a foo_atom! macro. The macro can be used in expression or patterns, with strings listed in build.rs. For example:

fn compute_something(input: &foo::FooAtom) -> u32 {
    match *input {
        foo_atom!("foo") => 1,
        foo_atom!("bar") => 2,
        _ => 3,
    }
}

Dependencies

~0.5–5MB
~17K SLoC