Skip to main content

The adjspecies Python module generates random names formed from an animal and a descriptor.

Installation

$ pip install -U adjspecies

Usage

From the command line

$ adjspecies --help
usage: adjspecies.py [-h] [--maxlen MAXLEN] [--sep SEPARATOR] [--count COUNT]
                     [--prevent-stutter]

Print the name of a random adjective/species, more or less…

optional arguments:
  -h, --help         show this help message and exit
  --maxlen MAXLEN    Maximum length for the name, excluding any separator.
                     (default=8)
  --sep SEPARATOR    Separator between the adjective and species words.
                     (default='')
  --count COUNT      Number of adjective/species combinations to print.
  --prevent-stutter  Prevent the same letter from appearing on an
                     adjective/species boundary. (default=True)

$ python adjspecies.py --count 4
sillyfox
redpig
pinkdoge
lynxpaw

In Python code

>>> import adjspecies
>>> help(adjspecies.random_adjspecies)
Help on function random_adjspecies in module adjspecies:

random_adjspecies(sep='', maxlen=8, prevent_stutter=True)
    Return a random adjective/species, separated by `sep`. The keyword
    arguments `maxlen` and `prevent_stutter` are the same as for
    `random_adjspecies_pair`, but note that the maximum length argument is
    not affected by the separator.

>>> adjspecies.random_adjspecies('.', 7)
'wolf.toy'

About

While writing a deployment system targetting DigitalOcean Droplets, the author found the largest bottleneck was finding names for the transient test servers.

The adjective/species contrivance comes from the furry culture in general and more directly from the site [adjective][species]. It provides a wide namespace of easy-to-remember randomness.

Everything up until the initial commit was an exercise in yak shaving and procrastinating getting out of bed.

Credits

The adjspecies module is written and maintained by Adam Wright, who plays a cheetah on Twitter under the guise of @chipikat, a Python developer called @pypikat and a human being named @hipikat.

Release files for adjspecies 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for adjspecies 0.1.3
File Size Uploaded
adjspecies-0.1.3.tar.gz 4.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for adjspecies 0.1.3
File Interpreter ABI Platform
adjspecies-0.1.3-py27-none-any.whl Python 2.7 none any Details

Total release size: 12.5 kB

Release files / adjspecies-0.1.3.tar.gz

Download URL adjspecies-0.1.3.tar.gz
Size 4.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a054f9119f3115aea31e3aa60f5fc99df1009fe55813be62c4e058b3f5d60d33
BLAKE2b-256 checksum
How to use checksums
42ac519ea9077a56b1c8ba4317d77e2c9e4c08e1cf1aa5e861773f6a41a38021
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / adjspecies-0.1.3-py27-none-any.whl

Download URL adjspecies-0.1.3-py27-none-any.whl
Size 8.5 kB
Tags Python 2.7
SHA-256 checksum
How to use checksums
8b0703b6c3112b8bb4b875c7e44abe4da702ac9ec8e7c761e6cf620d26ef10fc
BLAKE2b-256 checksum
How to use checksums
2913ace6de4629b102329832928d6ed83722e806ba98f39a739f6d9d94ba0f26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page