coolname 0.1.1

Features

• Generate slugs, ready to use, Django-compatible.

  >>> from coolname import generate_slug
  >>> generate_slug()
  'qualified-agama-of-absolute-kindness'
  

• Generate names as sequences and do whatever you want with them.

  >>> from coolname import generate
  >>> generate()
  ['beneficial', 'bronze', 'bee', 'of', 'glee']
  >>> ' '.join(generate())
  'limber transparent toad of luck'
  >>> ''.join(x.capitalize() for x in generate())
  'CalmRefreshingTerrierOfAttraction'
  

• Generate names of specific length: 2, 3 or 4 words.

  >>> generate_slug(2)
  'mottled-crab'
  >>> generate_slug(3)
  'fantastic-acoustic-whale'
  >>> generate_slug(4)
  'military-diamond-tuatara-of-endeavor'
  

  Note: without argument, it returns a random length, but probability of 4-word name is much higher.

• Over 10¹⁰ random names.

  Words	Combinations	Example
  4	1010	talented-enigmatic-bee-of-hurricane
  3	108	ambitious-turaco-of-joviality
  2	105	prudent-armadillo

  >>> from coolname import get_combinations_count
  >>> get_combinations_count(4)
  43090340472
  

• Hand-picked vocabulary. sexy and demonic are about the most “offensive” words here - but there is only a pinch of them, for spice. Most words are either neutral, such as red, or positive, such as brave. And subject is always some animal, bird, fish, or insect - you can’t be more neutral than Mother Nature.

• Easy customization. Create your own rules!

  >>> from coolname import RandomNameGenerator
  >>> generator = RandomNameGenerator({
  ...   'all': {
  ...     'type': 'cartesian',
  ...     'lists': ['first_name', 'last_name']
  ...   },
  ...   'first_name': {
  ...     'type': 'words',
  ...     'words': ['james', 'john']
  ...   },
  ...   'last_name': {
  ...     'type': 'words',
  ...     'words': ['smith', 'brown']
  ...   }
  ... })
  >>> generator.generate_slug()
  'james-brown'
  

Alternatives

For random human names, addresses and more, check out Faker (or Gimei if you want Japanese data).

Customization

To use custom words and rules, create an instance of coolname.RandomNameGenerator and call its methods.

generator = RandomNameGenerator(config)
generator.generate()
generator.generate_slug()
generator.randomize()  # re-seeding, similar to random.seed

You can create configuration in Python code - it’s just a dictionary - or you can define it as a set of files (more convenient for larger configs).

• From a single json file

  from coolname.loader import load_config
  config = load_config('config.json')

• From a directory

  from coolname.loader import load_config
  config = load_config('config_dir')

Directory must contain config.json file, with the same structure as config dict, except that you may omit "type": "words" rules. For such rules, add plain *.txt files - they will be automatically added to the resulting config by load_config.

{
    '<rule_id>': {
        'comment': 'Some info about this rule. Not mandatory.',
        'type': '<nested|cartesian|words|const>',
        # additional fields, depending on type
    },
    ...
}

>>> from coolname import RandomNameGenerator
>>> generator = RandomNameGenerator(config)
>>> for i in range(3):
...     print(generator.generate_slug())
...
my-banana-is-sweet
my-apple-is-green
my-apple-is-sour

History

0.1.1 (2015-12-17)

• Consistent behavior in Python 2/3: output is always unicode.

• Provide from coolname.loader import load_config as a public API for loading custom configuration.

• More strict configuration validation.

• Total number of combinations increased from 33 to 43 billions.

0.1.0 (2015-11-03)

• First release on PyPI.