{"id":15009992,"url":"https://github.com/bbaovanc/namegenerator","last_synced_at":"2025-10-03T19:30:34.122Z","repository":{"id":114420895,"uuid":"127495061","full_name":"BBaoVanC/NameGenerator","owner":"BBaoVanC","description":"DEPRECATED! Moved to https://github.com/BBaoVanC/pynamegen","archived":true,"fork":false,"pushed_at":"2020-03-16T03:23:07.000Z","size":1041,"stargazers_count":0,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-20T22:11:36.904Z","etag":null,"topics":["bbaovanc","cli","module","name-generator","namegen","namegenerator","python","python-3","python-3-6","python-3-7","python-3-8","python-library","python-module","python-modules-installer","python3","python3-6","python36","python37","python38","robust"],"latest_commit_sha":null,"homepage":"","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.txt","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":"2018-03-31T03:22:07.000Z","updated_at":"2023-01-28T12:56:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"ffcfd8a0-d02e-49a8-8b1b-2397d5fdbe04","html_url":"https://github.com/BBaoVanC/NameGenerator","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2FNameGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2FNameGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2FNameGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BBaoVanC%2FNameGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BBaoVanC","download_url":"https://codeload.github.com/BBaoVanC/NameGenerator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235173198,"owners_count":18947455,"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","module","name-generator","namegen","namegenerator","python","python-3","python-3-6","python-3-7","python-3-8","python-library","python-module","python-modules-installer","python3","python3-6","python36","python37","python38","robust"],"created_at":"2024-09-24T19:29:24.556Z","updated_at":"2025-10-03T19:30:28.807Z","avatar_url":"https://github.com/BBaoVanC.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NameGenerator\n\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/6621a967fffe47069d53b19129b7be0c)](https://www.codacy.com/manual/BBaoVanC/NameGenerator?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=BBaoVanC/NameGenerator\u0026amp;utm_campaign=Badge_Grade)\n[![Travis CI](https://travis-ci.org/BBaoVanC/NameGenerator.svg?branch=master)](https://travis-ci.org/BBaoVanC/NameGenerator)\n[![CircleCI](https://circleci.com/gh/BBaoVanC/NameGenerator/tree/master.svg?style=svg)](https://circleci.com/gh/BBaoVanC/NameGenerator/tree/master)\n\n[![license](https://img.shields.io/github/license/BBaoVanC/NameGenerator.svg)](https://github.com/BBaoVanC/NameGenerator/blob/master/LICENSE.txt)\n[![Github All Releases](https://img.shields.io/github/downloads/BBaoVanC/NameGenerator/total.svg)](https://github.com/BBaoVanC/NameGenerator)\n[![GitHub watchers](https://img.shields.io/github/watchers/BBaoVanC/NameGenerator.svg?label=Watch)](https://github.com/BBaoVanC/NameGenerator)\n[![GitHub stars](https://img.shields.io/github/stars/BBaoVanC/NameGenerator.svg?label=Stars)](https://github.com/BBaoVanC/NameGenerator)\n\n[![GitHub issues](https://img.shields.io/github/issues-raw/BBaoVanC/NameGenerator.svg)](https://github.com/BBaoVanC/NameGenerator/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen)\n[![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/BBaoVanC/NameGenerator.svg)](https://github.com/BBaoVanC/NameGenerator/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aclosed)\n\nRobust name generator that generates awesome names!\n\n## Features\n\n* Easy to use\n* CLI with simple arguments\n* `libnamegen` can be imported as a module\n* `libprogress` can be imported as a module\n* CLI can be run with default settings by double-clicking\n* Two generation methods to choose from\n* Always tested before release\n* Uses Python 3\n* Supports latest 3 versions of Python\n\n---\n\n## How to Download\n\nTo download the latest stable version of NameGenerator, click the button labeled `Releases` above the file explorer.\n\n![Releases button](https://i.imgur.com/EWNIpBn.png)\n\nThen, under the release labeled `Latest release`, click the button labeled `Source Code (zip)` under `Assets`. Then extract the downloaded zip archive.\n\n![Download button](https://i.imgur.com/PPqLAQu.png)\n\n---\n\n## FAQ\n\n**I get an error when I run namegen.py or use the CLI.**\n\nIf you get this error (or similar):\n\n``` python\n  File \"namegen.py\", line 87\n    print(\"Preparing list to write to file\", end=\"\\r\")  # log message\n                                                ^\nSyntaxError: invalid syntax\n```\n\nCheck your Python version. NameGenerator doesn't work on Python 2. It's also only *tested* on the latest 3 versions of Python 3. There is no guarantee that NameGenerator will work on earlier versions.\n\n---\n\n## Documentation\n\n### Command-Line Interface\n\nTo use the command-line interface, you must have namegen.py and the `libnamegen` folder. If you will only use specific generators, you don't need to download the other unused ones.\n\nPlease note that this program is written for Python 3.\n\nIf you use Windows, use the command `py` instead of `python`. If you have both Python 2 and Python 3 installed, use `py -3`.\n\nIf you use Mac/Linux, and have both Python 2 and Python 3 installed, then use the command `python3`.\n\nUse defaults (100 names, debug enabled, classic method, write names to names.txt):\n\n``` plaintext\n$ python namegen.py\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$ python namegen.py [--help | -h | help]\nUsage:\n    python namegen.py [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    python namegen.py amt=50 debug=True file=mynames.txt method=classic\n```\n\nGenerate 250 names:\n\n``` plaintext\n$ python namegen.py 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$ python namegen.py debug=False\n(no output)\n```\n\nGenerate names and place in file usernames.txt:\n\n``` plaintext\n$ python namegen.py 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$ python namegen.py 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$ python namegen.py 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\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$ python namegen.py 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\nDouble-clicking namegen.py will generate using default options.\n\n---\n\n### API\n\nTo use the API, you only need the `libnamegen` folder.\n\nGenerate one classic name without debug:\n\n``` python\nfrom libnamegen import classic\n\n# this uses the defaults which are one name, debug disabled, and classic generator\nprint(classic.gen())\n```\n\nGenerate seven classic names with debug:\n\n``` python\nfrom libnamegen import classic\n\nprint(classic.gen(count=7, debug=True))\n# print(classic.gen(7, True))  # also valid\n```\n\nPrompt the user for the amount of names, enable debug, and generate classic names:\n\n``` python\nfrom libnamegen import classic\n\namt = input(\"Amount of names to generate \u003e\u003e \")\ncount = int(amt)\n\nnames = classic.gen(count, true)\nfor name in names:\n  print(name)\n```\n\nGenerate one random name without debug:\n\n``` python\nfrom libnamegen import random\n\nprint(random.gen())\n```\n\nGenerate one name using the random method 15 characters long:\n\n``` python\nfrom libnamegen import random\n\nprint(random.gen(length=15))\n```\n\n---\n\n### Progress Bar API\n\nTo use the progress bar API, you only need the libprogress folder.\n\nThe following is an example that utilizes a progress bar with default length.\n\n``` python\nimport libprogress\n\nfor i in range(20):\n    do(something)\n    print(libprogress.genbar(curprg=i+1, maxprg=20), end=\"\\r\")\nprint(libprogress.genfullbar(prg=20))\n```\n\nFinal output:\n\n``` plaintext\n[####################] 100% [100/100]...done\n```\n\nIf you don't put `end=\"\\r\"`, then each progress bar won't overwrite the last. The output will look like the following:\n\n``` plaintext\n[#-------------------] 5% [1/20]\n[##------------------] 10% [2/20]\n[###-----------------] 15% [3/20]\n[####----------------] 20% [4/20]\n[#####---------------] 25% [5/20]\n[######--------------] 30% [6/20]\n[#######-------------] 35% [7/20]\n[########------------] 40% [8/20]\n[#########-----------] 45% [9/20]\n[##########----------] 50% [10/20]\n[###########---------] 55% [11/20]\n[############--------] 60% [12/20]\n[#############-------] 65% [13/20]\n[##############------] 70% [14/20]\n[###############-----] 75% [15/20]\n[################----] 80% [16/20]\n[#################---] 85% [17/20]\n[##################--] 90% [18/20]\n[###################-] 95% [19/20]\n[####################] 100% [20/20]\n[####################] 100% [20/20]...done\n```\n\n---\n\n## License\n\n_NameGenerator_ is licensed under the GPLv3 license. For more information, please refer to [`LICENSE.txt`](https://github.com/BBaoVanC/NameGenerator/blob/master/LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbaovanc%2Fnamegenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbaovanc%2Fnamegenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbaovanc%2Fnamegenerator/lists"}