FunKitPy 0.1.0__py3-none-any.whl

funkitpy/data/roasts.json

@@ -0,0 +1,422 @@
+[
+    {
+        "id": 1,
+        "roast": "You're like a cloud. When you disappear, it's a beautiful day."
+    },
+    {
+        "id": 2,
+        "roast": "I'd agree with you but then we'd both be wrong."
+    },
+    {
+        "id": 3,
+        "roast": "Your face makes onions cry."
+    },
+    {
+        "id": 4,
+        "roast": "You're the reason the gene pool needs a lifeguard."
+    },
+    {
+        "id": 5,
+        "roast": "Mirrors can't talk, and lucky for you, they can't laugh either."
+    },
+    {
+        "id": 6,
+        "roast": "I would smack you, but I'm strictly against animal abuse."
+    },
+    {
+        "id": 7,
+        "roast": "You're the reason gene pools need lifeguards."
+    },
+    {
+        "id": 8,
+        "roast": "I forgot the world revolves around you. My apologies! How silly of me."
+    },
+    {
+        "id": 9,
+        "roast": "It's impossible to underestimate you."
+    },
+    {
+        "id": 10,
+        "roast": "If I throw a stick, will you chase it? I want out of this conversation."
+    },
+    {
+        "id": 11,
+        "roast": "You're the reason we have to put instructions on shampoo bottles."
+    },
+    {
+        "id": 12,
+        "roast": "I gave out all my trophies a while ago, but here's a participation award."
+    },
+    {
+        "id": 13,
+        "roast": "You look like a 'before' picture in a weight-loss ad."
+    },
+    {
+        "id": 14,
+        "roast": "I'm not saying I hate you, but I would unplug your life support to charge my phone."
+    },
+    {
+        "id": 15,
+        "roast": "Keep rolling your eyes. Maybe you'll find a brain back there."
+    },
+    {
+        "id": 16,
+        "roast": "Your birth certificate is an apology letter from the condom factory."
+    },
+    {
+        "id": 17,
+        "roast": "I'd agree with you, but then we'd both be wrong."
+    },
+    {
+        "id": 18,
+        "roast": "You are the human equivalent of a participation award."
+    },
+    {
+        "id": 19,
+        "roast": "You're like a software update. Every time I see you, I immediately think 'Not now.'"
+    },
+    {
+        "id": 20,
+        "roast": "It's kind of sad how you spend so much time making an absolute fool of yourself."
+    },
+    {
+        "id": 21,
+        "roast": "I'd explain it to you, but I don't have enough crayons."
+    },
+    {
+        "id": 22,
+        "roast": "You are as useless as the 'ue' in queue."
+    },
+    {
+        "id": 23,
+        "roast": "You're about as sharp as a bowling ball."
+    },
+    {
+        "id": 24,
+        "roast": "If I had a face like yours, I'd sue my parents."
+    },
+    {
+        "id": 25,
+        "roast": "I don't know what makes you so stupid, but it's definitely doing the job."
+    },
+    {
+        "id": 26,
+        "roast": "I could eat a bowl of alphabet soup and take a better dump than whatever comes out of your mouth."
+    },
+    {
+        "id": 27,
+        "roast": "You're the human version of a headache."
+    },
+    {
+        "id": 28,
+        "roast": "I'm jealous of people who don't know you."
+    },
+    {
+        "id": 29,
+        "roast": "You must have been born on a highway, because that's where most accidents happen."
+    },
+    {
+        "id": 30,
+        "roast": "Is your middle name 'google' because you assume you have all the answers?"
+    },
+    {
+        "id": 31,
+        "roast": "I look at you and I think, 'Where have all the intelligent people gone?'"
+    },
+    {
+        "id": 32,
+        "roast": "You have a face made for radio."
+    },
+    {
+        "id": 33,
+        "roast": "You look like the 'after' picture of a massive electrical fire."
+    },
+    {
+        "id": 34,
+        "roast": "You're one of those people that makes life worth living... for other people."
+    },
+    {
+        "id": 35,
+        "roast": "Some people bring joy wherever they go. You bring joy whenever you go."
+    },
+    {
+        "id": 36,
+        "roast": "Your secrets are safe with me. I never listen to them anyway."
+    },
+    {
+        "id": 37,
+        "roast": "You're a gray cloud disguised as a human."
+    },
+    {
+        "id": 38,
+        "roast": "I'd love to stay and chat, but I'd rather do absolutely anything else."
+    },
+    {
+        "id": 39,
+        "roast": "You're the human equivalent of a rainy Monday."
+    },
+    {
+        "id": 40,
+        "roast": "You look like a potato that tried to be a human and failed halfway through."
+    },
+    {
+        "id": 41,
+        "roast": "I've met a lot of pricks in my life, but you are the whole cactus."
+    },
+    {
+        "id": 42,
+        "roast": "I'm glad to see you're not letting your education get in the way of your ignorance."
+    },
+    {
+        "id": 43,
+        "roast": "You're about as useful as a screen door on a submarine."
+    },
+    {
+        "id": 44,
+        "roast": "You have the perfect personality for a doormat."
+    },
+    {
+        "id": 45,
+        "roast": "Every time you open your mouth, a part of my soul dies."
+    },
+    {
+        "id": 46,
+        "roast": "You're a fascinating specimen of what happens when evolution takes a wrong turn."
+    },
+    {
+        "id": 47,
+        "roast": "I'd love to insult you, but nature already did a phenomenal job."
+    },
+    {
+        "id": 48,
+        "roast": "You look like you were dragged through a bush backwards by a pack of angry raccoons."
+    },
+    {
+        "id": 49,
+        "roast": "I'm busy, but I'm never too busy to ignore you."
+    },
+    {
+        "id": 50,
+        "roast": "You are a magnificent monument to human disappointment."
+    },
+    {
+        "id": 51,
+        "roast": "I'd love to argue with you, but I prefer dealing with opponents who have a fighting chance."
+    },
+    {
+        "id": 52,
+        "roast": "Your idea of a good time is probably a long walk off a short pier."
+    },
+    {
+        "id": 53,
+        "roast": "You're the human version of a typo."
+    },
+    {
+        "id": 54,
+        "roast": "If laughter is the best medicine, your face must be curing the world."
+    },
+    {
+        "id": 55,
+        "roast": "You possess an astonishing ability to say absolutely nothing of value."
+    },
+    {
+        "id": 56,
+        "roast": "You look like you just realized you forgot how to breathe."
+    },
+    {
+        "id": 57,
+        "roast": "You are a stellar example of why some people should never speak."
+    },
+    {
+        "id": 58,
+        "roast": "Your personality is a lot like a broken pencil: completely pointless."
+    },
+    {
+        "id": 59,
+        "roast": "I'd give you a nasty look, but it looks like you've already got one."
+    },
+    {
+        "id": 60,
+        "roast": "You're one of those people that everyone is thinking about when they invent new rules."
+    },
+    {
+        "id": 61,
+        "roast": "You look like someone who got hit in the face with a shovel."
+    },
+    {
+        "id": 62,
+        "roast": "I'm not insulting you, I'm describing you."
+    },
+    {
+        "id": 63,
+        "roast": "You are a classic example of too much personality and not enough brain."
+    },
+    {
+        "id": 64,
+        "roast": "You're about as refreshing as a lukewarm glass of tap water."
+    },
+    {
+        "id": 65,
+        "roast": "You look like the rough draft of a person."
+    },
+    {
+        "id": 66,
+        "roast": "Your face could stop a clock, and not in a good way."
+    },
+    {
+        "id": 67,
+        "roast": "I'm not saying you're ugly, but you probably shouldn't wear your face in public."
+    },
+    {
+        "id": 68,
+        "roast": "You're the human equivalent of a buffering screen."
+    },
+    {
+        "id": 69,
+        "roast": "If you were any slower, you'd be going backwards."
+    },
+    {
+        "id": 70,
+        "roast": "You're the kind of person who needs a manual to open a banana."
+    },
+    {
+        "id": 71,
+        "roast": "Your brain is always on vacation, and it never comes back with souvenirs."
+    },
+    {
+        "id": 72,
+        "roast": "You look like the kind of person who claps when the plane lands."
+    },
+    {
+        "id": 73,
+        "roast": "You are the perfect example of why you should never judge a book by its cover, because the inside is just as disappointing."
+    },
+    {
+        "id": 74,
+        "roast": "You're the human equivalent of a participation trophy."
+    },
+    {
+        "id": 75,
+        "roast": "I'd rather eat a bowl of nails than spend five minutes in your presence."
+    },
+    {
+        "id": 76,
+        "roast": "Your face makes a great argument for contraception."
+    },
+    {
+        "id": 77,
+        "roast": "You look like the 'before' picture in an antidepressant commercial."
+    },
+    {
+        "id": 78,
+        "roast": "You're the reason people have trust issues."
+    },
+    {
+        "id": 79,
+        "roast": "You have the charisma of a wet paper towel."
+    },
+    {
+        "id": 80,
+        "roast": "I'd love to tell you what I really think of you, but I don't have enough time or energy."
+    },
+    {
+        "id": 81,
+        "roast": "You look like someone who got their sense of humor from a cereal box."
+    },
+    {
+        "id": 82,
+        "roast": "You're the kind of person who stands in the middle of a crowded hallway and wonders why everyone is bumping into you."
+    },
+    {
+        "id": 83,
+        "roast": "Your thought process is like a game of ping-pong with no paddles."
+    },
+    {
+        "id": 84,
+        "roast": "I'd love to debate you, but you've already brought nothing to the table."
+    },
+    {
+        "id": 85,
+        "roast": "You're one of those people who makes the world a darker place simply by existing in it."
+    },
+    {
+        "id": 86,
+        "roast": "You look like you've been practicing that blank stare for years."
+    },
+    {
+        "id": 87,
+        "roast": "You're the human equivalent of a flat tire."
+    },
+    {
+        "id": 88,
+        "roast": "Your conversation is like a trip to the dentist: painful and necessary to endure as quickly as possible."
+    },
+    {
+        "id": 89,
+        "roast": "I'd love to help you out, but I'd rather watch you struggle."
+    },
+    {
+        "id": 90,
+        "roast": "You look like you were built by a committee that couldn't agree on anything."
+    },
+    {
+        "id": 91,
+        "roast": "You're a living, breathing testament to low standards."
+    },
+    {
+        "id": 92,
+        "roast": "Your jokes are like a broken record: repetitive and annoying."
+    },
+    {
+        "id": 93,
+        "roast": "I'm not ignoring you, I'm just prioritizing things that actually matter."
+    },
+    {
+        "id": 94,
+        "roast": "You look like the kind of person who orders a salad at a steakhouse."
+    },
+    {
+        "id": 95,
+        "roast": "You're the human equivalent of an empty threat."
+    },
+    {
+        "id": 96,
+        "roast": "Your opinions are like a dumpster fire: messy, smelly, and impossible to look away from."
+    },
+    {
+        "id": 97,
+        "roast": "I'd love to give you a piece of my mind, but I can't spare any."
+    },
+    {
+        "id": 98,
+        "roast": "You look like someone who got their fashion advice from a blindfolded toddler."
+    },
+    {
+        "id": 99,
+        "roast": "You're the kind of person who explains things to people who already know more than you."
+    },
+    {
+        "id": 100,
+        "roast": "Your voice is like nails on a chalkboard."
+    },
+    {
+        "id": 101,
+        "roast": "I'm not saying you're dumb, but you have terrible luck thinking."
+    },
+    {
+        "id": 102,
+        "roast": "You look like you just heard a joke and are still waiting for someone to explain it to you."
+    },
+    {
+        "id": 103,
+        "roast": "You're the human equivalent of a spam email."
+    },
+    {
+        "id": 104,
+        "roast": "Your presence is a lot like a root canal: it hurts while it's happening and you're just glad it's over."
+    },
+    {
+        "id": 105,
+        "roast": "I'd love to give you the benefit of the doubt, but you've proven you don't deserve it."
+    }
+]

funkitpy/jokes.py

@@ -0,0 +1,17 @@
+import json
+import random
+from pathlib import Path
+
+DATA = Path(__file__).parent / "data"
+
+with open(DATA / "jokes.json", encoding="utf-8") as f:
+    JOKES = json.load(f)
+
+with open(DATA / "dad_jokes.json", encoding="utf-8") as f:
+    DAD_JOKES = json.load(f)
+
+def joke() -> str:
+    return random.choice(JOKES)["joke"]
+
+def dad_joke() -> str:
+    return random.choice(DAD_JOKES)["joke"]

funkitpy/roasts.py

@@ -0,0 +1,12 @@
+import json
+import random
+from pathlib import Path
+
+DATA = Path(__file__).parent / "data"
+
+
+with open(DATA / "roasts.json", encoding="utf-8") as f:
+    ROASTS = json.load(f)
+
+def roast() -> str:
+    return random.choice(ROASTS)["roast"]

funkitpy/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

funkitpy-0.1.0.dist-info/METADATA

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: FunKitPy
+Version: 0.1.0
+Summary: A lightweight Python toolkit for fetching and generating jokes, dad jokes, and roasts.
+Author: fmasterpro27
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/fmasterpro27/FunKitPy
+Project-URL: Repository, https://github.com/fmasterpro27/FunKitPy
+Project-URL: Issues, https://github.com/fmasterpro27/FunKitPy/issues
+Keywords: jokes,dad-jokes,roasts,fun
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# FunKitPy
+
+> A lightweight Python library for jokes, dad jokes, and roasts — bring the laughs to your Python projects.
+
+[![PyPI version](https://img.shields.io/pypi/v/funkitpy.svg)](https://pypi.org/project/funkitpy/)
+[![Python versions](https://img.shields.io/pypi/pyversions/funkitpy.svg)](https://pypi.org/project/funkitpy/)
+[![License](https://img.shields.io/pypi/l/funkitpy.svg)](LICENSE)
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+- [API Reference](#api-reference)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Features
+
+- 🎭 **Random Jokes** — Fetch a random joke from a curated collection
+- 👨 **Dad Jokes** — Classic, groan-worthy dad jokes on demand
+- 🔥 **Roasts** — Playful roasts for light-hearted banter
+- 📦 **Zero dependencies** — Pure Python, no external packages required
+- ⚡ **Fast & lightweight** — All data is bundled locally, no network calls needed
+
+---
+
+## Installation
+
+Install FunKitPy from PyPI using pip:
+
+```bash
+pip install funkitpy
+```
+
+Requires Python 3.8 or higher.
+
+---
+
+## Quick Start
+
+```python
+from funkitpy import get_joke, get_dad_joke, get_roast
+
+# Get a random joke
+print(get_joke())
+
+# Get a dad joke
+print(get_dad_joke())
+
+# Get a roast
+print(get_roast())
+```
+
+---
+
+## Usage
+
+### Random Jokes
+
+```python
+from funkitpy import get_joke
+
+joke = get_joke()
+print(joke)
+# Output: "Why don't scientists trust atoms? Because they make up everything!"
+```
+
+### Dad Jokes
+
+```python
+from funkitpy import get_dad_joke
+
+joke = get_dad_joke()
+print(joke)
+# Output: "I'm reading a book about anti-gravity. It's impossible to put down."
+```
+
+### Roasts
+
+```python
+from funkitpy import get_roast
+
+roast = get_roast()
+print(roast)
+# Output: "I'd roast you, but my mom said I'm not allowed to burn trash."
+```
+
+---
+
+## API Reference
+
+### `get_joke() -> str`
+
+Returns a random joke from the built-in collection.
+
+```python
+from funkitpy import get_joke
+
+joke = get_joke()  # str
+```
+
+### `get_dad_joke() -> str`
+
+Returns a random dad joke.
+
+```python
+from funkitpy import get_dad_joke
+
+joke = get_dad_joke()  # str
+```
+
+### `get_roast() -> str`
+
+Returns a random playful roast.
+
+```python
+from funkitpy import get_roast
+
+roast = get_roast()  # str
+```
+
+---
+
+## Project Structure
+
+```
+funkitpy/
+├── funkitpy/
+│   ├── __init__.py
+│   ├── jokes.py
+│   ├── dad_jokes.py
+│   ├── roasts.py
+│   └── data/
+│       ├── jokes.json
+│       ├── dad_jokes.json
+│       └── roasts.json
+├── tests/
+│   ├── test_jokes.py
+│   └── test_roasts.py
+├── pyproject.toml
+├── demo.py
+├── LICENSE
+└── README.md
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Whether it's adding new jokes, fixing bugs, or improving the docs — all help is appreciated.
+
+1. Fork the repository
+2. Create a new branch (`git checkout -b feature/add-puns`)
+3. Commit your changes (`git commit -m 'Add pun support'`)
+4. Push to your branch (`git push origin feature/add-puns`)
+5. Open a Pull Request
+
+Please make sure your code passes any existing tests before submitting.
+
+---
+
+## Links
+
+- **Homepage:** [github.com/fmasterpro27/FunKitPy](https://github.com/fmasterpro27/FunKitPy)
+- **Issues:** [github.com/fmasterpro27/FunKitPy/issues](https://github.com/fmasterpro27/FunKitPy/issues)
+- **PyPI:** [pypi.org/project/funkitpy](https://pypi.org/project/funkitpy/)
+
+---
+
+## License
+
+This project is licensed under the **Apache License 2.0**. See the [LICENSE](LICENSE) file for details.

funkitpy-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+funkitpy/__init__.py,sha256=Be6bkxYCLFTCCaU4nqmYZteZtE7BvPQ2i5QERn5do8Q,180
+funkitpy/jokes.py,sha256=MqVhxjbo0Fbfib9QW9PGWB-no057nr8enn-a7XaF_u8,403
+funkitpy/roasts.py,sha256=ifPMhtghAmlxveC3IEj1vHQ2ueaX4QtSqp8duDJW-sw,249
+funkitpy/version.py,sha256=QTYqXqSTHFRkM9TEgpDFcHvwLbvqHDqvqfQ9EiXkcAM,23
+funkitpy/data/dad_jokes.json,sha256=6u65nAgAEi7bIWgQSd8p-M8v3xgWVsfogjxEaxcvHCo,9745
+funkitpy/data/jokes.json,sha256=K2BrafnDOBOeD0kTfkbIf33Ro27gr7JfiwqFlKKN-pg,17387
+funkitpy/data/roasts.json,sha256=hkgCGPRBtGxORPIRbTxSA8EKfooigtLi2lMG_E2Obh0,12525
+funkitpy-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+funkitpy-0.1.0.dist-info/METADATA,sha256=g-dsDQ-z2mrlmV9ofcvHP4Lq_Auz5Mz3HdxfDG92Bn4,4546
+funkitpy-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+funkitpy-0.1.0.dist-info/top_level.txt,sha256=yIr2EPWt_kqT8Q2V9_7V1qiJEBDw6AiJreiy9jU7Qec,9
+funkitpy-0.1.0.dist-info/RECORD,,

funkitpy-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+