Metadata-Version: 2.1
Name: kasushi
Version: 0.1.1
Summary: Building blocks and utility extensions for discord.py bots
Home-page: https://github.com/paris-ci/kasushi
Author: paris-ci
Author-email: site-pipy@api-d.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/paris-ci/kasushi/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

[![Python versions](https://img.shields.io/pypi/pyversions/kasushi.svg)](https://pypi.python.org/pypi/kasushi)
[![License](https://img.shields.io/pypi/l/kasushi.svg)](https://github.com/paris-ci/kasushi/blob/master/LICENSE)
[![Status](https://img.shields.io/pypi/status/kasushi.svg)](https://pypi.python.org/pypi/kasushi)
[![Issues](https://img.shields.io/github/issues/paris-ci/kasushi.svg?colorB=3333ff)](https://github.com/paris-ci/kasushi/issues)
[![Commit activity](https://img.shields.io/github/commit-activity/w/paris-ci/kasushi.svg)](https://github.com/paris-ci/kasushi/commits)

***

<h1 align="center">
Kasushi
</h1>
<p align="center">
<sup>
Building blocks and utility extensions for discord.py bots
</sup>
<br>
</p>

***

Kasushi is an extension of the [discord.py](https://github.com/Rapptz/discord.py) library. It provides a number of
useful features for bots, such as cache, IPC, tortoise models and more.

It is really easy to use, and requires a minimum amount of configuration.

> 1. Download kasushi on the command line using pip:
> ```bash
> pip install -U kasushi
> ```
> 2. Configure the extensions:
> ```python
> import kasushi
> # See below for settings you can pass to configure.
> await kasushi.configure(bot, {}) 
> ```
> 3. Load the extensions in your bot code before it runs:
> ```python
> await bot.load_extension('kasushi.cache')
> ```
> You're done!

## Modules and settings

Many modules are available in kasushi. You should load them in your bot, and pass settings to configure.

Depending on the module(s) you want to use, you can pass different settings to configure.

### Cache

The cache module allows for connecting to a [memcached](https://memcached.org/) server. It can be used to store cached
data between reboots of the bot, like cooldowns and user data.

#### Usage

Once installed and loaded, the cache class is made available in `bot.cache`.

```python
await bot.cache.set("coins", 0)
await bot.cache.set("coins", 10)
await bot.cache.get("coins")  # 10
await bot.cache.delete("coins")
await bot.cache.get("coins", default=5)  # 5
```

#### Configuration example

You can pass the following dictionary to configure:

```python
{
    "cache": {
        "server_ip": "127.0.0.1",
        "server_port": 11211,
    }
}
```

### IPC

IPC stands for Inter-Process Communication. It allows for sending messages between processes, or, in our case, different
processes for the same bot.

The process hosting the first shard (shard 0) will be the "master process". It'll host the webserver allowing other
processes to connect to it.

It'll also pass messages to the other bots if needed.

#### Usage

Once installed and loaded, the IPC class is made available in `bot.ipc`. All bots need to be able to access the first
shard's IPC server.

#### Configuration example

```python
{
    "ipc": {
        "shared_secret": "secret",  # This is used to authenticate with the IPC server.
        "server": {
            "host": "0.0.0.0",
            "port": 12321,
        },
        "client": {
            "server_url": "http://127.0.0.1:12321",
        },
        "handlers": [GuildInfoHandler]  # See above for handlers.
    },
}
```

