10 releases

0.3.5 Mar 11, 2024
0.3.4 Mar 10, 2024
0.2.2 Mar 9, 2024
0.1.0 Mar 7, 2024

#418 in Algorithms

Download history 330/week @ 2024-03-03 421/week @ 2024-03-10 175/week @ 2024-03-17 1/week @ 2024-03-24 28/week @ 2024-03-31 99/week @ 2024-04-07 53/week @ 2024-04-14 21/week @ 2024-04-21 44/week @ 2024-04-28 34/week @ 2024-05-05 57/week @ 2024-05-12 84/week @ 2024-05-19 54/week @ 2024-05-26 59/week @ 2024-06-02 58/week @ 2024-06-09

261 downloads per month
Used in configer

Apache-2.0

33KB
381 lines

snowflake

A Twitter snowflake algorithm simply implemented in Rust.

Twitter Snowflake

APIs Documents

1.Usage

Add this to your Cargo.toml:

[dependencies]
snowflaker = "0.3"

# Or
# @see SnowflakeGenerator::dynamic()
snowflaker = { version = "0.3", features = ["dynamic"] }

2.APIs

2.1.Generator

2.1.1.builtin

// use the default data-center ID and worker ID
let gen = SnowflakeGenerator::builtin();
assert!(gen.is_ok());

2.1.2.new

let gen = SnowflakeGenerator::new(31, 31);
assert!(gen.is_ok());

let gen = SnowflakeGenerator::new(32, 32);
assert!(gen.is_err());

2.1.3.dynamic

  • @since 0.2.0
[dependencies]
snowflaker = { version = "${version}", features = ["dynamic"] }
let gen = SnowflakeGenerator::dynamic();
assert!(gen.is_ok());

let rvt = gen.unwrap().next_id();
assert!(rvt.is_ok());

2.2.Functions

2.2.1.next_id

// 122235238222008321
let rvt = snowflaker::next_id();
assert!(rvt.is_ok());

2.2.2.next_id_string

// 122256588529602560
let rvt = snowflaker::next_id_string();
assert!(rvt.is_ok());

2.3.Macros

  • @since 0.3.0

2.3.1.snowflake_builtin

let rvt = snowflake_builtin!();
assert!(rvt.is_ok());

2.3.2.snowflake_builtin_string

let rvt = snowflake_builtin_string!();
assert!(rvt.is_ok());

2.3.3.snowflake_dynamic

let rvt = snowflake_dynamic!();
assert!(rvt.is_ok());

2.3.4.snowflake_dynamic_string

let rvt = snowflake_dynamic_string!();
assert!(rvt.is_ok());

2.4.Custom

  • data-center ID
  • worker ID
let center_id = 16;
let worker_id = 16;

let gen = SnowflakeGenerator::new(center_id, worker_id);
assert!(gen.is_ok());
let rvt = gen.unwrap().next_id();
assert!(rvt.is_ok());

3.Test

3.1.cargo test

$ cargo test --features "dynamic" -- --show-output
$ cargo test --features "dynamic"

4.Docs

4.1.features

$ cargo doc --open --features dynamic

Dependencies

~3.5–5.5MB
~104K SLoC