random.org

A https://random.org client library. The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs.

Status

Everything is implemented. Note, that the random.org service API is at beta stage of development, however the library will try to be up-to-date.

The documentation

The documentation which may help you using this library.

Implementation

• Immutable interface, no need to synchronize, thread-safe (Sync and Send).
• No unsafe blocks.
• reqwest crate is used for performing requests.
• chrono for dates.
• serde for serialization and deserialization.

Features

• rand feature which provides the rand_core::RngCore trait implementation for the Random struct and adds new FallibleRandom<T: rand_core::RngCore> structure for better random generation UX.

Usage

Start by creating Random instance and perform needed operations after.

extern crate randomorg;

fn main() {
    use randomorg::Random;
    let r = Random::new("API KEY HERE");
    // A method-call way:
    println!("Result: {:?}", r.generate_integers(-100, 100, 15, true));
    // A lazy request builder way:
    let random_data = r.request_integers().min(0).max(100).limit(5).collect::<Vec<i32>>();
    println!("Random integers: {:?}", random_data);
}

With the rand feature you can also use it that way:

extern crate randomorg;

fn main() {
    use rand_core::RngCore;
    use randomorg::Random;
   
    let mut random = Random::new("API KEY HERE");
    let mut key = [0u8; 16];
    random.fill_bytes(&mut key);
    let random_u64 = random.next_u64();
}

License

This project is licensed under the MIT license.