Skip to content

A generator library for concise, unambiguous and URL-safe UUIDs.

License

Notifications You must be signed in to change notification settings

trekjs/shortuuid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

shortuuid

shortuuid is a simple python library that generates concise, unambiguous, URL-safe UUIDs.
Based on and compatible with the Python library shortuuid.

Often, one needs to use non-sequential IDs in places where users will see them, but the IDs must be as concise and easy to use as possible. shortuuid solves this problem by generating uuids using uuid-1345 and then translating them to base57 using lowercase and uppercase letters and digits, and removing similar-looking characters such as l, 1, I, O and 0.

NPM version Build status Test coverage License Dependency status

Usage

const ShortUUID = require('shortuuid')

const su = new ShortUUID('23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz')

su.encode('6ca4f0f8-2508-4bac-b8f1-5d1e3da2247a')
// => 'cu8Eo9RyrUsV4MXEiDZpLM'

su.decode('cu8Eo9RyrUsV4MXEiDZpLM')
// => '6ca4f0f8-2508-4bac-b8f1-5d1e3da2247a'

su.uuid()
// => 'cu8Eo9RyrUsV4MXEiDZpLM'

su.uuid('example.com')
// => 'wpsWLdLt9nscn2jbTD3uxe'

su.uuid('http://example.com')
// => 'c8sh5y9hdSMS6zVnrvf53T'

su.random()
// => 'c8sh5y9hdSMS6zVnrvf53T'

su.random(10)
// => 'c8sh5y9hdS'

About

A generator library for concise, unambiguous and URL-safe UUIDs.

Resources

License

Stars

Watchers

Forks

Packages

No packages published