An open API service indexing awesome lists of open source software.

https://github.com/toshihikoyanase/mong

A Python port of the Moby name generator, which creates random but readable names like those used for Docker containers.
https://github.com/toshihikoyanase/mong

moby name-generation name-generator python

Last synced: about 1 year ago
JSON representation

A Python port of the Moby name generator, which creates random but readable names like those used for Docker containers.

Awesome Lists containing this project

README

          

# mong

[![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org)
[![pypi](https://img.shields.io/pypi/v/mong.svg)](https://pypi.python.org/pypi/mong)
![](https://github.com/toshihikoyanase/mong/workflows/test/badge.svg)
[![codecov](https://codecov.io/gh/toshihikoyanase/mong/branch/master/graph/badge.svg)](https://codecov.io/gh/toshihikoyanase/mong)

A Python port of [moby](https://github.com/moby/moby) name generator.
The original code in [moby](https://github.com/moby/moby) can be found [here](https://github.com/moby/moby/blob/master/pkg/namesgenerator/names-generator.go).

## Installation

Install mong via pip:

```console
pip install mong
```

## Usage

You can generate a random name with just two lines of code:

```python
import mong
print(mong.get_random_name())
```

Example usage:

```python
>>> import mong
>>> mong.get_random_name()
'goofy_robinson'
>>> mong.get_random_name()
'stoic_feynman'
```

Try mong in Google Colab:
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/16iw3njq06R32-0dHiRn2efUvvZmYHeRL)

## References

- [Moby Project](https://mobyproject.org/)
- [moby/moby@GitHub](https://github.com/moby/moby)

## License

This project is licensed under the MIT License (see [LICENSE](./LICENSE)).

Mong includes code from the [Moby](https://github.com/moby/moby) project (see [THIRD_PARTY_LICENSES](./THIRD_PARTY_LICENSES)).