Metadata-Version: 2.1
Name: capncord.py
Version: 0.2.1
Summary: A wrapper for the Capncord API.
Home-page: https://github.com/LyricLy/capncord.py
Author: LyricLy
Author-email: gulliverhanson@gmail.com
License: CC0
Keywords: wrapper,capncord,capncord.py
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Requires-Dist: aiohttp
Requires-Dist: websockets

# capncord.py

capncord.py is an API wrapper for Discord written in Python.

## Installing

To install the library, run the following command:

```
pip install capncord.py
```

Depending on your environment, the command may be slightly different. If you're having trouble installing the library, familiarize yourself with how `pip` works on your platform first.

## Tutorial

To create a bot, subclass `capncord.Bot` and overload `on_ready` and `on_message`.

### Bot

The Bot class supports the methods `async def wait_for(event: str, check: Optional[function] = None, timeout: Optional[int] = None`, `async def get_message(id: int) -> Message`, `async def history() -> List[Message]` and `async def get_channel(id: int) -> Channel`.

`history()` returns a list of messages sent in all channels with the most recent messages at the start of the list.

It also has the attributes `loop: asyncio.BaseEventLoop`, `session: aiohttp.ClientSession` and `user: User`.

### Message

The Message class has the attributes `id: int`, `created_at: datetime.datetime`, `content: str`, `author: User` and `channel: Channel`.

### Channel

The Channel class supports the methods `async def send(content: str)` and `async def history() -> List[Message]`.

`history()` returns a list of messages sent in this channel with the most recent messages at the start of the list.

It also has the attribute `id`.

### User

The User class supports `str`.

It also has the attributes `await User.name` and `await User.messages_sent`.

## Requirements

* Python 3.5.3+
* ``aiohttp`` library
* ``websockets`` library

Usually ``pip`` will handle these for you.


