Middleware-based event processing library for Discord. Uses discord.py under the hood.
Concord is not a library for accessing Discord API. If you're here for an API library, see discord.py or disco, or Discord Developer Documentation page with a list of libraries for different languages.
The library aims to provide a more convenience way to handle Discord gateway
events, with code reusing where it's possible, including separating
functionality into extensions.
Event processing is done using the programmer-defined handlers tree. Like in web
applications, due to similarity of the concepts of processing requests, Concord
calls these handlers as middleware as well.
Concord doesn't try to be either a fast or a slow library. For it's customization ability, it had to pay the speed.
Hugo - example bot, built on the Concord.
Take a note, that there's no so much code. It just registers extensions -
third-party middleware sets.
Actually, Concord - is a successor of Hugo. You can figure this out by the code
history.
Example extensions: concord-ext-audio, concord-ext-player, concord-ext-stats.
Concord uses Poetry for it's dependency management. You can add Concord to your project using Poetry:
poetry add cncrd
Poetry will handle the rest for you.
Take a note, that cncrd
has no vowels. Concord's and extensions' distribution
name iscncrd
.
Concord is hosted on PyPI and can be installed via other package managers:
pip install cncrd
Concord has a specific requirement - rewrite
branch of
discord.py that is handled by Poetry,
but not by other package managers. Take care of installing it too:
pip install -U https://github.com/Rapptz/discord.py/archive/rewrite.zip#egg=discord.py
Concord's development version is located in the dev
branch, and, in most
cases, it's a pretty stable to use in case you're a bot developer.
poetry add cncrd --git https://github.com/narimanizett/concord
I'm really sorry, but there's no online documentation yet.
But. Concord is a small library, the code is well documented, and, with a
mentioned examples, you can quickly understand everything. Feel free to open an
issue on GitHub, if you need some help.
MIT.
See LICENSE file for more information.