africanjokes 1.0.0

A library for African jokes

africanjokes 🌍

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
• What is africanjokes?
• Quickstart
• Contributing
• License
• Author
• Connect with Me
• Support & Spread Laughter

---

📦 Installation

Get started instantly with pip:

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

import africanjokes

joke = africanjokes.get_joke()
print(joke)

Use from Command Line

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

$ africanjokes --joke
Why did the chicken cross the road in Lagos? To buy suya on the other side!

$ africanjokes --version
africanjokes version 1.0.0

$ 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:

import africanjokes

print(africanjokes.get_joke())
# Output: Why did the goat refuse to leave the party? Because it was the G.O.A.T!

---

🐍 Python Version Compatibility

africanjokes supports:

• Python 3.7+
• Works on Windows, macOS, and Linux

---

🤖 CLI Testing Automation

CLI commands are tested automatically using pytest and pytest-console-scripts.

Example test (see tests/test_cli.py):

def test_cli_joke(script_runner):
    result = script_runner.run('africanjokes', '--joke')
    assert result.success
    assert "Why" in result.stdout 

---

🛠️ 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 for full details.

---

📄 License

This project is licensed under the MIT 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
• GitHub
• LinkedIn
• X (Twitter)
• Twitch
• Instagram
• TikTok
• WhatsApp
• Buy Me a Coffee
• Gravatar

---

💖 Support & Spread Laughter

If you enjoy using africanjokes, please:

• ⭐ Star the repo
• 🛠️ Contribute your own jokes
• ☕ Buy Me a Coffee
• 📣 Share it with your community

Let’s spread African joy — one joke at a time.
Made with ❤️ in Africa.

---