Skip to content

iddm/randomorg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

random.org

Build status Crates Docs MIT licensed

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.

About

A random.org client library for Rust

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages