detain 0.2.0

String interner
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

# detain

Fast, simple string interner.

## Usage

```rust
use detain::Interner;

let mut interner = Interner::new();

let hello = interner.intern("hello");
let world = interner.intern("world");
let hello2 = interner.intern("hello");

assert_eq!(hello, hello2);
assert_eq!(interner.resolve(hello), "hello");
```

## Features

- **Compact**: `Symbol` is 4 bytes
- **Fast**: FxHash + optimized for 110 common IPC-2581 identifiers
- **Simple**: Single growing arena, immutable, ~120 LOC

## Customizing

Edit `COMMON` in `src/lib.rs` to add your frequently-used strings:

```rust
static COMMON: phf::Map<&'static str, u32> = phf_map! {
    "x" => 0, "y" => 1, "your_identifier" => 2, // sequential indices
};
```

## Testing

```bash
# Unit tests
cargo test

# Property-based tests (100 cases per test by default)
cargo test proptests

# Fuzz testing
cargo +nightly fuzz run fuzz_interner -- -runs=10000
cargo +nightly fuzz run fuzz_common -- -runs=10000

# Miri (detects undefined behavior, proptests auto-skipped)
cargo +nightly miri test
```

## License

0BSD