On GitHub, rs/xid has picked up 4.3k stars, Go. xid is a globally unique id generator thought for the web
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Package xid is a globally unique id generator library, ready to safely be used directly in your server code.
Xid uses the Mongo Object ID algorithm to generate globally unique ids with a different serialization (base32hex) to make it shorter when transported as a string:
https://docs.mongodb.org/manual/reference/object-id/
4-byte value representing the seconds since the Unix epoch,
3-byte machine identifier,
2-byte process id, and
3-byte counter, starting with a random value.
The binary representation of the id is compatible with Mongo 12 bytes Object IDs.
The string representation is using base32hex (w/o padding) for better space efficiency
when stored in that form (20 bytes). The hex variant of base32 is used to retain the
sortable property of the id.
Xid doesn't use base64 because case sensitivity and the 2 non alphanum chars may be an
issue when transported as a string between various systems. Base36 wasn't retained either
because 1/ it's not standard 2/ the resulting size is not predictable (not bit aligned)
and 3/ it would not remain sortable. To validate a base32 xid, expect a 20 chars long,
all lowercase sequence of a to v letters and 0 to 9 numbers ([0-9a-v]{20}).
UUIDs are 16 bytes (128 bits) and 36 chars as string representation. Twitter Snowflake
ids are 8 bytes (64 bits) but require machine/data-center configuration and/or central
generator servers. xid stands in between with 12 bytes (96 bits) and a more compact
URL-safe string representation (20 chars). No configuration or central generator server
is required so it can be used directly in server's code.
Name
Binary Size
String Size
Features
UUID
16 bytes
36 chars
configuration free, not sortable
shortuuid
16 bytes
22 chars
configuration free, not sortable
Snowflake
8 bytes
up to 20 chars
needs machine/DC configuration, needs central server, sortable
MongoID
12 bytes
24 chars
configuration free, sortable
xid
12 bytes
20 chars
configuration free, sortable
Features:
Size: 12 bytes (96 bits), smaller than UUID, larger than snowflake
Base32 hex encoded by default (20 chars when transported as printable string, still sortable)
Non configured, you don't need set a unique machine and/or data center id (configurable if needed)
K-ordered
Embedded time with 1 second precision
Unicity guaranteed for 16,777,216 (24 bits) unique ids per second and per host/process
Lock-free (i.e.: unlike UUIDv1 and v2)
Best used with zerolog's
RequestIDHandler.
Notes:
Xid is dependent on the system time, a monotonic counter and so is not cryptographically secure. If unpredictability of IDs is important, you should not use Xids. It is worth noting that most other UUID-like implementations are also not cryptographically secure. You should use libraries that rely on cryptographically secure sources (like /dev/urandom on unix, crypto/rand in golang), if you want a truly random ID generator.
MachineID can be set by the environmental variable XID_MACHINE_ID to allow fine tune control over the generation.
TopGit's last sync did not record any GitHub topics for rs/xid. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on rs/xid?
The most recent commit recorded on rs/xid was 2 months ago, based on the GitHub push timestamp. The repository has 219 forks — one of the better signals of community interest.
How many stars does rs/xid have?
rs/xid has 4.3k GitHub stars — refresh the page for the live number, or check github.com/rs/xid. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is rs/xid written in?
rs/xid is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about rs/xid?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/rs/xid is the definitive source.
Read full README in the tab above.
Want a second opinion on xid?
Ask an AI that can read this page — one click and you get its take on xid.