aleale99/pyjokes

One line jokes for programmers (jokes as a service)

pyjokes

One line jokes for programmers (jokes as a service)

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 everytime you start a terminal session.

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

-c neutral [default] (neutral geek jokes)
-c adult (adult 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

Comprehensive documentation is available at http://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

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

Tests

Install requirements (pytest)

Run tests:

python setup.py test

Pyjokes Society

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