pyjokes

One line jokes for programmers (jokes as a service)

Installation

Install the pyjokes module with pip:

pip3 install pyjokes

Usage

Command line

Once installed, simply call pyjoke or pyjokes from the command line:

$ 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:

>>> 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:

>>> 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:

import pyjokes

for joke in pyjokes.get_jokes():
    print(joke)

Alternatively, use the pyjokes.forever generator function:

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)

Contributing

• The code is licensed under the BSD Licence
• 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)
• See the contributing policy

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 was designed by Sam Alder. The PyJokes Society is eternally grateful for his contribution.