Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pyjokes/pyjokes
One line jokes for programmers (jokes as a service)
https://github.com/pyjokes/pyjokes
Last synced: 2 months ago
JSON representation
One line jokes for programmers (jokes as a service)
- Host: GitHub
- URL: https://github.com/pyjokes/pyjokes
- Owner: pyjokes
- License: bsd-3-clause
- Created: 2014-09-27T22:40:42.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-12-21T23:15:41.000Z (6 months ago)
- Last Synced: 2024-03-26T07:04:24.266Z (3 months ago)
- Language: Python
- Homepage: http://pyjok.es
- Size: 714 KB
- Stars: 324
- Watchers: 17
- Forks: 85
- Open Issues: 15
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.md
Lists
- cli-apps - pyjokes - One line jokes for programmers (jokes as a service). (<a name="funny"></a>Funny tools)
- awesome-stars - pyjokes/pyjokes - One line jokes for programmers (jokes as a service) (others)
- awesome-cli-apps - pyjokes - One line jokes for programmers (jokes as a service). (<a name="funny"></a>Funny tools)
README
=======
pyjokes
=======
.. image:: https://badge.fury.io/py/pyjokes.svg
:target: https://badge.fury.io/py/pyjokes
.. image:: https://travis-ci.org/pyjokes/pyjokes.svg
:target: https://travis-ci.org/pyjokes/pyjokes
.. image:: https://coveralls.io/repos/pyjokes/pyjokes/badge.svg?branch=master&service=github
:target: https://coveralls.io/github/pyjokes/pyjokes?branch=master
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 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`_
* `Tomasz Rozynek`_
* `Alfred Dagenais`_
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`_.
.. _documentation: http://pyjok.es/install/
.. _http://pyjok.es: http://pyjok.es/
.. _Ben Nuttall: https://github.com/bennuttall
.. _Alex Savio: https://github.com/alexsavio
.. _Borja Ayerdi: https://github.com/borjaayerdi
.. _Oier Etxaniz: https://github.com/oiertwo
.. _Luke Wren: https://github.com/wren6991
.. _Sarah Bird: https://github.com/birdsarah
.. _Yash Mehrotra: https://github.com/yashmehrotra
.. _Marc Kirkwood: https://github.com/trojjer
.. _Gregory Parker: https://github.com/ElectronicsGeek
.. _Martin O'Hanlon: https://github.com/martinohanlon
.. _Graham Markall: https://github.com/gmarkall
.. _Andreas Reinle: https://github.com/gras64
.. _Tomasz Rozynek: https://github.com/r0d0dendr0n
.. _Alfred Dagenais: https://github.com/alfreddagenais
.. _BSD Licence: http://opensource.org/licenses/BSD-3-Clause
.. _GitHub: https://github.com/pyjokes/pyjokes
.. _GitHub Issues: https://github.com/pyjokes/pyjokes/issues
.. _contribute: https://github.com/pyjokes/pyjokes/tree/master/CONTRIBUTING.md
.. _proposal issue: https://github.com/pyjokes/pyjokes/issues/10
.. _contributing policy: https://github.com/pyjokes/pyjokes/tree/master/CONTRIBUTING.md
.. _PySS 2014: http://www.pyss.org/
.. _Pyjokes Society: http://pyjok.es/society/