Installation

Install the pyjokes module with pip.

See the documentation for installation instructions.

Usage

Once installed, simply call pyjoke from the command line or add it to your .bashrc file to see a joke every time you open a terminal.

Use the -c flag to get jokes from a specific category. Options:

-c neutral [default] (neutral geek jokes)
-c chuck (Chuck Norris geek jokes)
-c all (all jokes)

You can also access the jokes in your own project by importing pyjokes and using the functions get_joke and get_jokes.

Documentation is available at https://pyjok.es/

Contributors

Development:

• Ben Nuttall

• Alex Savio

• Borja Ayerdi

• Oier Etxaniz

Jokes:

• Luke Wren

• Sarah Bird

• Yash Mehrotra

• Marc Kirkwood

• Gregory Parker

• Martin O’Hanlon

• Graham Markall

• Andreas Reinle

Contributing

• The code is licensed under the BSD Licence

• The project source code is hosted on GitHub

• 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 on GitHub

Pyjokes Society

This project was founded at PySS 2014 and is directed by the Pyjokes Society.