Skip to content
Go package to generate guid (globally unique id) with good properties
Branch: master
Clone or download
Latest commit c442874 Jun 21, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Feb 12, 2015
README.md update readme Jun 21, 2017
betterguid.go re-generate random part on each New() Jun 15, 2017
betterguid_test.go check ids are in increasing order Feb 13, 2015
doc.go more doc Feb 12, 2015

README.md

This is Go package to generate guid (globally unique id) with good properties.

Usage:

import "github.com/kjk/betterguid"

id := betterguid.New()
fmt.Printf("guid: '%s'\n", id)

Generated guids have good properties:

  • they're 20 character strings, safe for inclusion in urls (don't require escaping)
  • they're based on timestamp; they sort after any existing ids
  • they contain 72-bits of random data after the timestamp so that IDs won't collide with other IDs
  • they sort lexicographically (the timestamp is converted to a string that will sort correctly)
  • they're monotonically increasing. Even if you generate more than one in the same timestamp, the latter ones will sort after the former ones. We do this by using the previous random bits but "incrementing" them by 1 (only in the case of a timestamp collision).

Read https://www.firebase.com/blog/2015-02-11-firebase-unique-identifiers.html for more info.

Based on https://gist.github.com/mikelehen/3596a30bd69384624c11

You can read Generating good, random and unique ids in Go to see how it compares to other similar libraries.

You can’t perform that action at this time.