atrox / haikunatorpy

Generate Heroku-like random names to use in your python applications

HaikunatorPY

Generate Heroku-like random names to use in your python applications.

Installation

pip install haikunator

Usage

Haikunator is pretty simple. There is nothing to configure and it only has a single method, haikunate:

from haikunator import Haikunator

haikunator = Haikunator()
# haikunator = Haikunator(seed='random seed') # optional seed

# default usage
haikunator.haikunate() # => "wispy-dust-1337"

# custom length (default=4)
haikunator.haikunate(token_length=6) # => "patient-king-887265"

# use hex instead of numbers
haikunator.haikunate(token_hex=True) # => "purple-breeze-98e1"

# use custom chars instead of numbers/hex
haikunator.haikunate(token_chars='HAIKUNATE') # => "summer-atom-IHEA"

# don't include a token
haikunator.haikunate(token_length=0) # => "cold-wildflower"

# use a different delimiter
haikunator.haikunate(delimiter='.') # => "restless.sea.7976"

# no token, space delimiter
haikunator.haikunate(token_length=0, delimiter=' ') # => "delicate haze"

# no token, empty delimiter
haikunator.haikunate(token_length=0, delimiter='') # => "billowingleaf"

Options

The following options are available:

from haikunator import Haikunator

haikunator = Haikunator(
    adjectives=['custom', 'adjectives'],
    nouns=['custom', 'nouns'],
    seed='random seed'
)

haikunator.haikunate(
  delimiter='-',
  token_length=4,
  token_hex=False,
  token_chars='0123456789'
)

If token_hex is true, any tokens specified in token_chars are ignored

Contributing

Everyone is encouraged to help improve this project. Here are a few ways you can help:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features

Other Languages

Haikunator is also available in other languages. Check them out:

• Node: https://github.com/Atrox/haikunatorjs
• PHP: https://github.com/Atrox/haikunatorphp
• .NET: https://github.com/Atrox/haikunator.net
• Java: https://github.com/Atrox/haikunatorjava
• Go: https://github.com/Atrox/haikunatorgo
• Perl: https://github.com/Atrox/haikunatorperl
• Dart: https://github.com/Atrox/haikunatordart
• Ruby: https://github.com/usmanbashir/haikunator

haikunatorpy's Issues

missing positional argument after upgrade to Python 3.6

from haikunator import Haikunator
Haikunator.haikunate()
TypeError: haikunate() missing 1 required positional argument: 'self'

getting following build error

Running setup.py egg_info for package haikunator
           Traceback (most recent call last):
             File "<string>", line 16, in <module>
             File "/usr/share/build/haikunator/setup.py", line 2, in <module>
               import haikunator
             File "haikunator/__init__.py", line 2, in <module>
               from six.moves import range
           ImportError: No module named six.moves
           Complete output from command python setup.py egg_info:
           Traceback (most recent call last):

         File "<string>", line 16, in <module>

         File "/usr/share/build/haikunator/setup.py", line 2, in <module>

           import haikunator

         File "haikunator/__init__.py", line 2, in <module>

           from six.moves import range

       ImportError: No module named six.moves