这个项目能做什么
Aptabase Python SDK 是 Aptabase 的官方客户端库。Aptabase 是一个开源的、以隐私为先的分析平台,支持移动、桌面和 Web 应用程序。
主要特点:
- 基于 `httpx` 和 `asyncio` 的全异步实现
- 隐私优先设计,不收集任何个人数据
- 需要 Python 3.11 或更高版本
- 自动事件批处理和定期刷新
- 极少的依赖项
使用方式:
使用 Aptabase 应用密钥(区域编码:`A-EU-*` 用于欧洲服务器,`A-US-*` 用于美国服务器)初始化客户端,然后跟踪带有可选属性的事件。事件会自动排队并刷新,也可手动强制刷新。SDK 支持上下文管理器用法以实现自动生命周期管理,以及显式的 start/stop 控制。
配置选项包括应用版本、调试模式、最大批量大小(最多 25 个事件)、刷新间隔和 HTTP 超时时间。
错误处理提供了针对网络问题(`NetworkError`)和一般 Aptabase 错误(`AptabaseError`)的独立异常。
开发环境使用 `uv sync --dev` 设置,通过 `pytest` 运行测试,通过 `ruff` 进行代码检查,通过 `mypy` 进行类型检查。
评论
0 评分人数达到10人后显示
登录后参与讨论。