Metadata-Version: 2.4
Name: botgate-stats-reporter-py
Version: 1.0.0
Summary: Official BotGate module for reporting Discord bot stats automatically
Author-email: BotGate Team <botgateoficial@gmail.com>
License: MIT
Project-URL: Homepage, https://docs-botgate.vercel.app/
Project-URL: Issues, https://github.com/nathan-lucca/botgate-stats-reporter-py/issues
Keywords: discord,bot,botgate,stats,statistics
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: discord.py>=2.3.0

# @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

```bash
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)

```python
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](https://docs-botgate.vercel.app/)
- [Painel do Desenvolvedor](https://botgate-site.vercel.app/settings)
- [Suporte no Discord](https://www.discord.gg/xK4r9HqKKf)

## 📄 Licença

Distribuído sob a licença MIT.
