Build status Bitbucket issues

ids_service

Library that allows generating unique ids. It tried to keep cache filled using background threads to fill it. If the cache is empty (the number of requests is too high) an id is calculated on the fly. This will slow down obtaining the id but there is no error when the cache is empty. To generate unique ids the library uses an array of bytes with values from a random number generator and a timestamp as nanoseconds since January 1, 1970 UTC and finally create a hash from both data. The size of random block is equal to the size of hash sha512 = 64 bytes.

So the size of data block to calculate a unique id using sha512 equal 64 bytes random + 8 bytes timestamp.

The hash algorithm can be one from crypto::sha3::Sha3Mode

The id can be: * Vec u8 * String encoded hexadecimal lower case * String as Base64 * String as Base32

Quick Start

Use of cached service:

```rust extern crate ids_service;

use crate::idsservice::cryptohash::{Encode,IdsService};

fn main() {

/*
 * Create an ids service with:
 * Cache size = 10'000
 * hash algo. = sha512
 * A pool of 20 threads
 */
let mut ids = IdsService::default();
ids.start();
println!("Get an id: {}", ids.get_id().as_hex());
println!("Get another id: {}", ids.get_id().as_base64());
println!("Current numbers of items in cache: {}", ids.get_cache_len());

} ```

Use of helper function:

```rust extern crate ids_service;

use crate::idsservice::cryptohash::*;

fn main() {

println!("Create an id sha512 without the service: {}", create_id_as_sha512());
println!("Create an id sha256 without the service: {}", create_id_as_sha256());

} ```

Run example

bash cargo run --example examples bash cargo run --example iterator_example bash cargo run --example quickstart bash cargo run --example quickstart2; Create ten millions of ids (sha512) and read it all. Around 17 seconds to fill the cache 23 seconds with read bash cargo run --release --example ten_million

Links

Releases