Об этом проекте
Aptabase Python SDK — это официальная клиентская библиотека для Aptabase, платформы аналитики с открытым исходным кодом, ориентированной на конфиденциальность и поддерживающей мобильные, десктопные и веб-приложения.
Ключевые особенности:
- Полностью асинхронная реализация, построенная на `httpx` и `asyncio`
- Дизайн с приоритетом конфиденциальности без сбора персональных данных
- Требуется Python 3.11 или новее
- Автоматическая батчинг событий и периодическая отправка
- Минимальное количество зависимостей
Пример использования:
Инициализируйте клиент, передав ключ приложения Aptabase (региональный код: `A-EU-*` для европейских серверов, `A-US-*` для серверов в США), затем отслеживайте события с необязательными свойствами. События помещаются в очередь и автоматически отправляются, но также доступна ручная принудительная отправка. SDK поддерживает использование контекстного менеджера для автоматического управления жизненным циклом, а также явное управление через методы start/stop.
Параметры конфигурации включают версию приложения, режим отладки, максимальный размер батча (до 25 событий), интервал отправки и HTTP timeout.
Обработка ошибок предусматривает отдельные исключения для сетевых проблем (`NetworkError`) и общих ошибок Aptabase (`AptabaseError`).
Для разработки используйте `uv sync --dev`, запуск тестов — через `pytest`, линтинг — через `ruff`, проверку типов — через `mypy`.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.