How fangfengxiang/revid-engine works
RevIdEngine is an in-process Go library for generating distributed IDs through two strategies: segmented range allocation and a time-based Snowflake variant. A caller constructs a generator with the corresponding seed, then requests numeric IDs or encoded strings. Segmented generation fetches ranges through a provider; Snowflake resolves a node ID and epoch. Both support pre-allocation, post-allocation, and string-encoding middleware. The source excerpts establish these runtime relationships; README capabilities not visible in sampled code are not expanded into speculative components.
Main entry points: snowflake.go Snowflake generator · segmented.go Segmented generator · revid.go Generator contract
Components 10
Public API
- Generator contract
revid.go - Numeric ID
- Encoded ID
Generation Strategies
- Segmented generator
segmented.go - Snowflake generator
snowflake.go
Providers & Middleware
- Range provider
revid.go - Node resolver
revid.go - Epoch resolver
snowflake.go - Middleware options
revid.go
Other components
- Library caller
Connections 12
- Library caller → Generator contract: uses
README.md - Generator contract → Segmented generator: constructs via
segmented.go - Generator contract → Snowflake generator: constructs via
snowflake.go - Segmented generator → Range provider: fetches ranges
segmented.go - Snowflake generator → Node resolver: resolves node
snowflake.go - Snowflake generator → Epoch resolver: resolves epoch
snowflake.go - Segmented generator → Middleware options: runs hooks
segmented.go - Snowflake generator → Middleware options: runs hooks
snowflake.go - Segmented generator → Numeric ID: returns numeric ID
segmented.go - Snowflake generator → Numeric ID: returns numeric ID
snowflake.go - Segmented generator → Encoded ID: encodes ID
segmented.go - Snowflake generator → Encoded ID: encodes ID
snowflake.go