string-intern 0.1.7

Another implementation of string interning. Unique features: allows to define a type for each kind of interned values and a validator for the values of that type.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! String interning for rust
//!
//! # Example
//!
//! ```
//! use string_intern::{Validator, Symbol};
//!
//! struct UserIdSymbol;
//!
//! // This symbol may contain anything
//! impl Validator for UserIdSymbol {
//!     // Use an error from standard library to make example shorter
//!     type Err = ::std::string::ParseError;
//!     fn validate_symbol(val: &str) -> Result<(), Self::Err> {
//!         Ok(())
//!     }
//! }
//!
//! /// Actual symbol type you will use in code
//! type UserId = Symbol<UserIdSymbol>;
//!
//! // Create from const (panics on invalid input)
//! let x = UserId::from("user1");
//! // Create from user input
//! let y: UserId = format!("user{}", 1).parse().unwrap();
//! // Both point to the same bytes
//! assert!(x[..].as_bytes() as *const _ == y[..].as_bytes() as *const _);
//! ```
#[macro_use] extern crate lazy_static;
#[cfg(feature = "rustc-serialize")] extern crate rustc_serialize;
#[cfg(feature = "serde")] extern crate serde;
#[cfg(test)] extern crate serde_json;

mod base_type;
mod validator;

pub use base_type::Symbol;
pub use validator::Validator;

#[cfg(test)]
mod test {
    use super::{Validator, Symbol};

    struct AnyString;

    impl Validator for AnyString {
        // Use an error from standard library to make example shorter
        type Err = ::std::string::ParseError;
        fn validate_symbol(_: &str) -> Result<(), Self::Err> {
            Ok(())
        }
    }

    #[test]
    fn test_sync() {
        fn sync<T: Sync>(_: T) { }
        sync(Symbol::<AnyString>::from("x"))
    }

    #[test]
    fn test_send() {
        fn send<T: Send>(_: T) { }
        send(Symbol::<AnyString>::from("x"))
    }
}