# ritori 🐱

> A collection of fun Python utilities by Ritori

[![PyPI version](https://badge.fury.io/py/ritori.svg)](https://pypi.org/project/ritori/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Installation

```bash
pip install ritori
```

## Modules

### 🐱 ritori.meow

Add "meow" to everything, because everything is better with cats!

```python
from ritori import meow

# Basic usage
print(meow.meow("Hello"))
# Output: Hello，喵～

# Different styles
print(meow.meow("Good morning", style="cute"))
# Output: Good morning，(=^･ω･^=) 喵～

print(meow.meow("Good night", style="sleepy"))
# Output: Good night，(=^-ω-^=) 喵...

# Random style
print(meow.random_meow("Surprise"))
# Output: Surprise，(random cat kaomoji) 喵～

# Meowify entire text
print(meow.meowify("Hello. How are you?", every_sentence=True))
# Output: Hello，喵～. How are you，喵～?
```

#### Available Styles

| Style | Output |
|-------|--------|
| `default` | 喵～ |
| `cute` | (=^･ω･^=) 喵～ |
| `happy` | (^･ω･^) 喵～ |
| `sleepy` | (=^-ω-^=) 喵... |
| `excited` | ヾ(=^▽^=)ノ 喵喵喵！ |
| `shy` | (⁄ ⁄•⁄ω⁄•⁄ ⁄) 喵... |
| `curious` | (=ↀωↀ=) 喵？ |
| `love` | (´,,•ω•,,)♡ 喵～ |

## API Reference

### ritori.meow

- `meow(text, style="default", separator="，")` - Add a cat sound to the end of a string
- `meowify(text, every_sentence=False)` - Add meow to text, optionally after every sentence
- `random_meow(text)` - Add a random style of meow
- `get_styles()` - Get all available meow styles

## Roadmap

More fun modules coming soon! 🚀

## Why?

Because sometimes code needs to be a little more fun 🐱

## License

MIT License - feel free to meow everywhere!

---

Made with 💜 by Ritori
