{"id":15009361,"url":"https://github.com/bbaovanc/pynamegen","last_synced_at":"2026-03-11T19:12:17.741Z","repository":{"id":114420949,"uuid":"247599505","full_name":"BBaoVanC/pynamegen","owner":"BBaoVanC","description":"PyNameGen CLI for libnamegen (PyPI ready)","archived":false,"fork":false,"pushed_at":"2022-01-13T16:19:49.000Z","size":3473,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-19T07:42:12.499Z","etag":null,"topics":["bbaovanc","cli","name-generation","namegenerator","pip","pip3","pynamegen-cli","pypi","pypi-package","pypi-source","python","python-3","python-3-6","python-3-7","python-3-8","python3","python36","python37","python38"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/pynamegen/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BBaoVanC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-16T03:10:35.000Z","updated_at":"2022-01-13T16:19:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"025d2ef0-32a5-429e-8e2e-40e6b615ac19","html_url":"https://github.com/BBaoVanC/pynamegen","commit_stats":{"total_commits":31,"total_committers":5,"mean_commits":6.2,"dds":0.5483870967741935,"last_synced_commit":"d19e7db2ece77e1609219bad84223192afa574dd"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2Fpynamegen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2Fpynamegen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2Fpynamegen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2Fpynamegen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BBaoVanC","download_url":"https://codeload.github.com/BBaoVanC/pynamegen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243233967,"owners_count":20258368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bbaovanc","cli","name-generation","namegenerator","pip","pip3","pynamegen-cli","pypi","pypi-package","pypi-source","python","python-3","python-3-6","python-3-7","python-3-8","python3","python36","python37","python38"],"created_at":"2024-09-24T19:24:45.116Z","updated_at":"2025-12-11T19:25:18.418Z","avatar_url":"https://github.com/BBaoVanC.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyNameGen\n\n[![Build Status](https://drone.bbaovanc.com/api/badges/bbaovanc/pynamegen/status.svg)](https://drone.bbaovanc.com/bbaovanc/pynamegen)\n\n![PyPI](https://img.shields.io/pypi/v/pynamegen)\n![PyPI - License](https://img.shields.io/pypi/l/pynamegen)\n\nRobust CLI for [libnamegen](https://pypi.org/project/libnamegen/). Originally on my [NameGenerator](https://github.com/BBaoVanC/NameGenerator) project.\n\n## Features\n\n* Easy to use\n* CLI with simple arguments\n* Always tested before release\n* Officially supports latest two versions of Python 3\n\n---\n\n## How to Install\n\nRun the command `pip install pynamegen`. If you want to specify a specific Python version to use for pip, use a command such as `pip3` or `pip3.8`.\n\nPyNameGen requires the packages [libnamegen](https://pypi.org/project/libnamegen/) and [libprogress](https://pypi.org/project/libprogress/), but those will automatically be installed by pip.\n\n---\n\n## FAQ\n\n**What versions of Python are compatible?**\n\nPyNameGen is built for Python 3. It is tested on the latest two versions on Python 3 via Drone CI.\n\n---\n\n## Documentation\n\n### Command-Line Interface\n\nUse defaults (100 names, debug enabled, classic method, write names to names.txt):\n\n``` plaintext\n$ pynamegen\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\nShow help menu (use any of the three options in brackets):\n\n``` plaintext\n$ pynamegen [--help | -h | help]\nUsage:\n    pynamegen [options]\nOptions:\n    amt: Amount of names to generate\n    debug: Whether or not to output debug information\n    method: Which name generation method to use\nExample:\n    pynamegen amt=50 debug=True file=mynames.txt method=classic\n```\n\nGenerate 250 names:\n\n``` plaintext\n$ pynamegen amt=250\nGenerating names...\n[####################] 100% [250/250]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [250/250]...done\nSaving file...\nFinished!\n```\n\nGenerate default amount of names with debug disabled:\n\n``` plaintext\n$ pynamegen debug=False\n(no output)\n```\n\nGenerate names and place in file usernames.txt:\n\n``` plaintext\n$ pynamegen file=usernames.txt\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\nGenerate names and place in file users.txt inside the directory \"example-names\" **(Directory must already exist!)**\n\n``` plaintext\n$ pynamegen file=example-names/users.txt\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\nGenerate 50 names with debug enabled and place in namelist.txt:\n\n``` plaintext\n$ pynamegen amt=50 debug=True file=namelist.txt\nGenerating names...\n[####################] 100% [50/50]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [50/50]...done\nSaving file...\nFinished!\n```\n\nYou can also generates the names to terminal output by setting the filename to `stdout`. If you do so, make sure to set debug to False! This makes it easy to use the CLI as a way to send generated names to a program without using the Python API.\n\nGenerate 5 names with the random method and output to terminal:\n\n``` plaintext\n$ pynamegen amt=5 method=random debug=False file=stdout\nKc3HcV3pq_n0\nncwUV_Twbx7s\njYs56B1y_WxU\nYN5_cU6fhwXc\nSI46Rnp9skAo\n```\n\nThe output for the above command will differ because the generated names will not be the same as in this example.\n\nThe following example generates a name with the classic method and pipes it to the `cowsay` command (which just outputs text of a cow and a message box). You can pipe the generated name to any command; this is just an example.\n\n``` plaintext\n$ pynamegen amt=1 method=classic debug=False file=stdout | cowsay\n _______________________\n\u003c TheCauliflowerguy_408 \u003e\n -----------------------\n        \\   ^__^\n         \\  (oo)\\_______\n            (__)\\       )\\/\\\n                ||----w |\n                ||     ||\n```\n\nThe default name generation method is `classic`, and looks like 'TheAssignmentanatorifier_90'.\n\nThe generation method `random` looks like 'XaYyaknkCoH8'.\n\nYou can change the generation method used by using the argument 'method=[method]' and replace [method] with the correct method.\n\n``` plaintext\n$ pynamegen method=random\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\nIf you choose `surprise` as the generation method, a generation method will be randomly selected.\n\n``` plaintext\n$ pynamegen method=surprise\nRandomly selected method: classic\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\n``` plaintext\n$ pynamegen method=surprise\nRandomly selected method: random\nGenerating names...\n[####################] 100% [100/100]...done\nPreparing list to write to file...done\nOpening file...\nWriting names...\n[####################] 100% [100/100]...done\nSaving file...\nFinished!\n```\n\n---\n\n## License\n\n_PyNameGen_ is licensed under the GPLv3 license. For more information, please refer to [`LICENSE`](https://git.bbaovanc.com/bbaovanc/pynamegen/src/branch/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbaovanc%2Fpynamegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbaovanc%2Fpynamegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbaovanc%2Fpynamegen/lists"}