# randword
The Python package for generating random English words
## Table of contents
- [Installation](#installation)
- [Usage](#usage)
- [Credits and references](#credits-and-references)
- [License](#license)
## Installation
You can install `randword` package using `pip` or `easy_install`:
```bash
pip install randword
```
```bash
easy_install randword
```
You can also just clone the repository and run:
```bash
python setup.py install
```
## Usage
See the [documentation](https://randword.readthedocs.io/en/stable/index.html).
## Credits and references
- A database of words for each part of the speech was taken from [WordNet](https://wordnet.princeton.edu/).
- Splitting words into different parts of speech is made possible by [Chilli's answer](https://stackoverflow.com/a/27415226/13692774) on [Stack Overflow](https://stackoverflow.com/).
- Surnames database was taken from this [GitHub repo](https://github.com/arineng/arincli/blob/master/lib/last-names.txt).
- Male and females names were taken from the [website of Carnegie Mellon University](https://www.cs.cmu.edu/afs/cs/project/ai-repository/ai/areas/nlp/corpora/names/).
- Countries database was taken from [this GitHub gist](https://gist.github.com/kalinchernev/486393efcca01623b18d).
- Cities database was taken from [this GitHub gist](https://gist.github.com/norcal82/4accc0d968444859b408).
- Magic 8-Ball answers were taken from [Wikipedia page](https://en.wikipedia.org/wiki/Magic_8-Ball).
## License
[randword](https://github.com/8nhuman8/randword) specific code is distributed under [MIT License](https://github.com/8nhuman8/randword/blob/master/LICENSE.txt).
Copyright (c) 2022 Artyom Bezmenov
Raw data
{
"_id": null,
"home_page": null,
"name": "randword",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "python, package, python-package, random, word, words, generator, generation, random-word, random-words, random-word-generator, random-word-generation, english, english-word, english-words",
"author": null,
"author_email": "\"Artyom Bezmenov (8nhuman)\" <artem.bezmenov02@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/fc/a0/fba05dc92daaf9404ac1d18b03b1ed9568ef98718bd8e4b758240da63ab9/randword-2.11.3.tar.gz",
"platform": null,
"description": "# randword\r\n\r\nThe Python package for generating random English words\r\n\r\n## Table of contents\r\n\r\n- [Installation](#installation)\r\n- [Usage](#usage)\r\n- [Credits and references](#credits-and-references)\r\n- [License](#license)\r\n\r\n## Installation\r\n\r\nYou can install `randword` package using `pip` or `easy_install`:\r\n\r\n```bash\r\npip install randword\r\n```\r\n\r\n```bash\r\neasy_install randword\r\n```\r\n\r\nYou can also just clone the repository and run:\r\n\r\n```bash\r\npython setup.py install\r\n```\r\n\r\n## Usage\r\n\r\nSee the [documentation](https://randword.readthedocs.io/en/stable/index.html).\r\n\r\n## Credits and references\r\n\r\n- A database of words for each part of the speech was taken from [WordNet](https://wordnet.princeton.edu/).\r\n- Splitting words into different parts of speech is made possible by [Chilli's answer](https://stackoverflow.com/a/27415226/13692774) on [Stack Overflow](https://stackoverflow.com/).\r\n- Surnames database was taken from this [GitHub repo](https://github.com/arineng/arincli/blob/master/lib/last-names.txt).\r\n- Male and females names were taken from the [website of Carnegie Mellon University](https://www.cs.cmu.edu/afs/cs/project/ai-repository/ai/areas/nlp/corpora/names/).\r\n- Countries database was taken from [this GitHub gist](https://gist.github.com/kalinchernev/486393efcca01623b18d).\r\n- Cities database was taken from [this GitHub gist](https://gist.github.com/norcal82/4accc0d968444859b408).\r\n- Magic 8-Ball answers were taken from [Wikipedia page](https://en.wikipedia.org/wiki/Magic_8-Ball).\r\n\r\n## License\r\n\r\n[randword](https://github.com/8nhuman8/randword) specific code is distributed under [MIT License](https://github.com/8nhuman8/randword/blob/master/LICENSE.txt).\r\n\r\nCopyright (c) 2022 Artyom Bezmenov\r\n",
"bugtrack_url": null,
"license": null,
"summary": "The Python package for generating random English words",
"version": "2.11.3",
"project_urls": {
"Bug Tracker": "https://github.com/8nhuman8/randword/issues",
"Documentation": "https://randword.readthedocs.io/en/stable/",
"Download": "https://github.com/8nhuman8/randword/archive/2.11.3.tar.gz",
"Homepage": "https://github.com/8nhuman8/randword",
"Source Code": "https://github.com/8nhuman8/randword"
},
"split_keywords": [
"python",
" package",
" python-package",
" random",
" word",
" words",
" generator",
" generation",
" random-word",
" random-words",
" random-word-generator",
" random-word-generation",
" english",
" english-word",
" english-words"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ef7044a5ca63b0e4d60ec68f736dce8e0a83614d2e6fc68bae6a2c9cf269e0b1",
"md5": "d86b7d1083cbf7a8ab1c18c1118ab2de",
"sha256": "54566f2b22d0ae59eb5599f2440d3b05569ddf4d75ab454b022919102313ff86"
},
"downloads": -1,
"filename": "randword-2.11.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d86b7d1083cbf7a8ab1c18c1118ab2de",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 643802,
"upload_time": "2025-08-12T09:07:48",
"upload_time_iso_8601": "2025-08-12T09:07:48.579453Z",
"url": "https://files.pythonhosted.org/packages/ef/70/44a5ca63b0e4d60ec68f736dce8e0a83614d2e6fc68bae6a2c9cf269e0b1/randword-2.11.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fca0fba05dc92daaf9404ac1d18b03b1ed9568ef98718bd8e4b758240da63ab9",
"md5": "358cd046f76a5b50d0ed1420cc54a103",
"sha256": "b8adae621b5dc36fa93c91cbc617ed38bdb78b1191661ac9d5babb87d13bcc11"
},
"downloads": -1,
"filename": "randword-2.11.3.tar.gz",
"has_sig": false,
"md5_digest": "358cd046f76a5b50d0ed1420cc54a103",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 642724,
"upload_time": "2025-08-12T09:07:50",
"upload_time_iso_8601": "2025-08-12T09:07:50.519109Z",
"url": "https://files.pythonhosted.org/packages/fc/a0/fba05dc92daaf9404ac1d18b03b1ed9568ef98718bd8e4b758240da63ab9/randword-2.11.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-12 09:07:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "8nhuman8",
"github_project": "randword",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "randword"
}
JSON
