Metadata-Version: 2.4
Name: ducky_py
Version: 0.1.0
Summary: Your rubber duck debugger pet! Explain your code to Ducky.
License: LicenseRef-LuaWrap-Custom
Author: V011DZ
Requires-Python: >=3.8,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: pygame (>=2.0,<3.0)
Description-Content-Type: text/markdown

# Ducky 🐥

Your rubber duck debugger pet! Explain your code to Ducky while you work.

Ducky sits in a small floating window over your code. Feed him, let him sleep,
give him a bath, or explain your bugs to him — he'll always have something to quack back!

## Installation

```bash
pip install ducky
```

> **Note:** Ducky requires Python 3.12 since it uses pygame.
> Run with `py -3.12 yourfile.py`

## How to Use

Just add one line at the top of your Python file:

```python
from ducky import show
show()

# Now write your code as normal!
# Ducky will float over your screen while you work.
```

## Buttons

| Button | What it does |
|---|---|
| 🍞 Feed | Feed Ducky so he's not hungry |
| 💤 Sleep | Let Ducky take a nap to restore energy |
| 🛁 Bath | Give Ducky a bath to cheer him up |
| 🗣 Explain | Type your code problem — Ducky will respond! |

## Stat Bars

| Bar | What it means |
|---|---|
| 🍞 Hunger | Keep this full by feeding Ducky |
| 💛 Happiness | Pet and interact with Ducky to keep him happy |
| 💤 Energy | Let Ducky sleep when this gets low |
| 🛁 Cleanliness | Give Ducky baths to keep this up |

## Control Ducky from your code

```python
from ducky import show, feed, sleep, bath, explain

show()

feed()              # feed Ducky
sleep()             # put Ducky to sleep
bath()              # give Ducky a bath
explain("my loop is broken")  # Ducky will respond!
```

## Why Ducky?

Rubber duck debugging is a real technique where you explain your code out loud
to a rubber duck — the act of explaining it helps you find the bug yourself.
Ducky makes it more fun! 🐥
