| Name | africanjokes JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | https://github.com/daddysboy21/africanjokes |
| Summary | A library for African jokes |
| upload_time | 2025-07-30 07:35:54 |
| maintainer | None |
| docs_url | None |
| author | Morris D. Toclo |
| requires_python | >=3.8 |
| license | MIT License
Copyright (c) 2025-2026 Morris D. Toclo
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
|
| keywords |
jokes
africa
fun
humor
python
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# africanjokes 🌍
<!-- Main project stats badges -->
[](https://pypi.org/project/africanjokes/)
[](https://pepy.tech/project/africanjokes)
[](https://github.com/daddysboy21/africanjokes/actions)
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/africanjokes/)
[](https://github.com/daddysboy21/africanjokes)
<!-- GitHub community stats badges -->
[](https://github.com/daddysboy21/africanjokes/stargazers)
[](https://github.com/daddysboy21/africanjokes/network)
[](https://github.com/daddysboy21/africanjokes/watchers)
[](https://github.com/daddysboy21/africanjokes/commits)
[](https://github.com/daddysboy21/africanjokes/issues)
<br>
<!-- Social & support badges grouped for clarity -->
[](https://twitter.com/daddysboy_21)
[](https://github.com/daddysboy21)
[](https://instagram.com/daddysboy.21)
[](https://tiktok.com/@daddysboy.21)
[](https://twitch.tv/daddysboy_21)
[](https://daddysboy21.link)
[](https://wa.me/231555557034)
[](https://buymeacoffee.com/PBEzMY14YC)
---
**africanjokes** is a simple, lightweight Python library that delivers random African jokes —
because every coder deserves a laugh, especially from the Motherland.
Spread joy, lighten up your day, and code with a smile! 😄
---
---
## 📚 Table of Contents
- [Installation](#-installation)
- [What is africanjokes?](#-what-is-africanjokes)
- [Quickstart](#-quickstart)
- [Contributing](#️-contributing)
- [License](#-license)
- [Author](#-author)
- [Connect with Me](#-connect-with-me)
- [Support & Spread Laughter](#-support--spread-laughter)
---
## 📦 Installation
Get started instantly with pip:
```bash
pip install africanjokes
```
---
## 🤔 What is africanjokes?
`africanjokes` brings the vibrant humor of Africa right into your terminal, scripts, bots, or applications.
**Perfect for:**
- Coding sessions 👨💻
- Presentations 🗣️
- Discord/Telegram bots 🤖
- Slack integrations 💬
- Daily CLI jokes ☀️
Whether you're looking to break the ice or just need a pick-me-up, africanjokes has you covered!
---
## 🚀 Quickstart
### Use in Python
```python
import africanjokes
joke = africanjokes.get_joke()
print(joke)
```
### Use from Command Line
```bash
africanjokes --joke
```
Get a new random African joke every time you run it!
---
## 🖥️ CLI Usage
africanjokes comes with a handy command-line interface.
### Commands
- `--joke` or `-j`
Output a random African joke.
- `--version` or `-v`
Show the current africanjokes version.
- `--help` or `-h`
Display help message and usage.
### Example Output
```bash
$ africanjokes --joke
Why did the chicken cross the road in Lagos? To buy suya on the other side!
$ africanjokes --version
africanjokes version 1.0.1
$ africanjokes --help
Usage: africanjokes [OPTIONS]
Options:
--joke, -j Show a random African joke
--version, -v Show version info
--help, -h Show this help message
```
---
## 👀 Preview
Here’s what you get when you use africanjokes:
```python
import africanjokes
print(africanjokes.get_joke())
# Output: Why did the lion avoid social media? Too many cheetahs!
```
---
## 🐍 Python Version Compatibility
africanjokes supports:
- Python 3.7+
- Works on Windows, macOS, and Linux
---
## 🤖 CLI Testing Automation
CLI commands are tested automatically using [pytest](https://pytest.org/) and [pytest-console-scripts](https://github.com/manahl/pytest-plugins/tree/master/pytest-console-scripts).
Example test:
```python
import africanjokes
def test_get_joke_returns_string():
joke = africanjokes.get_joke()
assert isinstance(joke, str)
assert joke
```
---
## 🛠️ Contributing
Got a great African joke to share?
Help us keep the laughter flowing — contributions are welcome!
1. **Fork** the repo
2. **Add** your joke
3. **Submit** a PR
See [`CONTRIBUTING wiki`](https://github.com/daddysboy21/africanjokes/wiki/Contributing) for full details.
---
## 📄 License
This project is licensed under the [`MIT License`](https://github.com/daddysboy21/africanjokes/blob/main/LICENSE)
— free to use, modify, and distribute.
---
## 👤 Author
**`Morris D. Toclo`**
Co-Founder & Co-CEO of LoneScore
Student — BlueCrest University College Liberia
Monrovia, Liberia `🇱🇷`
---
## 🌐 Connect with Me
- [`Website`](https://daddysboy21.link)
- [`GitHub`](https://github.com/daddysboy21)
- [`LinkedIn`](https://www.linkedin.com/in/morris-toclo-a83858275)
- [`X (Twitter)`](https://x.com/daddysboy_21)
- [`Twitch`](https://twitch.tv/daddysboy_21)
- [`Instagram`](https://instagram.com/daddysboy.21)
- [`TikTok`](https://tiktok.com/@daddysboy.21)
- [`WhatsApp`](https://wa.me/231555557034)
- [`Buy Me a Coffee`](https://buymeacoffee.com/PBEzMY14YC)
- [`Gravatar`](https://daddysboy21.link)
---
## 💖 Support & Spread Laughter
If you enjoy using africanjokes, please:
- ⭐ Star the repo
- 🛠️ Contribute your own jokes
- ☕ [`Buy Me a Coffee`](https://buymeacoffee.com/PBEzMY14YC)
- 📣 Share it with your community
Let’s spread African joy — one joke at a time.
**`Made with ❤️ in Africa.`**
---
Raw data
{
"_id": null,
"home_page": "https://github.com/daddysboy21/africanjokes",
"name": "africanjokes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "\"Morris D. Toclo\" <morristoclo@gmail.com>",
"keywords": "jokes, africa, fun, humor, python",
"author": "Morris D. Toclo",
"author_email": "\"Morris D. Toclo\" <morristoclo@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/04/dd/856ce30f212713d81d8aea0fbbeb792f24846352a269ac98a6eac6a5a021/africanjokes-1.0.1.tar.gz",
"platform": null,
"description": "# africanjokes \ud83c\udf0d\r\n\r\n<!-- Main project stats badges -->\r\n[](https://pypi.org/project/africanjokes/)\r\n[](https://pepy.tech/project/africanjokes)\r\n[](https://github.com/daddysboy21/africanjokes/actions)\r\n[](https://opensource.org/licenses/MIT)\r\n[](https://pypi.org/project/africanjokes/)\r\n[](https://github.com/daddysboy21/africanjokes)\r\n\r\n<!-- GitHub community stats badges -->\r\n[](https://github.com/daddysboy21/africanjokes/stargazers)\r\n[](https://github.com/daddysboy21/africanjokes/network)\r\n[](https://github.com/daddysboy21/africanjokes/watchers)\r\n[](https://github.com/daddysboy21/africanjokes/commits)\r\n[](https://github.com/daddysboy21/africanjokes/issues)\r\n\r\n<br>\r\n\r\n<!-- Social & support badges grouped for clarity -->\r\n[](https://twitter.com/daddysboy_21)\r\n[](https://github.com/daddysboy21)\r\n[](https://instagram.com/daddysboy.21)\r\n[](https://tiktok.com/@daddysboy.21)\r\n[](https://twitch.tv/daddysboy_21)\r\n[](https://daddysboy21.link)\r\n[](https://wa.me/231555557034)\r\n[](https://buymeacoffee.com/PBEzMY14YC)\r\n\r\n---\r\n\r\n**africanjokes** is a simple, lightweight Python library that delivers random African jokes \u2014 \r\nbecause every coder deserves a laugh, especially from the Motherland. \r\nSpread joy, lighten up your day, and code with a smile! \ud83d\ude04\r\n\r\n---\r\n\r\n---\r\n\r\n## \ud83d\udcda Table of Contents\r\n\r\n- [Installation](#-installation)\r\n- [What is africanjokes?](#-what-is-africanjokes)\r\n- [Quickstart](#-quickstart)\r\n- [Contributing](#\ufe0f-contributing)\r\n- [License](#-license)\r\n- [Author](#-author)\r\n- [Connect with Me](#-connect-with-me)\r\n- [Support & Spread Laughter](#-support--spread-laughter)\r\n\r\n---\r\n\r\n## \ud83d\udce6 Installation\r\n\r\nGet started instantly with pip:\r\n\r\n```bash\r\npip install africanjokes\r\n```\r\n\r\n---\r\n\r\n## \ud83e\udd14 What is africanjokes?\r\n\r\n`africanjokes` brings the vibrant humor of Africa right into your terminal, scripts, bots, or applications.\r\n\r\n**Perfect for:**\r\n- Coding sessions \ud83d\udc68\u200d\ud83d\udcbb\r\n- Presentations \ud83d\udde3\ufe0f\r\n- Discord/Telegram bots \ud83e\udd16\r\n- Slack integrations \ud83d\udcac\r\n- Daily CLI jokes \u2600\ufe0f\r\n\r\nWhether you're looking to break the ice or just need a pick-me-up, africanjokes has you covered!\r\n\r\n---\r\n\r\n## \ud83d\ude80 Quickstart\r\n\r\n### Use in Python\r\n\r\n```python\r\nimport africanjokes\r\n\r\njoke = africanjokes.get_joke()\r\nprint(joke)\r\n```\r\n\r\n### Use from Command Line\r\n\r\n```bash\r\nafricanjokes --joke\r\n```\r\n\r\nGet a new random African joke every time you run it!\r\n\r\n---\r\n\r\n## \ud83d\udda5\ufe0f CLI Usage\r\n\r\nafricanjokes comes with a handy command-line interface.\r\n\r\n### Commands\r\n\r\n- `--joke` or `-j` \r\n Output a random African joke.\r\n\r\n- `--version` or `-v` \r\n Show the current africanjokes version.\r\n\r\n- `--help` or `-h` \r\n Display help message and usage.\r\n\r\n### Example Output\r\n\r\n```bash\r\n$ africanjokes --joke\r\nWhy did the chicken cross the road in Lagos? To buy suya on the other side!\r\n\r\n$ africanjokes --version\r\nafricanjokes version 1.0.1\r\n\r\n$ africanjokes --help\r\nUsage: africanjokes [OPTIONS]\r\nOptions:\r\n --joke, -j Show a random African joke\r\n --version, -v Show version info\r\n --help, -h Show this help message\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udc40 Preview\r\n\r\nHere\u2019s what you get when you use africanjokes:\r\n\r\n```python\r\nimport africanjokes\r\n\r\nprint(africanjokes.get_joke())\r\n# Output: Why did the lion avoid social media? Too many cheetahs!\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udc0d Python Version Compatibility\r\n\r\nafricanjokes supports:\r\n\r\n- Python 3.7+\r\n- Works on Windows, macOS, and Linux\r\n\r\n---\r\n\r\n## \ud83e\udd16 CLI Testing Automation\r\n\r\nCLI commands are tested automatically using [pytest](https://pytest.org/) and [pytest-console-scripts](https://github.com/manahl/pytest-plugins/tree/master/pytest-console-scripts).\r\n\r\nExample test:\r\n\r\n```python\r\nimport africanjokes\r\n\r\ndef test_get_joke_returns_string():\r\n joke = africanjokes.get_joke()\r\n assert isinstance(joke, str)\r\n assert joke\r\n \r\n```\r\n\r\n---\r\n\r\n## \ud83d\udee0\ufe0f Contributing\r\n\r\nGot a great African joke to share? \r\nHelp us keep the laughter flowing \u2014 contributions are welcome!\r\n\r\n1. **Fork** the repo \r\n2. **Add** your joke \r\n3. **Submit** a PR \r\n\r\nSee [`CONTRIBUTING wiki`](https://github.com/daddysboy21/africanjokes/wiki/Contributing) for full details.\r\n\r\n---\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the [`MIT License`](https://github.com/daddysboy21/africanjokes/blob/main/LICENSE)\r\n \u2014 free to use, modify, and distribute.\r\n\r\n---\r\n\r\n## \ud83d\udc64 Author\r\n\r\n**`Morris D. Toclo`** \r\nCo-Founder & Co-CEO of LoneScore \r\nStudent \u2014 BlueCrest University College Liberia \r\nMonrovia, Liberia `\ud83c\uddf1\ud83c\uddf7`\r\n\r\n---\r\n\r\n## \ud83c\udf10 Connect with Me\r\n\r\n- [`Website`](https://daddysboy21.link)\r\n- [`GitHub`](https://github.com/daddysboy21)\r\n- [`LinkedIn`](https://www.linkedin.com/in/morris-toclo-a83858275)\r\n- [`X (Twitter)`](https://x.com/daddysboy_21)\r\n- [`Twitch`](https://twitch.tv/daddysboy_21)\r\n- [`Instagram`](https://instagram.com/daddysboy.21)\r\n- [`TikTok`](https://tiktok.com/@daddysboy.21)\r\n- [`WhatsApp`](https://wa.me/231555557034)\r\n- [`Buy Me a Coffee`](https://buymeacoffee.com/PBEzMY14YC)\r\n- [`Gravatar`](https://daddysboy21.link)\r\n\r\n---\r\n\r\n## \ud83d\udc96 Support & Spread Laughter\r\n\r\nIf you enjoy using africanjokes, please:\r\n\r\n- \u2b50 Star the repo \r\n- \ud83d\udee0\ufe0f Contribute your own jokes \r\n- \u2615 [`Buy Me a Coffee`](https://buymeacoffee.com/PBEzMY14YC) \r\n- \ud83d\udce3 Share it with your community \r\n\r\nLet\u2019s spread African joy \u2014 one joke at a time. \r\n**`Made with \u2764\ufe0f in Africa.`**\r\n\r\n---\r\n",
"bugtrack_url": null,
"license": "MIT License\r\n \r\n Copyright (c) 2025-2026 Morris D. Toclo\r\n \r\n Permission is hereby granted, free of charge, to any person obtaining a copy\r\n of this software and associated documentation files (the \"Software\"), to deal\r\n in the Software without restriction, including without limitation the rights\r\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n copies of the Software, and to permit persons to whom the Software is\r\n furnished to do so, subject to the following conditions:\r\n \r\n The above copyright notice and this permission notice shall be included in all\r\n copies or substantial portions of the Software.\r\n \r\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n SOFTWARE.\r\n ",
"summary": "A library for African jokes",
"version": "1.0.1",
"project_urls": {
"Author": "https://github.com/daddysboy21",
"Documentation": "https://github.com/daddysboy21/africanjokes/wiki",
"Funding": "https://buymeacoffee.com/PBEzMY14YC",
"Homepage": "https://github.com/daddysboy21/africanjokes",
"License": "https://github.com/daddysboy21/africanjokes/blob/main/LICENSE",
"Source": "https://github.com/daddysboy21/africanjokes",
"Tracker": "https://github.com/daddysboy21/africanjokes/issues",
"Website": "https://daddysboy21.link"
},
"split_keywords": [
"jokes",
" africa",
" fun",
" humor",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ce2fee4696d4f5bc9bc768dc1f1991da78a150075a318ee3ca2efe4687130a63",
"md5": "da8fb9858b4f19c3e17884cb4310ec43",
"sha256": "f6d4593c6799b6d41610d3913e4ec07f2028668a189cb9591587bbe92db9be24"
},
"downloads": -1,
"filename": "africanjokes-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "da8fb9858b4f19c3e17884cb4310ec43",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11821,
"upload_time": "2025-07-30T07:35:53",
"upload_time_iso_8601": "2025-07-30T07:35:53.685724Z",
"url": "https://files.pythonhosted.org/packages/ce/2f/ee4696d4f5bc9bc768dc1f1991da78a150075a318ee3ca2efe4687130a63/africanjokes-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "04dd856ce30f212713d81d8aea0fbbeb792f24846352a269ac98a6eac6a5a021",
"md5": "9dc614a907fd0843ea396dec84c9effe",
"sha256": "a5086ca2a0dbcf1f3dfedacb21436fa082d71eb03e6dbe03690a421fcb03b7ef"
},
"downloads": -1,
"filename": "africanjokes-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "9dc614a907fd0843ea396dec84c9effe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14497,
"upload_time": "2025-07-30T07:35:54",
"upload_time_iso_8601": "2025-07-30T07:35:54.972336Z",
"url": "https://files.pythonhosted.org/packages/04/dd/856ce30f212713d81d8aea0fbbeb792f24846352a269ac98a6eac6a5a021/africanjokes-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 07:35:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "daddysboy21",
"github_project": "africanjokes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "africanjokes"
}
