neco-rand 0.1.0

Deterministic non-cryptographic random generators and stable bucket assignment
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

# neco-rand

Deterministic non-cryptographic random generators and stable bucket assignment.

Use this crate for simulation, sampling, and deterministic cohort splitting. Use cryptographic key handling, secure nonces, and security-sensitive random generation in dedicated cryptographic random crates.

## Features

- `SplitMix64` seed expansion
- `Xoroshiro128Plus` deterministic PRNG
- Stable bucket assignment from `key + experiment + salt`

## Usage

```rust
use neco_rand::{bucket, SplitMix64, Xoroshiro128Plus};

let mut seeder = SplitMix64::new(42);
let seed = seeder.next_u64();

let mut rng = Xoroshiro128Plus::new(seed);
let value = rng.next_f64();

let bucket_index = bucket::assign_bucket(b"user-1", b"exp-a", b"salt", 100);

assert!((0.0..1.0).contains(&value));
assert!(bucket_index < 100);
```

## API

| Item | Description |
|------|-------------|
| `SplitMix64` | Deterministic seed expansion and one-shot mixing |
| `Xoroshiro128Plus` | Fast deterministic PRNG for non-cryptographic use |
| `bucket` | Stable cohort assignment helpers |

## License

MIT