Sobre o projeto
O SDK Python do Aptabase é a biblioteca cliente oficial do Aptabase, uma plataforma de análise open-source e privacy-first que oferece suporte a aplicativos mobile, desktop e web.
Principais características:
- Implementação totalmente assíncrona, baseada em `httpx` e `asyncio`
- Design privacy-first sem coleta de dados pessoais
- Requer Python 3.11 ou posterior
- Agrupamento automático de eventos e flushing periódico
- Pegada mínima de dependências
Padrão de uso:
Inicialize o cliente com sua chave de aplicativo Aptabase (com regionalização: `A-EU-*` para servidores europeus, `A-US-*` para servidores dos EUA) e acompanhe eventos com propriedades opcionais. Os eventos são enfileirados e flushados automaticamente, mas também podem ser forçados manualmente. O SDK suporta uso como context manager para gerenciamento automático do ciclo de vida, além de controle explícito de start/stop.
As opções de configuração incluem versão do app, modo debug, tamanho máximo do batch (até 25 eventos), intervalo de flush e timeout HTTP.
O tratamento de erros oferece exceções distintas para problemas de rede (`NetworkError`) e erros gerais do Aptabase (`AptabaseError`).
O setup de desenvolvimento usa `uv sync --dev`, com testes via `pytest`, linting via `ruff` e verificação de tipos via `mypy`.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.