# IdGenerator
A powerful unique id generator.
Inspired by [yitter/IdGenerator](https://github.com/yitter/IdGenerator). Please see it for original documentation on the option choice.
Shorter ID and faster generation with a new snowflake drift algorithm. The core is to shorten the ID length, but also can have a very high instantaneous concurrent processing capacity (50W/0.1s), and powerful configuration capacity.
If you want to have such a high throughput, please set a higher `seq_bit_len` (e.g. 10).
Also support for multiple worker_id in one instance, using HashMap or Vector. **More usage examples please see tests in `lib.rs` or [docs on docs.rs](https://docs.rs/idgenerator)**
**DO NOT USE A MIXTURE OF THEM**!
## Simple Usage example
First, **global** initialize:
```rust
use idgenerator::{IdHelper, IdGeneratorOptions};
// Create a instance
IdHelper::init();
// Create IdGeneratorOptions, worker_id is the only parameter needed：
let mut options = IdGeneratorOptions::new(1);
// If you want to have a larger work_id range, set worker_id_bit_len to a larger number
options.worker_id_bit_len = 8; // default to 8, meaning the max number of work_id is 2^8 - 1
// Other options can be seen in IdGeneratorOptions
// You must save parameters before generating
IdHelper::set_id_generator(options);
```
Second, generate ID:
```rust
use idgenerator::IdHelper;
// call next_id() at where you want to generate the ID
let new_id: i64 = IdHelper::next_id();
println!("ID: {}", new_id);
```
More usage examples please see [docs on docs.rs](https://docs.rs/idgenerator) or `mod.rs`. Also can see the tests in `lib.rs`
## Credits
- [yitter/IdGenerator](https://github.com/yitter/IdGenerator)