botgate-stats-reporter-py 1.0.0

Official BotGate module for reporting Discord bot stats automatically

@botgate/botgate-stats-reporter-py

O módulo oficial do BotGate para desenvolvedores de bots Discord em Python. Automatize o envio de estatísticas para a plataforma de forma simples e eficiente.

📦 Instalação

pip install botgate-stats-reporter

🚀 Como usar

A biblioteca foi projetada para ser integrada facilmente ao discord.py. Ela gerencia automaticamente o intervalo de postagem com base no plano (Tier) do seu bot.

Exemplo Básico (discord.py)

import discord
from discord.ext import commands
from botgate_reporter import BotGateReporter

class MyBot(commands.Bot):
    def __init__(self):
        super().__init__(command_prefix="!", intents=discord.Intents.default())

        # Inicializa o Reporter
        self.reporter = BotGateReporter(
            bot_id="SEU_BOT_ID",
            api_key="SUA_API_KEY",
            lang="pt-BR",
            debug=True
        )

    async def setup_hook(self):
        # Inicia o loop automático
        self.reporter.start(self)

bot = MyBot()
bot.run("TOKEN_DO_DISCORD")

⚙️ Configuração

O BotGateReporter aceita as seguintes opções:

Propriedade	Tipo	Padrão	Descrição
bot_id	string	Obrigatório	O ID do seu bot no Discord.
api_key	string	Obrigatório	Sua API Key obtida no painel do BotGate.
lang	string	"pt-BR"	Idioma dos logs e erros (pt-BR ou en-US).
debug	boolean	False	Ativa logs detalhados no console para depuração.

🛠️ Métodos

• start(client): Inicia o serviço integrado ao bot.
• stop(): Interrompe os envios.
• post_stats(): Força um envio manual imediato.

🔗 Links Úteis

• Documentação Oficial
• Painel do Desenvolvedor
• Suporte no Discord

📄 Licença

Distribuído sob a licença MIT.