Skip to main content

Markov chain project name generator

Project description

Marko-Namo

PyPi Version Python Versions License

Code Hygiene codecov black codestyle

Documentation Status


Simple tool to generate random project or business names using a basic Markov Chain approach.

Installation

Install marko-namo from the Python Package Index:

$ pip install marko-namo

Requirements

  • Python 3.8+

How It Words

The generator starts by creating a frequency table based on the training words supplied and the n-grams listed. Eg if our training word is hello and our n-grams are 1 and 2, we'd get a frequency table of:

{
    "h": ["e", "el"],
    "he": ["l", "ll"],
    "e": ["l", "ll"],
    "el": ["l", "lo"],
    "l": ["l", "lo", "o", null],
    "ll": ["o", null],
    "lo": [null, null],
    "o": [null, null]
}

It then randomly selects an n-gram from the frequency table as the first letter, randomly selects a following letter and repeats until the word either ends (selects a None) or reaches the maximum word length.

Eg if the first selected letter was e we might go:

  • e -> l -> lo -> None
  • Which gives ello

How To Run

You can either create a config file and pass that in or specifiy your parameters in code. To get started, you can utilse the config_sample.yml.

from marko_namo import MarkoNamo

random_name_generator = MarkoNamo("config_sample.yml")
created_names, available_domains = random_name_generator.create_random_names()

If you'd rather not use a config file then you can run:

from marko_namo import MarkoNamo

random_name_generator = MarkoNamo(
    name_length = 5,
    number_of_names = 10,
    training_words = ["hello", "pineapple", "planet"]
)
created_names, available_domains = random_name_generator.create_random_names()

Parameters

Parameter Type Description
number_of_names Integer Number of names to attempt to create
maximum_name_length Integer Maximum name length. Note names can be up to length + largest n-gram in length
n_grams List of integers The word segment lengths to consider for learning and generating new words.
extensions List of strings Domain extensions to check for such as .com, .ai, etc
training_words List of strings Words to learn from and used to generate new, random, words. There's no limit to the number of words to learn from but too many will slow the program down significantly.

Domain Name Lookup

If you'd like to check if the domain name (eg www.randomname.com) is available for the generated names then you'll also need a GoDaddy API key. This can be generated at the following: https://developer.godaddy.com/keys

You'll need to provide:

  • API Key
  • API Secret
  • Whether you'd like to use their OTE (test) or PROD (production) environment

Building the Project

This package uses poetry and nox for package management and building.

If nox is not already installed, install it:

$ pip install nox
$ pip install nox_poetry

Run everything including tests and documentation building

$ nox

# Or to run a specific stage:
$ nox -s <stage name>, eg
$ nox -s tests

Testing

Nox also handles the tests but you'll require OTE & PROD keys to run the GoDaddy tests.

  1. Register with GoDaddy and generate OTE & PROD keys
  2. Set them as environment variables:
# GoDaddy OTE
GODADDY_OTE_KEY=<OTE Key>
GODADDY_OTE_SECRET=<OTE Secret>
GODADDY_OTE_ENV=OTE

# GoDaddy Prod
GODADDY_PROD_KEY=<Prod Key>
GODADDY_PROD_SECRET=<Prod Secret>
GODADDY_PROD_ENV=PROD
  1. Run the tests:
$ nox -s tests

Issues

If you encounter any problems, please file an issue along with a detailed description.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marko-namo-0.2.1.tar.gz (6.9 kB view hashes)

Uploaded Source

Built Distribution

marko_namo-0.2.1-py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page