Package: vasuki
VasukiAboutVasuki generates different kinds of random unique identifiers, tokens, and words.It can be used as a library and as an HTTP service, aiming to provide effortless
identifier generation for your applications.A public instance of the HTTP service is available athttps://api.hiveeyes.org/vasuki/.Synopsis# UUIDv4 universally unique identifier.
vasuki uuid

# ULID universally unique lexicographically sortable identifier.
vasuki ulid

# Gibberish random, pronounceable pseudo-words
vasuki gibberish

# MomentName short epoch slugs
vasuki moment

# Nagamani19 short, unique, non-sequential identifier.
vasuki naga19InstallPrerequisitespip install vasukiWith service API:pip install 'vasuki[service]'Please note this software is a work in progress, and its interfaces may change.
For those reasons, if you use it as a dependency in your own programs, version
pinning is always recommended.FeaturesUnique ID generatorsUUIDv4universally unique identifierULIDuniversally unique lexicographically sortable identifierGibberishrandom, pronounceable pseudo-wordsMomentName, a short epoch slugNagamani19, a short, unique, non-sequential identifier based onHashidsand a custom Epoch starting on January 1, 2019.Time and randomness is usually taking from the system
as implemented by the libraries underpinning this package.Slugifierssix-nibble-nameconverts six nibbles (three bytes) into a 4-character nameOptional service APIThe fineresponderlibrary optionally exposes the machinery as HTTP API.ExamplesIdentifier generation# UUIDv4
vasuki uuid
d192b464-d32c-48f1-9c23-0fe04a4e8133

# ULID
vasuki ulid
01DEFKXYCJ0E91DQY0YPWZY01D

# Gibberish
vasuki gibberish
shoomly

# MomentName
vasuki moment
Zese

# Nagamani19
vasuki naga19
Xm3k6mWqWith transformationsVasuki can apply uppercase or lowercase transformation to the
generated identifier or word:# UUIDv4, uppercase
vasuki uuid --upper
43FA0272-CA48-40AE-8CC1-204302D91D89

# ULID, lowercase
vasuki ulid --lower
01defkz01k47dqkvcyhy0mz06eWith variable word lengthvasuki gibberish --size medium
schreblyioppSlug toolsvasuki slug 42 --format=sixnibble
BacaMultiple tokens at oncevasuki naga19 --count 10
vasuki gibberish --size large --count 50HTTP APIStart the Vasuki service as daemon:vasuki serviceExample requests would look like:# UUIDv4
/unique/uuid

# Uppercase UUIDv4
/unique/uuid?upper=true

# Multiple ULIDs
/unique/ulid?count=10

# Very short Nagamani19
/unique/naga19?size=smallDevelopmentAcquire sources:git clone https://github.com/daq-tools/vasuki
cd vasukiInstall development sandbox:python3 -m venv .venv
source .venv/bin/activate
pip install --editable='.[service,develop,docs,test]'
vasuki --versionRun linter and software tests:poe checkDisclaimerThe algorithms and procedures curated here generate different kinds of random and
pseudo-random identifiers, tokens, names or passwords.While some generated tokens max out on the randomness and uniqueness
aspects like UUIDs, others compromise on the time vs. space domain but focus
more on human memorability and empathize with their common sense and humor.Saying that, it is important to understand their properties and features when using
those identifiers in different contexts. YMMV.For more in-depth information, enjoy readingUnderstanding UUIDs, ULIDs and String
Representationsand itscorresponding discussion.Warranty and LicensePlease refer to theLICENSEfile for further information and caveats about
warranty and licensing information.You are responsible for using this software responsibly, it comes without
warranty of any kind.CreditsAndrew Hawker forhttps://github.com/ahawker/ulidDavid Aurelio forhttps://github.com/davidaurelio/hashids-pythonGregory Haskins forhttps://github.com/greghaskins/gibberishOliver Robson forhttps://github.com/HowManyOliversAreThere/six-nibble-nameAll authors for all other fine pieces this software is made of.Mozilla forZilla SlabVasuki Logo fromhttps://en.wikipedia.org/wiki/VasukiEtymologyKurmais one of the avatars ofVishnu. He appears in the form of a tortoise
or turtle to support the foundation of the cosmos, while the gods and demons
churn the cosmic ocean with the help of serpentVasukito produce the nectar
of immortality.Vasuki is a naga serpent king, occasionally coiling around Kurma’s or Shiva’s
neck, who blessed and wore him as an ornament. He is described as having
a gem called Nagamani on his head.