randomorg 0.2.0

A 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.
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
41
42
43
44
45
46

# random.org
[![Build status](https://travis-ci.org/vityafx/randomorg.svg?branch=master)](https://travis-ci.org/vityafx/randomorg)
[![Crates](https://img.shields.io/crates/v/randomorg.svg)](https://crates.io/crates/randomorg)
[![Docs](https://docs.rs/randomorg/badge.svg)](https://docs.rs/randomorg)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)


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](https://docs.rs/randomorg) 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

## Usage
Start by creating `Random` instance and perform needed operations after.

```rust,no_run
extern crate randomorg;

fn main() {
    use randomorg::Random;
    let r = Random::new("API KEY HERE").unwrap();
    // 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);
}
```

## License

This project is
[licensed under the MIT license](https://github.com/vityafx/randomorg/blob/master/LICENSE).