Skip to content
/ gubbins Public
forked from ArgosyLabs/gubbins

Gubbins serial number generator & validator

License

Notifications You must be signed in to change notification settings

pallas/gubbins

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gubbins

Product serial number generator/validator

A simple but powerful product serial number generator and validator written in Python. Given a Prefix and a 32-bit ID, produces a Serial. Given a valid Serial, returns the Prefix and 32-bit ID. Optionally takes Additional Data.

from gubbins import Gubbins

for i in range(10):
	serial = Gubbins.generate("AX", i)
	prefix, id = Gubbins.validate(serial)
	assert prefix.lower() == "AX".lower()
	assert id == i
	print(i, serial)

or via the command-line,

gubbins 1-10 --solo --prefix AX | ungubbins

Gubbins has several interesting features. A Gubbins Serial

  • is human-friendly,
  • ignores case,
  • fixes up typos,
  • can be reversed,
  • contains a checksum,
  • avoids collisions, &
  • attempts to prevent enumeration.

Modifying any of Prefix, ID, or Additional Data results in a different Serial.

Gubbins uses a lightly modified z-base-32 alphabet, with the letters AJNRTUV canonically upper-case and all other letters lower-case. The validator will automatically fix up typos related to oO0, iIlL1, & zZ2.

For best results,

  • a Prefix can not contain the characters -oOiIlLzZ,
  • IDs should not be sequential, &
  • Additional Data may depend on the Prefix but must not be derived from it.

Note: we make no security claims about Gubbins. YMMV

Requires

License: MIT

About

Gubbins serial number generator & validator

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%