ElectronicsGeek / 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.

Alternatively 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 is was founded at PySS 2014 and is directed by the Pyjokes Society.