Crate randomorg[][src]

A random.org api bindings.

The randomness comes from atmospheric noise, which for many purposes is better than the pseudo-random number algorithms typically used in computer programs. To use the library you must have an api key which you may get from here.

Usage

extern crate randomorg;

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

Warning

However the library provides a thread-safe object, the random.org service does not allow to use their API from multithreaded-apps. The service processes incoming calls according the request_id parameter, it must be different for concurrent calls, while this library always provides request_id equal to 1. So when you use the library from multiple threads the library will send multiple requests simultaneously with the same request_id field and the random.org service will refuse to process them.

Modules

version

This module gives the build and version information about the library.

Structs

AllowedCharacters

Allowed characters

ApiKey

A random.org api key

ErrorCode

Random.org error code.

GetUsageResult

A random.org response of getUsage method.

Random

A random.org api client.

RandomData

A random.org's produced random data (from generateIntegers method)

RandomResult

A random.org response with random data.

Request

A random.org request holder

RequestBlobs

A lazy blobs request (builder)

RequestDecimalFractions

A lazy decimal fractions request (builder)

RequestGaussians

A lazy gaussians request (builder)

RequestId

An unique random.org request id

RequestIntegers

A lazy integers request (builder)

RequestStrings

A lazy strings request (builder)

RequestUUIDs

A lazy UUIDs request (builder)

Response

A random.org response holder

ResponseError

Random.org response error definition.

Enums

ApiKeyStatus

A random.org api key status

Error

Random.org API crate error type.

Type Definitions

GenerateBlobsResult

A random.org response of GenerateBlobs method.

GenerateDecimalFractionsResult

A random.org response of GenerateDecimalFractions method.

GenerateGaussiansResult

A random.org response of GenerateGaussians method.

GenerateIntegersResult

A random.org response of generateIntegers method.

GenerateStringsResult

A random.org response of GenerateStrings method.

GenerateUUIDsResult

A random.org response of GenerateUUIDs method.

Result

Random.org API Result alias type.