| Name | pyjokes JSON |
| Version |
0.8.3
JSON |
| download |
| home_page | None |
| Summary | One line jokes for programmers (jokes as a service) |
| upload_time | 2024-08-10 12:39:31 |
| maintainer | None |
| docs_url | https://pythonhosted.org/pyjokes/ |
| author | Ben Nuttall |
| requires_python | <4.0,>=3.9 |
| license | BSD-3-Clause |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# pyjokes
[](https://pypi.org/project/pyjokes/)
One line jokes for programmers (jokes as a service)
[](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png)
## Installation
Install the `pyjokes` module with pip:
```console
pip3 install pyjokes
```
## Usage
### Command line
Once installed, simply call `pyjoke` or `pyjokes` from the command line:
```console
$ pyjoke
Why do Java programmers have to wear glasses? Because they don't see sharp.
```
Or add it to your `.bashrc` or `.zshrc` file to see a joke every time you open a terminal!
See `pyjokes --help` for more info.
### Python
You can also access the jokes in your own project by importing `pyjokes` and using the function
`get_joke`:
```pycon
>>> import pyjokes
>>> print(pyjokes.get_joke())
Why do programmers confuse Halloween with Christmas? Because OCT 31 == DEC 25.
```
We support many languages, and have multiple joke categories:
```pycon
>>> import pyjokes
>>> print(pyjokes.get_joke("eu")) # basque joke
Zer dira 8 Bocabits? BocaByte bat
>>> print(pyjokes.get_joke("es", "chuck")) # spanish chuck norris joke
El teclado de Chuck Norris no tiene tecla F1, es el ordenador el que le pide ayuda a él.
```
There is also a `get_jokes` function which returns all the jokes in the given language and category:
```python
import pyjokes
for joke in pyjokes.get_jokes():
print(joke)
```
Alternatively, use the `pyjokes.forever` generator function:
```python
import pyjokes
for joke in pyjokes.forever():
# This will go on forever... you're welcome.
print(joke)
```
## Maintainers
The project is maintained by the members of the PyJokes Society:
- Ben Nuttall
- Alex Savio
- Borja Ayerdi
- Oier Etxaniz ([RIP](https://www.europython-society.org/farewell-to-oier-echaniz-beneitez))
## Contributing
- The code is licensed under the [BSD Licence](http://opensource.org/licenses/BSD-3-Clause)
- Please use GitHub issues to submit bugs and report issues
- Feel free to contribute to the code
- Feel free to contribute jokes (via pull request or [proposal issue](https://github.com/pyjokes/pyjokes/issues/10))
- See the [contributing policy](https://github.com/pyjokes/pyjokes/tree/main/CONTRIBUTING.md)
## Website and documentation
The pyjokes website and documentation is available at https://pyjok.es/
## The story of pyjokes
The story of pyjokes was told by co-founder Ben Nuttall at the PyCon UK conference: https://www.youtube.com/watch?v=nCyquLc47RE
## PyJokes logo
The [logo](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png) was
designed by [Sam Alder](https://samalder.co.uk/). The PyJokes Society is eternally grateful for his
contribution.
Raw data
{
"_id": null,
"home_page": null,
"name": "pyjokes",
"maintainer": null,
"docs_url": "https://pythonhosted.org/pyjokes/",
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Ben Nuttall",
"author_email": "ben@bennuttall.com",
"download_url": "https://files.pythonhosted.org/packages/30/cc/2d25e5397d7a6d362971f23b42c8b624c5298c0864a1000cd587f39e6748/pyjokes-0.8.3.tar.gz",
"platform": null,
"description": "# pyjokes\n\n[](https://pypi.org/project/pyjokes/)\n\nOne line jokes for programmers (jokes as a service)\n\n[](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png)\n\n## Installation\n\nInstall the `pyjokes` module with pip:\n\n```console\npip3 install pyjokes\n```\n\n## Usage\n\n### Command line\n\nOnce installed, simply call `pyjoke` or `pyjokes` from the command line:\n\n```console\n$ pyjoke\nWhy do Java programmers have to wear glasses? Because they don't see sharp.\n```\n\nOr add it to your `.bashrc` or `.zshrc` file to see a joke every time you open a terminal!\n\nSee `pyjokes --help` for more info.\n\n### Python\n\nYou can also access the jokes in your own project by importing `pyjokes` and using the function\n`get_joke`:\n\n```pycon\n>>> import pyjokes\n>>> print(pyjokes.get_joke())\nWhy do programmers confuse Halloween with Christmas? Because OCT 31 == DEC 25.\n```\n\nWe support many languages, and have multiple joke categories:\n\n```pycon\n>>> import pyjokes\n>>> print(pyjokes.get_joke(\"eu\")) # basque joke\nZer dira 8 Bocabits? BocaByte bat\n>>> print(pyjokes.get_joke(\"es\", \"chuck\")) # spanish chuck norris joke\nEl teclado de Chuck Norris no tiene tecla F1, es el ordenador el que le pide ayuda a \u00e9l.\n```\n\nThere is also a `get_jokes` function which returns all the jokes in the given language and category:\n\n```python\nimport pyjokes\n\nfor joke in pyjokes.get_jokes():\n print(joke)\n```\n\nAlternatively, use the `pyjokes.forever` generator function:\n\n```python\nimport pyjokes\n\nfor joke in pyjokes.forever():\n # This will go on forever... you're welcome.\n print(joke)\n```\n\n## Maintainers\n\nThe project is maintained by the members of the PyJokes Society:\n\n- Ben Nuttall\n- Alex Savio\n- Borja Ayerdi\n- Oier Etxaniz ([RIP](https://www.europython-society.org/farewell-to-oier-echaniz-beneitez))\n\n## Contributing\n\n- The code is licensed under the [BSD Licence](http://opensource.org/licenses/BSD-3-Clause)\n- Please use GitHub issues to submit bugs and report issues\n- Feel free to contribute to the code\n- Feel free to contribute jokes (via pull request or [proposal issue](https://github.com/pyjokes/pyjokes/issues/10))\n- See the [contributing policy](https://github.com/pyjokes/pyjokes/tree/main/CONTRIBUTING.md)\n\n## Website and documentation\n\nThe pyjokes website and documentation is available at https://pyjok.es/\n\n## The story of pyjokes\n\nThe story of pyjokes was told by co-founder Ben Nuttall at the PyCon UK conference: https://www.youtube.com/watch?v=nCyquLc47RE\n\n## PyJokes logo\n\nThe [logo](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png) was\ndesigned by [Sam Alder](https://samalder.co.uk/). The PyJokes Society is eternally grateful for his\ncontribution.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "One line jokes for programmers (jokes as a service)",
"version": "0.8.3",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1ddd2495fe4d1ff804ec3094ad4c76cd0fcfb8902d630ce690118560a40df171",
"md5": "bdaa4efb3c611f9e9c4d93332f8720a8",
"sha256": "12836e61bc7a2c1ff302604a040f0f63ac36c5c947c20319fcb5d1ab37bac46e"
},
"downloads": -1,
"filename": "pyjokes-0.8.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bdaa4efb3c611f9e9c4d93332f8720a8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 47563,
"upload_time": "2024-08-10T12:39:30",
"upload_time_iso_8601": "2024-08-10T12:39:30.730430Z",
"url": "https://files.pythonhosted.org/packages/1d/dd/2495fe4d1ff804ec3094ad4c76cd0fcfb8902d630ce690118560a40df171/pyjokes-0.8.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "30cc2d25e5397d7a6d362971f23b42c8b624c5298c0864a1000cd587f39e6748",
"md5": "af2bc5d0a34fd60f7d79661c12cafbc7",
"sha256": "5735d31e973d5b6934b46b89431505733c3110f9b66eac0ff0be86f7f3646423"
},
"downloads": -1,
"filename": "pyjokes-0.8.3.tar.gz",
"has_sig": false,
"md5_digest": "af2bc5d0a34fd60f7d79661c12cafbc7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 44617,
"upload_time": "2024-08-10T12:39:31",
"upload_time_iso_8601": "2024-08-10T12:39:31.980533Z",
"url": "https://files.pythonhosted.org/packages/30/cc/2d25e5397d7a6d362971f23b42c8b624c5298c0864a1000cd587f39e6748/pyjokes-0.8.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-10 12:39:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyjokes"
}
