catsay-py 0.1.0__tar.gz

catsay_py-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FelineFantasy
+
+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.

catsay_py-0.1.0/PKG-INFO

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: catsay-py
+Version: 0.1.0
+Summary: A cute cat that says things in the terminal
+Author-email: FelineFantasy <mailsalavata5@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/FelineFantasy/catsay
+Project-URL: Repository, https://github.com/FelineFantasy/catsay
+Project-URL: Issues, https://github.com/FelineFantasy/catsay/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Terminals
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# catsay 🐱 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A cute ASCII cat library that says, warns, thinks, and asks questions. Perfect for making your CLI output more fun and expressive!
+
+## 📝 Description
+
+**catsay** is a tiny Python library that renders an ASCII cat with messages. It provides several functions for different use cases:
+
+- 🗣️ `say` — The cat says text with a given mood
+- ⚠️ `warn` — The cat outputs a warning
+- ❌ `error` — The cat shows an error message
+- 💭 `think` — The cat thinks thoughtfully
+- ❓ `ask` — The cat asks a question and returns the user's answer
+
+### Features:
+
+- 🎭 **4 moods** — happy, sleepy, angry, love
+- 📦 **Zero dependencies** — Pure Python, no extra packages
+- 🔌 **Simple API** — 5 functions for all use cases
+- 🎨 **ASCII art** — No external images or assets needed
+- 💬 **Interactive** — `ask()` reads user input
+
+## ⚙️ Installation
+
+### Option 1: Install from PyPI
+
+```bash
+pip install catsay-py
+```
+
+### Option 2: Copy the file
+
+Just copy `catsay.py` into your project:
+
+```bash
+# Place catsay.py in your project directory
+```
+
+### Option 3: Install from Git
+
+```bash
+git clone https://github.com/FelineFantasy/catsay
+cd catsay
+pip install .
+```
+
+## 🚀 Usage
+
+### Basic
+
+```python
+from catsay import say, warn, error, think, ask
+
+say("Hello, World!")
+warn("Don't forget to feed the cat!")
+error("Something went wrong!")
+think("Hmm, interesting...")
+answer = ask("What's your name?")
+print(f"User said: {answer}")
+```
+
+### Moods
+
+```python
+say("I'm happy!", mood="happy")
+say("Zzz...", mood="sleepy")
+say("I'm angry!", mood="angry")
+say("I love you!", mood="love")
+```
+
+### Without text
+
+```python
+say()  # Just a cute cat
+think()  # Thinking cat
+warn()  # Warning cat
+error()  # Error cat
+```
+
+## 📖 API Reference
+
+### `say(text: str = "", mood: str = "happy") -> None`
+
+The cat says text with a given mood.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to display |
+| `mood` | `str` | `"happy"` | Cat mood: `happy`, `sleepy`, `angry`, `love` |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+say("Meow!")
+#    /\_/\
+#   ( o.o )  >  Meow!
+#    > ^ <
+```
+
+---
+
+### `warn(text: str = "") -> None`
+
+The cat outputs a warning.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Warning message |
+
+**Example:**
+
+```python
+warn("Low disk space!")
+#    /\_/\
+#   ( -.o )  ~  Low disk space! ~~~
+#    > ^ <
+```
+
+---
+
+### `error(text: str = "Error") -> None`
+
+The cat outputs an error message (uses angry mood).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `"Error"` | Error message |
+
+**Example:**
+
+```python
+error("File not found!")
+#    /\_/\
+#   ( ò.ó )  >  !!! File not found! !!!
+#    > ^ <
+```
+
+---
+
+### `think(text: str = "", mood: str = "happy") -> None`
+
+The cat says text thoughtfully (with `<` bubble).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to think about |
+| `mood` | `str` | `"happy"` | Cat mood |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+think("Hmm, interesting...")
+#    /\_/\
+#   ( o.o )  <  Hmm, interesting...
+#    > ^ <
+```
+
+---
+
+### `ask(question: str = "") -> str`
+
+The cat asks a question and returns the user's answer.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `question` | `str` | `""` | Question to ask |
+
+**Returns:** `str` — User's input
+
+**Example:**
+
+```python
+name = ask("What's your name?")
+print(f"Hello, {name}!")
+```
+
+## 🎭 Moods
+
+| Mood | Face | Description |
+|------|------|-------------|
+| `happy` | `o.o` | Default, friendly cat |
+| `sleepy` | `-.-` | Tired, drowsy cat |
+| `angry` | `ò.ó` | Angry, frustrated cat |
+| `love` | `^.^` | Loving, affectionate cat |
+
+## 🧪 Full Example
+
+```python
+from catsay import say, warn, error, think, ask
+
+print("=== say() ===\n")
+say()
+say("Meow!", mood="happy")
+say("Zzz", mood="sleepy")
+say("meow :(", mood="angry")
+say("I love you!", mood="love")
+
+print("\n=== warn() ===\n")
+warn()
+warn("Where's my food!")
+
+print("\n=== error() ===\n")
+error()
+error("The cat has fallen!")
+
+print("\n=== think() ===\n")
+think()
+think("Hmm", mood="happy")
+think("Hmm", mood="sleepy")
+think("Hmm", mood="angry")
+think("Hmm", mood="love")
+
+print("\n=== ask() ===\n")
+ask()
+ask("Where's my food?")
+```
+
+## 🧪 Testing
+
+Run the test suite with the standard library `unittest`:
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+Tests also run automatically on every push and pull request via GitHub Actions.
+
+## 📁 Project Structure
+
+```text
+catsay/
+├── .github/
+│   ├── FUNDING.yml           # Support link for DonationAlerts
+│   └── workflows/
+│       └── tests.yml         # CI workflow for running tests
+├── catsay.py                 # Main library
+├── README.md                 # Documentation
+├── LICENSE                   # MIT License
+├── pyproject.toml            # Package configuration
+├── tests/
+│   └── test_catsay.py        # Unit tests
+└── .gitignore                # Git ignore rules
+```
+
+## 🛠 Technologies
+
+- **Python 3.8+** — Pure standard library, no external dependencies
+
+## 📋 Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## 💖 Support the Project
+
+If you enjoy **catsay** and want to help keep the project alive, you can support me here:
+
+[![DonationAlerts](https://img.shields.io/badge/DonationAlerts-Support-blue.svg)](https://www.donationalerts.com/r/felinefantasy)
+
+Your support helps me:
+- 🐱 Keep developing cute tools
+- 🛠️ Add more moods and features
+- ☕ Stay awake while coding at 4 AM
+
+Every little bit is appreciated! ❤️
+
+## 👤 Author
+- **FelineFantasy**
+- **License**: MIT

catsay_py-0.1.0/README.md

@@ -0,0 +1,273 @@
+# catsay 🐱 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A cute ASCII cat library that says, warns, thinks, and asks questions. Perfect for making your CLI output more fun and expressive!
+
+## 📝 Description
+
+**catsay** is a tiny Python library that renders an ASCII cat with messages. It provides several functions for different use cases:
+
+- 🗣️ `say` — The cat says text with a given mood
+- ⚠️ `warn` — The cat outputs a warning
+- ❌ `error` — The cat shows an error message
+- 💭 `think` — The cat thinks thoughtfully
+- ❓ `ask` — The cat asks a question and returns the user's answer
+
+### Features:
+
+- 🎭 **4 moods** — happy, sleepy, angry, love
+- 📦 **Zero dependencies** — Pure Python, no extra packages
+- 🔌 **Simple API** — 5 functions for all use cases
+- 🎨 **ASCII art** — No external images or assets needed
+- 💬 **Interactive** — `ask()` reads user input
+
+## ⚙️ Installation
+
+### Option 1: Install from PyPI
+
+```bash
+pip install catsay-py
+```
+
+### Option 2: Copy the file
+
+Just copy `catsay.py` into your project:
+
+```bash
+# Place catsay.py in your project directory
+```
+
+### Option 3: Install from Git
+
+```bash
+git clone https://github.com/FelineFantasy/catsay
+cd catsay
+pip install .
+```
+
+## 🚀 Usage
+
+### Basic
+
+```python
+from catsay import say, warn, error, think, ask
+
+say("Hello, World!")
+warn("Don't forget to feed the cat!")
+error("Something went wrong!")
+think("Hmm, interesting...")
+answer = ask("What's your name?")
+print(f"User said: {answer}")
+```
+
+### Moods
+
+```python
+say("I'm happy!", mood="happy")
+say("Zzz...", mood="sleepy")
+say("I'm angry!", mood="angry")
+say("I love you!", mood="love")
+```
+
+### Without text
+
+```python
+say()  # Just a cute cat
+think()  # Thinking cat
+warn()  # Warning cat
+error()  # Error cat
+```
+
+## 📖 API Reference
+
+### `say(text: str = "", mood: str = "happy") -> None`
+
+The cat says text with a given mood.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to display |
+| `mood` | `str` | `"happy"` | Cat mood: `happy`, `sleepy`, `angry`, `love` |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+say("Meow!")
+#    /\_/\
+#   ( o.o )  >  Meow!
+#    > ^ <
+```
+
+---
+
+### `warn(text: str = "") -> None`
+
+The cat outputs a warning.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Warning message |
+
+**Example:**
+
+```python
+warn("Low disk space!")
+#    /\_/\
+#   ( -.o )  ~  Low disk space! ~~~
+#    > ^ <
+```
+
+---
+
+### `error(text: str = "Error") -> None`
+
+The cat outputs an error message (uses angry mood).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `"Error"` | Error message |
+
+**Example:**
+
+```python
+error("File not found!")
+#    /\_/\
+#   ( ò.ó )  >  !!! File not found! !!!
+#    > ^ <
+```
+
+---
+
+### `think(text: str = "", mood: str = "happy") -> None`
+
+The cat says text thoughtfully (with `<` bubble).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to think about |
+| `mood` | `str` | `"happy"` | Cat mood |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+think("Hmm, interesting...")
+#    /\_/\
+#   ( o.o )  <  Hmm, interesting...
+#    > ^ <
+```
+
+---
+
+### `ask(question: str = "") -> str`
+
+The cat asks a question and returns the user's answer.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `question` | `str` | `""` | Question to ask |
+
+**Returns:** `str` — User's input
+
+**Example:**
+
+```python
+name = ask("What's your name?")
+print(f"Hello, {name}!")
+```
+
+## 🎭 Moods
+
+| Mood | Face | Description |
+|------|------|-------------|
+| `happy` | `o.o` | Default, friendly cat |
+| `sleepy` | `-.-` | Tired, drowsy cat |
+| `angry` | `ò.ó` | Angry, frustrated cat |
+| `love` | `^.^` | Loving, affectionate cat |
+
+## 🧪 Full Example
+
+```python
+from catsay import say, warn, error, think, ask
+
+print("=== say() ===\n")
+say()
+say("Meow!", mood="happy")
+say("Zzz", mood="sleepy")
+say("meow :(", mood="angry")
+say("I love you!", mood="love")
+
+print("\n=== warn() ===\n")
+warn()
+warn("Where's my food!")
+
+print("\n=== error() ===\n")
+error()
+error("The cat has fallen!")
+
+print("\n=== think() ===\n")
+think()
+think("Hmm", mood="happy")
+think("Hmm", mood="sleepy")
+think("Hmm", mood="angry")
+think("Hmm", mood="love")
+
+print("\n=== ask() ===\n")
+ask()
+ask("Where's my food?")
+```
+
+## 🧪 Testing
+
+Run the test suite with the standard library `unittest`:
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+Tests also run automatically on every push and pull request via GitHub Actions.
+
+## 📁 Project Structure
+
+```text
+catsay/
+├── .github/
+│   ├── FUNDING.yml           # Support link for DonationAlerts
+│   └── workflows/
+│       └── tests.yml         # CI workflow for running tests
+├── catsay.py                 # Main library
+├── README.md                 # Documentation
+├── LICENSE                   # MIT License
+├── pyproject.toml            # Package configuration
+├── tests/
+│   └── test_catsay.py        # Unit tests
+└── .gitignore                # Git ignore rules
+```
+
+## 🛠 Technologies
+
+- **Python 3.8+** — Pure standard library, no external dependencies
+
+## 📋 Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## 💖 Support the Project
+
+If you enjoy **catsay** and want to help keep the project alive, you can support me here:
+
+[![DonationAlerts](https://img.shields.io/badge/DonationAlerts-Support-blue.svg)](https://www.donationalerts.com/r/felinefantasy)
+
+Your support helps me:
+- 🐱 Keep developing cute tools
+- 🛠️ Add more moods and features
+- ☕ Stay awake while coding at 4 AM
+
+Every little bit is appreciated! ❤️
+
+## 👤 Author
+- **FelineFantasy**
+- **License**: MIT

catsay_py-0.1.0/catsay.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+
+"""
+Catsay - ASCII cat with customizable moods and messages
+"""
+
+# catsay.py
+__all__ = ["say", "warn", "error", "think", "ask"]
+
+FACES = {
+    "happy": "o.o",
+    "sleepy": "-.-",
+    "angry": "ò.ó",
+    "love": "^.^",
+}
+
+
+def _get_face(mood: str) -> str:
+    """Return the face for a mood, raising ValueError if it is unknown."""
+    if mood not in FACES:
+        raise ValueError(f"Unsupported mood: {mood}. Available: {list(FACES.keys())}")
+    return FACES[mood]
+
+
+def say(text: str = "", mood: str = "happy") -> None:
+    """The cat says text with a given mood (happy/sleepy/angry/love)."""
+    face = _get_face(mood)
+
+    cat = rf"""   /\_/\
+  ( {face} )  >  {text}
+   > ^ <""" if text else rf"""   /\_/\
+  ( {face} )
+   > ^ <"""
+    print(cat)
+
+
+def warn(text: str = "") -> None:
+    """The cat outputs a warning."""
+    cat = rf"""   /\_/\
+  ( -.o )  ~  {text} ~~~
+   > ^ <"""
+    print(cat)
+
+
+def error(text: str = "Error") -> None:
+    """The cat outputs an error message."""
+    say(f"!!! {text} !!!", mood="angry")
+
+
+def think(text: str = "", mood: str = "happy") -> None:
+    """The cat says text thoughtfully."""
+    face = _get_face(mood)
+    thought = f"  <  {text}..." if text else "  <"
+    cat = rf"""   /\_/\
+  ( {face} ){thought}
+   > ^ <"""
+    print(cat)
+
+
+def ask(question: str = "") -> str:
+    """The cat asks a question and returns the user's answer."""
+    say(question, mood="love")
+    return input("> ")
+
+
+if __name__ == "__main__":
+    print("=== say() ===\n")
+    say()
+    say("Meow!", mood="happy")
+    say("Zzz", mood="sleepy")
+    say("meow :(", mood="angry")
+    say("I love you!", mood="love")
+
+    print("\n=== warn() ===\n")
+    warn()
+    warn("Where's my food!")
+
+    print("\n=== error() ===\n")
+    error()
+    error("The cat has fallen!")
+
+    print("\n=== think() ===\n")
+    think()
+    think("Hmm", mood="happy")
+    think("Hmm", mood="sleepy")
+    think("Hmm", mood="angry")
+    think("Hmm", mood="love")
+
+    print("\n=== ask() ===\n")
+    ask()
+    ask("Where's my food?")

catsay_py-0.1.0/catsay_py.egg-info/PKG-INFO

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: catsay-py
+Version: 0.1.0
+Summary: A cute cat that says things in the terminal
+Author-email: FelineFantasy <mailsalavata5@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/FelineFantasy/catsay
+Project-URL: Repository, https://github.com/FelineFantasy/catsay
+Project-URL: Issues, https://github.com/FelineFantasy/catsay/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Terminals
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# catsay 🐱 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A cute ASCII cat library that says, warns, thinks, and asks questions. Perfect for making your CLI output more fun and expressive!
+
+## 📝 Description
+
+**catsay** is a tiny Python library that renders an ASCII cat with messages. It provides several functions for different use cases:
+
+- 🗣️ `say` — The cat says text with a given mood
+- ⚠️ `warn` — The cat outputs a warning
+- ❌ `error` — The cat shows an error message
+- 💭 `think` — The cat thinks thoughtfully
+- ❓ `ask` — The cat asks a question and returns the user's answer
+
+### Features:
+
+- 🎭 **4 moods** — happy, sleepy, angry, love
+- 📦 **Zero dependencies** — Pure Python, no extra packages
+- 🔌 **Simple API** — 5 functions for all use cases
+- 🎨 **ASCII art** — No external images or assets needed
+- 💬 **Interactive** — `ask()` reads user input
+
+## ⚙️ Installation
+
+### Option 1: Install from PyPI
+
+```bash
+pip install catsay-py
+```
+
+### Option 2: Copy the file
+
+Just copy `catsay.py` into your project:
+
+```bash
+# Place catsay.py in your project directory
+```
+
+### Option 3: Install from Git
+
+```bash
+git clone https://github.com/FelineFantasy/catsay
+cd catsay
+pip install .
+```
+
+## 🚀 Usage
+
+### Basic
+
+```python
+from catsay import say, warn, error, think, ask
+
+say("Hello, World!")
+warn("Don't forget to feed the cat!")
+error("Something went wrong!")
+think("Hmm, interesting...")
+answer = ask("What's your name?")
+print(f"User said: {answer}")
+```
+
+### Moods
+
+```python
+say("I'm happy!", mood="happy")
+say("Zzz...", mood="sleepy")
+say("I'm angry!", mood="angry")
+say("I love you!", mood="love")
+```
+
+### Without text
+
+```python
+say()  # Just a cute cat
+think()  # Thinking cat
+warn()  # Warning cat
+error()  # Error cat
+```
+
+## 📖 API Reference
+
+### `say(text: str = "", mood: str = "happy") -> None`
+
+The cat says text with a given mood.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to display |
+| `mood` | `str` | `"happy"` | Cat mood: `happy`, `sleepy`, `angry`, `love` |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+say("Meow!")
+#    /\_/\
+#   ( o.o )  >  Meow!
+#    > ^ <
+```
+
+---
+
+### `warn(text: str = "") -> None`
+
+The cat outputs a warning.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Warning message |
+
+**Example:**
+
+```python
+warn("Low disk space!")
+#    /\_/\
+#   ( -.o )  ~  Low disk space! ~~~
+#    > ^ <
+```
+
+---
+
+### `error(text: str = "Error") -> None`
+
+The cat outputs an error message (uses angry mood).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `"Error"` | Error message |
+
+**Example:**
+
+```python
+error("File not found!")
+#    /\_/\
+#   ( ò.ó )  >  !!! File not found! !!!
+#    > ^ <
+```
+
+---
+
+### `think(text: str = "", mood: str = "happy") -> None`
+
+The cat says text thoughtfully (with `<` bubble).
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `str` | `""` | Text to think about |
+| `mood` | `str` | `"happy"` | Cat mood |
+
+**Raises:** `ValueError` if mood is not supported
+
+**Example:**
+
+```python
+think("Hmm, interesting...")
+#    /\_/\
+#   ( o.o )  <  Hmm, interesting...
+#    > ^ <
+```
+
+---
+
+### `ask(question: str = "") -> str`
+
+The cat asks a question and returns the user's answer.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `question` | `str` | `""` | Question to ask |
+
+**Returns:** `str` — User's input
+
+**Example:**
+
+```python
+name = ask("What's your name?")
+print(f"Hello, {name}!")
+```
+
+## 🎭 Moods
+
+| Mood | Face | Description |
+|------|------|-------------|
+| `happy` | `o.o` | Default, friendly cat |
+| `sleepy` | `-.-` | Tired, drowsy cat |
+| `angry` | `ò.ó` | Angry, frustrated cat |
+| `love` | `^.^` | Loving, affectionate cat |
+
+## 🧪 Full Example
+
+```python
+from catsay import say, warn, error, think, ask
+
+print("=== say() ===\n")
+say()
+say("Meow!", mood="happy")
+say("Zzz", mood="sleepy")
+say("meow :(", mood="angry")
+say("I love you!", mood="love")
+
+print("\n=== warn() ===\n")
+warn()
+warn("Where's my food!")
+
+print("\n=== error() ===\n")
+error()
+error("The cat has fallen!")
+
+print("\n=== think() ===\n")
+think()
+think("Hmm", mood="happy")
+think("Hmm", mood="sleepy")
+think("Hmm", mood="angry")
+think("Hmm", mood="love")
+
+print("\n=== ask() ===\n")
+ask()
+ask("Where's my food?")
+```
+
+## 🧪 Testing
+
+Run the test suite with the standard library `unittest`:
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+Tests also run automatically on every push and pull request via GitHub Actions.
+
+## 📁 Project Structure
+
+```text
+catsay/
+├── .github/
+│   ├── FUNDING.yml           # Support link for DonationAlerts
+│   └── workflows/
+│       └── tests.yml         # CI workflow for running tests
+├── catsay.py                 # Main library
+├── README.md                 # Documentation
+├── LICENSE                   # MIT License
+├── pyproject.toml            # Package configuration
+├── tests/
+│   └── test_catsay.py        # Unit tests
+└── .gitignore                # Git ignore rules
+```
+
+## 🛠 Technologies
+
+- **Python 3.8+** — Pure standard library, no external dependencies
+
+## 📋 Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## 💖 Support the Project
+
+If you enjoy **catsay** and want to help keep the project alive, you can support me here:
+
+[![DonationAlerts](https://img.shields.io/badge/DonationAlerts-Support-blue.svg)](https://www.donationalerts.com/r/felinefantasy)
+
+Your support helps me:
+- 🐱 Keep developing cute tools
+- 🛠️ Add more moods and features
+- ☕ Stay awake while coding at 4 AM
+
+Every little bit is appreciated! ❤️
+
+## 👤 Author
+- **FelineFantasy**
+- **License**: MIT

catsay_py-0.1.0/catsay_py.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+catsay.py
+pyproject.toml
+catsay_py.egg-info/PKG-INFO
+catsay_py.egg-info/SOURCES.txt
+catsay_py.egg-info/dependency_links.txt
+catsay_py.egg-info/top_level.txt
+tests/test_catsay.py

catsay_py-0.1.0/catsay_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

catsay_py-0.1.0/catsay_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+catsay

catsay_py-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "catsay-py"
+version = "0.1.0"
+description = "A cute cat that says things in the terminal"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "FelineFantasy", email = "mailsalavata5@gmail.com"}]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Terminals",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/FelineFantasy/catsay"
+Repository = "https://github.com/FelineFantasy/catsay"
+Issues = "https://github.com/FelineFantasy/catsay/issues"
+
+[tool.setuptools]
+py-modules = ["catsay"]

catsay_py-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

catsay_py-0.1.0/tests/test_catsay.py

@@ -0,0 +1,84 @@
+import io
+import unittest
+from contextlib import redirect_stdout
+from unittest.mock import patch
+
+import catsay
+
+
+def capture(func, *args, **kwargs):
+    output = io.StringIO()
+    with redirect_stdout(output):
+        func(*args, **kwargs)
+    return output.getvalue()
+
+
+class CatSayTests(unittest.TestCase):
+    def test_default_cat(self):
+        self.assertEqual(capture(catsay.say), "   /\\_/\\\n  ( o.o )\n   > ^ <\n")
+
+    def test_text_and_mood(self):
+        self.assertEqual(
+            capture(catsay.say, "Meow!", mood="sleepy"),
+            "   /\\_/\\\n  ( -.- )  >  Meow!\n   > ^ <\n",
+        )
+
+    def test_all_moods_render_their_face(self):
+        for mood, face in catsay.FACES.items():
+            self.assertIn(f"( {face} )", capture(catsay.say, "hi", mood=mood))
+
+    def test_unknown_mood_raises(self):
+        with self.assertRaises(ValueError):
+            capture(catsay.say, "hi", mood="grumpy")
+
+
+class CatWarnTests(unittest.TestCase):
+    def test_empty_warning(self):
+        self.assertEqual(capture(catsay.warn), "   /\\_/\\\n  ( -.o )  ~   ~~~\n   > ^ <\n")
+
+    def test_warning_with_text(self):
+        self.assertEqual(
+            capture(catsay.warn, "Low disk space!"),
+            "   /\\_/\\\n  ( -.o )  ~  Low disk space! ~~~\n   > ^ <\n",
+        )
+
+
+class CatErrorTests(unittest.TestCase):
+    def test_default_error(self):
+        self.assertEqual(
+            capture(catsay.error),
+            "   /\\_/\\\n  ( ò.ó )  >  !!! Error !!!\n   > ^ <\n",
+        )
+
+    def test_custom_error(self):
+        self.assertIn("!!! File not found! !!!", capture(catsay.error, "File not found!"))
+
+
+class CatThinkTests(unittest.TestCase):
+    def test_empty_thought_has_no_ellipsis(self):
+        self.assertEqual(capture(catsay.think), "   /\\_/\\\n  ( o.o )  <\n   > ^ <\n")
+
+    def test_thought_with_text(self):
+        self.assertEqual(
+            capture(catsay.think, "Hmm", mood="love"),
+            "   /\\_/\\\n  ( ^.^ )  <  Hmm...\n   > ^ <\n",
+        )
+
+    def test_unknown_mood_raises(self):
+        with self.assertRaises(ValueError):
+            capture(catsay.think, "Hmm", mood="grumpy")
+
+
+class CatAskTests(unittest.TestCase):
+    def test_returns_user_answer(self):
+        output = io.StringIO()
+        with patch("builtins.input", return_value="fish") as mock_input:
+            with redirect_stdout(output):
+                answer = catsay.ask("What's for dinner?")
+        self.assertEqual(answer, "fish")
+        self.assertIn("What's for dinner?", output.getvalue())
+        mock_input.assert_called_once_with("> ")
+
+
+if __name__ == "__main__":
+    unittest.main()