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 (
SyncandSend). - No unsafe blocks.
reqwestcrate is used for performing requests.chronofor dates.serdefor serialization and deserialization.
Features
randfeature which provides therand_core::RngCoretrait implementation for theRandomstruct and adds newFallibleRandom<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.
4 Sep 5, 2022
10 Sep 1, 2022
10 Jun 17, 2022
2 Oct 24, 2021
4 Feb 10, 2024
22 Dec 28, 2022
10 Feb 11, 2022
5 Jan 14, 2023
4 Nov 30, 2022
15 Feb 12, 2022
1 Dec 29, 2021
4 Aug 10, 2022
22 Mar 19, 2023
214 Dec 26, 2022
7 Oct 9, 2022
8 Dec 3, 2022
18 Feb 2, 2022
5 Nov 23, 2022
2 Aug 16, 2022