Skip to main content

An easy-to-use extension for Discord.py and Pycord

Project description

littxlecord

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

✨ Error handling

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

⚙️ 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 littxlecord

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/littxle/littxlecord

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

littxlecord @ git+https://github.com/littxle/littxlecord

Useful Links

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. littxlecord can automatically load the token if a TOKEN variable is present in the .env file.

Pycord

import littxlecord
import discord

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

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

Discord.py

import asyncio
import discord
import littxlecord


class Bot(littxlecord.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

I am always happy to receive contributions. Here is how to do it:

  1. Fork this repository
  2. Make changes
  3. Create a pull request

You can also create an issue if you find any bugs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

littxlecord-0.2.1.tar.gz (43.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

littxlecord-0.2.1-py3-none-any.whl (49.5 kB view details)

Uploaded Python 3

File details

Details for the file littxlecord-0.2.1.tar.gz.

File metadata

  • Download URL: littxlecord-0.2.1.tar.gz
  • Upload date:
  • Size: 43.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for littxlecord-0.2.1.tar.gz
Algorithm Hash digest
SHA256 af10c887101874598c3816397abe6b0a826a8dc3db8bb663b94f0b47778cba29
MD5 c32ecf6520e5891f01d0aefc16cdd194
BLAKE2b-256 55149e103c3a5762efc80db0c05102050fac6f9fbecd512c8633924761dff9b7

See more details on using hashes here.

File details

Details for the file littxlecord-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: littxlecord-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 49.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for littxlecord-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 81930a03356d7c5850ddb4e06f62fe4de5ee447be5a0512a08bf3efe99b5b403
MD5 5aae7e24e179498e498995244a0aeb05
BLAKE2b-256 4c2d0078cdb5e45d06a906147d98fe79fb6767892b46aedc6a82de0d6ca09eb0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page