这个项目能做什么

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` 进行类型检查。