Metadata-Version: 2.4
Name: sopel-quotes
Version: 2.0.0
Summary: A Sopel IRC bot plugin for handling user added quotes
Author-email: Rusty Bower <rusty@rustybower.com>
Maintainer-email: Rusty Bower <rusty@rustybower.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/RustyBower/sopel-quotes
Project-URL: Bug Tracker, https://github.com/RustyBower/sopel-quotes/issues
Keywords: sopel,plugin,bot,irc,quotes
Platform: Linux x86, x86-64
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX :: Linux
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: Topic :: Communications :: Chat :: Internet Relay Chat
Requires-Python: <4,>=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pymysql
Requires-Dist: sopel>=8
Requires-Dist: sqlalchemy
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: license-file

# sopel-quotes

A Sopel IRC bot plugin for handling user added quotes with MySQL storage.

> **Note:** This package was previously published as `sopel-modules.quotes`.
> Please update your dependencies to use `sopel-quotes` instead.

## Installation

```bash
pip install sopel-quotes
```

### System Requirements

```bash
# Debian/Ubuntu
apt-get install libmysqlclient-dev
```

## Configuration

```ini
[quotes]
db_host = localhost
db_user = quotes
db_pass = your_password
db_name = quotes
```

## Usage

### Adding a Quote

```
.quote <key> = <value>
.quoteadd <key> = <value>
```

### Retrieving a Quote

```
.quote           # Random quote
.quote <key>     # Specific quote
```

### Searching Quotes

```
.match <pattern>  # Search for keys matching pattern
```

### Deleting a Quote

```
.quotedel <key>
.quotedelete <key>
```

## Requirements

- Sopel 8.0+
- Python 3.8+
- MySQL/MariaDB database

## License

MIT License
