An easy-to-use extension for Discord.py and Pycord with some utility functions.

Features

✏️ Reduce boilerplate code

• Easy cog management
• Embed templates
• Datetime and file utilities
• Wrapper for aiosqlite and asyncpg

✨ Error handling

• Automatic error handling for slash commands
• Error webhook reports
• Custom logging

📚 i18n

• Slash command translation (groups, options, choices)
• Translate messages, embeds, views, modals and more

⚙️ Extensions

• Help command - Automatically generate a help command for your bot
• Status changer - Change the bot's status in an interval
• Blacklist - Block users from using your bot

Installing

Python 3.9 or higher is required.

pip install ezcord

You can also install the latest version from GitHub. Note that this version may be unstable and requires git to be installed.

pip install git+https://github.com/tibue99/ezcord

If you need the latest version in your requirements.txt file, you can add this line:

ezcord @ git+https://github.com/tibue99/ezcord

For further steps, see the documentation.

Plugins

Ezcord Utils

These code editor plugins simplify working with language files. They offer autocompletion, hover translations, and quick access to keys in language files.

• PyCharm: JetBrains Marketplace | GitHub
• VS Code: Marketplace | GitHub

Bot Formatter

Bot Formatter is an Ezcord language file formatter and validator, available as a CLI tool and as a pre-commit hook.

Examples

For more examples, see the example repository or the sample code.

• Note: It's recommended to load the token from a .env file instead of hardcoding it. EzCord can automatically load the token if a TOKEN variable is present in the .env file.

Pycord

Refer to the Pycord Documentation for more information.

import ezcord
import discord

bot = ezcord.Bot(
    intents=discord.Intents.default()
)

if __name__ == "__main__":
    bot.load_cogs("cogs")  # Load all cogs in the "cogs" folder
    bot.run("TOKEN")

Discord.py

Refer to the Discord.py Documentation for more information.

import asyncio
import discord
import ezcord


class Bot(ezcord.Bot):
    def __init__(self):
        super().__init__(intents=discord.Intents.default())

    async def setup_hook(self):
        await super().setup_hook()
        await self.tree.sync()


async def main():
    async with Bot() as bot:
        bot.add_help_command()
        bot.load_cogs("cogs")  # Load all cogs in the "cogs" folder
        await bot.start("TOKEN")


if __name__ == "__main__":
    asyncio.run(main())

Contributing

You are welcome to contribute to this repository! Please refer to the full contribution guide.