Library with functions for basic Discord/Telegram bot development
Go to file
Profitroll bfcb067ba5
All checks were successful
Analysis / SonarCloud (push) Successful in 39s
Tests / Build and Test (3.11) (push) Successful in 1m18s
Tests / Build and Test (3.12) (push) Successful in 1m35s
Tests / Build and Test (3.13) (push) Successful in 1m21s
Merge pull request 'v4.0.1' (#170) from dev into main
Reviewed-on: #170
2024-12-29 17:18:48 +02:00
.gitea/workflows Tests are now for 3.11+ 2024-12-27 18:33:51 +01:00
examples Separated examples for Pyrogram and Pycord 2024-05-19 14:48:16 +02:00
requirements Added typing_extensions to the dependencies 2024-12-29 16:06:45 +01:00
src/libbot Added typing_extensions to the dependencies 2024-12-29 16:06:45 +01:00
tests Removed legacy usage of Union[] 2024-12-26 18:36:57 +01:00
.gitignore Added nested_delete and config_delete 2024-05-26 15:40:29 +02:00
.renovaterc Renovate's main branch is now "dev" 2023-12-10 11:58:21 +01:00
LICENSE Initial commit 2023-05-11 20:52:10 +03:00
pyproject.toml WIP: Overhaul for 4.0.0 2024-12-18 14:16:37 +01:00
README.md Slight documentation improvements 2024-12-27 00:37:54 +01:00
sonar-project.properties Add sonar-project.properties 2024-10-29 17:38:41 +02:00
tox.ini WIP: Overhaul for 4.0.0 2024-12-18 14:16:37 +01:00

LibBotUniversal

PyPI - License Gitea Release PyPI - Python Version Code style: black

Handy library for Telegram/Discord bots development.

Getting started

There are different sub-packages available:

  • pyrogram - Telegram bots with Pyrogram's fork "Pyrofork"
  • pycord - Discord bots with Pycord
  • speed - Performance improvements
  • dev - Dependencies for package development purposes

You can freely choose any sub-package you want, as well as add multiple (comma-separated) or none at all.

# Only general features
pip install libbot

# Only with Pyrogram
pip install libbot[pyrogram]

# With Pycord and Performance improvements
pip install libbot[pycord,speed]

Examples

Pyrogram

from libbot.pyrogram.classes import PyroClient


def main():
    client: PyroClient = PyroClient()

    try:
        client.run()
    except KeyboardInterrupt:
        print("Shutting down...")
    finally:
        exit()


if __name__ == "__main__":
    main()

Pycord

from discord import Intents
from libbot.utils import config_get
from libbot.pycord.classes import PycordBot


async def main():
    intents: Intents = Intents.default()
    bot: PycordBot = PycordBot(intents=intents)

    bot.load_extension("cogs")

    try:
        await bot.start(config_get("bot_token", "bot"))
    except KeyboardInterrupt:
        print("Shutting down...")
        await bot.close()


if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Config examples

For bot config examples please check the examples directory. Without a valid config file, the bot won't start at all, so you need to make sure the correct config file is used.