Skip to main content

One line jokes for programmers (jokes as a service)

Project description


One line jokes for programmers (jokes as a service)


Install the `pyjokes` module with pip.

Python 3::

sudo apt-get install python3-pip
sudo pip3 install pyjokes

or on some systems::

sudo apt-get install python3-pip
sudo pip-3.2 install pyjokes

Python 2::

sudo apt-get install python-pip
sudo pip install pyjokes


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 explicit (explicit 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`. You have access to the `get_joke` function, the `jokes` list, and the joke catgeory lists separately: `geek_neutral`, `geek_explicit`, `chuck_nerdy`.


* `Ben Nuttall`_
* `Alex Savio`_
* `Borja Ayerdi`_


New jokes should be proposed in the `proposal issue`_ or via pull request.

Pyjokes Society

This project is directed by the `Pyjokes Society`_

Open Source

* 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!

.. _Ben Nuttall:
.. _Alex Savio:
.. _Borja Ayerdi:
.. _
.. _Pyjokes Society:
.. _PySS 2014:
.. _BSD Licence:
.. _GitHub Issues:
.. _GitHub:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyjokes, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pyjokes-0.2.0-py2.py3-none-any.whl (10.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pyjokes-0.2.0.tar.gz (8.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page