# random-word
[](https://badge.fury.io/py/Random-Word)
[](https://pypi.org/project/random-word/)
[](https://pypi.org/project/random-word/)
[](https://pepy.tech/project/random-word)
[](https://vaibhavsingh97.mit-license.org/)
This is a simple python package to generate random English words.
If you need help after reading the below, please find me on Twitter at [@vaibhavsingh97](https://twitter.com/vaibhavsingh97).
If you love the package, please :star2: the repo.
## Installation
You should be able to install using `easy_install` or `pip` in the usual ways:
```sh
$ easy_install random-word
$ pip install random-word
```
Or clone this repository and run:
```sh
$ python3 setup.py install
```
Or place the `random-word` folder that you downloaded somewhere where your scripts can access it.
## Basic Usage
> 👋 This package will now, by default, fetch the random word from local [database](https://github.com/vaibhavsingh97/random-word/blob/master/random_word/database/words.json)
```python
from random_word import RandomWords
r = RandomWords()
# Return a single random word
r.get_random_word()
```
Different services are available as a part of the random word package, which fetches random words from various API providers. Please check the `Services` section for more details.
## Services
- [Wordnik][wordnikDocLink]
- [API Ninjas][apiNinjasDocLink]
## Development
Assuming that you have [`Python`](https://www.python.org/) and [`pipenv`](https://docs.pipenv.org) installed, set up your environment and install the required dependencies like this instead of the `pip install random-word` defined above:
```sh
$ git clone https://github.com/vaibhavsingh97/random-word.git
$ cd random-word
$ make init
```
Add API Key in `random_word` directory defining API Key in `config.yml`. If you don't have an API key, then request your API key [here][wornikWebsiteLink]
```sh
API_KEY = "<API KEY>"
```
To check your desired changes, you can install your package locally.
```sh
$ pip install -e .
```
## Issues
You can report the bugs at the [issue tracker](https://github.com/vaibhavsingh97/random-word/issues)
## License
Built with ♥ by Vaibhav Singh([@vaibhavsingh97](https://github.com/vaibhavsingh97)) under [MIT License](https://vaibhavsingh97.mit-license.org/)
You can find a copy of the License at <https://vaibhavsingh97.mit-license.org/>
[wordnikDocLink]:https://github.com/vaibhavsingh97/random-word/blob/master/docs/wordnik.md
[apiNinjasDocLink]:https://github.com/vaibhavsingh97/random-word/blob/master/docs/apininjas.md
Raw data
{
"_id": null,
"home_page": null,
"name": "random_word",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.8.0",
"maintainer_email": null,
"keywords": "package, random words, word of the day, random word generator",
"author": "Vaibhav Singh",
"author_email": "hi@vaibhavsingh97.com",
"download_url": "https://files.pythonhosted.org/packages/1f/64/5f2883c851c186f87cc01fc006a29869c35a952593e2c0f2be1a83a27351/random_word-1.0.13.tar.gz",
"platform": null,
"description": "# random-word\n\n\n[](https://badge.fury.io/py/Random-Word)\n[](https://pypi.org/project/random-word/)\n[](https://pypi.org/project/random-word/)\n[](https://pepy.tech/project/random-word)\n[](https://vaibhavsingh97.mit-license.org/)\n\nThis is a simple python package to generate random English words.\nIf you need help after reading the below, please find me on Twitter at [@vaibhavsingh97](https://twitter.com/vaibhavsingh97).\n\nIf you love the package, please :star2: the repo.\n\n## Installation\n\nYou should be able to install using `easy_install` or `pip` in the usual ways:\n\n```sh\n$ easy_install random-word\n$ pip install random-word\n```\n\nOr clone this repository and run:\n\n```sh\n$ python3 setup.py install\n```\n\nOr place the `random-word` folder that you downloaded somewhere where your scripts can access it.\n\n## Basic Usage\n\n> \ud83d\udc4b This package will now, by default, fetch the random word from local [database](https://github.com/vaibhavsingh97/random-word/blob/master/random_word/database/words.json)\n\n```python\nfrom random_word import RandomWords\nr = RandomWords()\n\n# Return a single random word\nr.get_random_word()\n```\n\nDifferent services are available as a part of the random word package, which fetches random words from various API providers. Please check the `Services` section for more details.\n\n## Services\n\n- [Wordnik][wordnikDocLink]\n- [API Ninjas][apiNinjasDocLink]\n\n## Development\n\nAssuming that you have [`Python`](https://www.python.org/) and [`pipenv`](https://docs.pipenv.org) installed, set up your environment and install the required dependencies like this instead of the `pip install random-word` defined above:\n\n```sh\n$ git clone https://github.com/vaibhavsingh97/random-word.git\n$ cd random-word\n$ make init\n```\n\nAdd API Key in `random_word` directory defining API Key in `config.yml`. If you don't have an API key, then request your API key [here][wornikWebsiteLink]\n\n```sh\nAPI_KEY = \"<API KEY>\"\n```\n\nTo check your desired changes, you can install your package locally.\n\n```sh\n$ pip install -e .\n```\n\n## Issues\n\nYou can report the bugs at the [issue tracker](https://github.com/vaibhavsingh97/random-word/issues)\n\n## License\n\nBuilt with \u2665 by Vaibhav Singh([@vaibhavsingh97](https://github.com/vaibhavsingh97)) under [MIT License](https://vaibhavsingh97.mit-license.org/)\n\nYou can find a copy of the License at <https://vaibhavsingh97.mit-license.org/>\n\n[wordnikDocLink]:https://github.com/vaibhavsingh97/random-word/blob/master/docs/wordnik.md\n[apiNinjasDocLink]:https://github.com/vaibhavsingh97/random-word/blob/master/docs/apininjas.md\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This is a simple python package to generate random english words",
"version": "1.0.13",
"project_urls": null,
"split_keywords": [
"package",
" random words",
" word of the day",
" random word generator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "df463ce7166b6f99e61fab286d807bf8834cb8e23adbc1becff047b37c9cd666",
"md5": "72dbf056787950aae6a4782d48e33202",
"sha256": "ee399282a9d3721073dbd66b61b9e902b4bef8396a09f7133199daa4237b24e0"
},
"downloads": -1,
"filename": "random_word-1.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72dbf056787950aae6a4782d48e33202",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.8.0",
"size": 1177182,
"upload_time": "2024-11-21T00:38:52",
"upload_time_iso_8601": "2024-11-21T00:38:52.805291Z",
"url": "https://files.pythonhosted.org/packages/df/46/3ce7166b6f99e61fab286d807bf8834cb8e23adbc1becff047b37c9cd666/random_word-1.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1f645f2883c851c186f87cc01fc006a29869c35a952593e2c0f2be1a83a27351",
"md5": "433f9df405ad8a1850243e095229290a",
"sha256": "02b3ef8018315d0962a2b4ef96c5dd1181db2a51f8f72a06c3584d60e2200d00"
},
"downloads": -1,
"filename": "random_word-1.0.13.tar.gz",
"has_sig": false,
"md5_digest": "433f9df405ad8a1850243e095229290a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.8.0",
"size": 1161933,
"upload_time": "2024-11-21T00:38:55",
"upload_time_iso_8601": "2024-11-21T00:38:55.167204Z",
"url": "https://files.pythonhosted.org/packages/1f/64/5f2883c851c186f87cc01fc006a29869c35a952593e2c0f2be1a83a27351/random_word-1.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-21 00:38:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "random_word"
}
JSON