A random generator of codes, names and other words
Project description
Sargon: Random Code Generator
sargon
is a simple Python package (no external dependencies) to generate random (mnemonic) codes simulating Youtube or Heroku style. It's extensible to define your own rules too.
Basic usage
Heroku
heroku(code_length=4)
Heroku codes have the form ADJECTIVE-NOUN-CODE
:
Example:
>>> from sargon import heroku
>>> heroku()
"valuable-period-6016"
>>> heroku(6)
"sweet-hat-673004"
YouTube
youtube(length=11, avoid_confusing_chars=False, blacklist_symbols=None)
Example:
>>> from sargon import youtube
>>> youtube()
"dQw4w9WgXcQ"
>>> youtube(6)
"LNb-P0"
>>> youtube(6, blacklist_symbols='-')
"LNbP0X"
6 Digit Generator
six_digit()
>>> from sargon import six_digit
>>> six_digit()
"770584"
Defining your own generators
Checkout engines.py
for the list of available engines and the parameters they receive. Here's an example:
>>> from sargon import engines, build_generator
>>> generator = build_generator(
engines.CityWordEngine(country='United States'),
engines.NumberEngine(4))
>>> generator.generate()
"bellview-5269"
Why sargon
?
I wanted to call the package Hammurabi, as the babylonian king that issued the Code of Hammurabi, but there's another package named hammurabi
, so I went with another great ruler that I like to read about: Sargon the great the emperor of the Akkadian empire, what is thought today to be the first empire in history.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.