Metadata-Version: 2.1
Name: discord-ext-alternatives
Version: 2020.5.20
Summary: Enable some experimental features for discord.py.
Home-page: https://github.com/NCPlayz/discord-ext-alternatives
Author: NCPlayz
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: discord.py (>=1.3.0)

# discord-ext-alternatives
Enable some experimental features for [discord.py](https://github.com/Rapptz/discord.py/).

> ⚠️ **This is experimental and should be used with caution.**
> If you encounter any issues with this extension, please make an issue.

## Installation

This extension is on [PyPI](https://pypi.org/project/discord-ext-alternatives/).

```sh
$ python3 -m pip install -U discord-ext-alternatives
```

## Usage

```py
from discord.ext.alternatives import asset_converter, message_eq
# Patches the related features into discord.py
# OR
from discord.ext.alternatives.class_commands import ClassGroup, Config
```

## Available Experiments

- `asset_converter` - Implements a converter for ``Asset``.
- `bot_send_help` - Implements `Bot.send_help`.
- `guild_converter` - Implements a converter for ``Guild``.
- `int_map` - Implements `__int__` to return `.id`.
- `message_eq` - Implements `Message.__eq__` (`Message == Message`).
- `silent_delete` - Implements a `silent` keyword argument for `Message.delete`.
- `specific_error_handler` - Implements `@Command.error(Exception)`.
- `subcommand_error` - Implements `root_parent` error handling.
- `webhook_channel` - Implements `Webhook.move_to`.

#### Standalone
- `class_command` - Implements a way to use classes and functions as commands.

## Changelog

### 2020.05.20

- Fixed bug with `silent_delete`.
- Added `guild_converter`.
- Added `class_commands`.

### 2020.05.12

- Added `silent_delete`
- `int_map` no longer errors on `Invite.__int__`
- `specific_error_handler` now works in cogs, and walks `__mro__` to check exceptions.
- `subcommand_error` no longer errors in Cog exception propagation.

### 2020.05.10

- Added `int_map`
- Added `specific_error_handler`
- `message_eq` checks for a ``Message`` instance

### 2020.05.09

- Added `asset_converter`
- Added `bot_send_help`
- Added `message_eq`
- Added `subcommand_error`
- Added `webhook_channel`


