# Rule30

[![Rust](https://github.com/kemingy/rule30/actions/workflows/rust.yml/badge.svg)](https://github.com/kemingy/rule30/actions/workflows/rust.yml)
[![crates.io](https://img.shields.io/crates/v/rule30.svg)](https://crates.io/crates/rule30)
[![docs.rs](https://docs.rs/rule30/badge.svg)](https://docs.rs/rule30)
[![PyPI](https://badge.fury.io/py/rule30py.svg)](https://pypi.org/project/rule30py)

Pseudo random number generator with cellular automaton rule 30.

## Features

- [x] `no_std`
- [x] Extend CA for better performance

## Usage

```rust
use rule30::prelude::*;


fn main() {
    let mut ca = ExtendedCA::seed_from_u64(42);
    println!("{}", ca.next_u64());
}
```

To work with `rand` crate:

```rust
use rule30::prelude::*;
use rand::Rng;


fn main() {
    let mut ca = ExtendedCA::seed_from_u64(42);
    println!("{}", ca.gen::<f64>());
}
```

For Python binding, check [rule30py](python/)

## Reference

- Wolfram [Rule30](https://reference.wolfram.com/language/tutorial/RandomNumberGeneration.html#830168163)
- Wolfram [ExtendedCA](https://reference.wolfram.com/language/tutorial/RandomNumberGeneration.html#18361715)
