aptabase-python

Aptabase Python SDKは、モバイル、デスクトップ、Webアプリケーションをサポートするオープンソースのプライバシー優先アナリティクスプラットフォームであるAptabaseの公式クライアントライブラリです。 主な特徴： - `httpx`と`asyncio`に基づく完全非同期実装 - プライバシーファースト設計で個人データ収集なし - Python 3.11以降が必要 - 自動イベントバッチ処理と定期的なフラッシュ - 最小限の依存関係 使用パターン： Aptabaseアプリキー（リージョンコード付き：`A-EU-*`が欧州サーバー、`A-US-*`が米国サーバー）でクライアントを初期化し、オプションのプロパティ付きでイベントを追跡します。イベントはキューに積まれて自動的にフラッシュされますが、手動での強制フラッシュも可能です。SDKはコンテキストマネージャーによる自動ライフサイクル管理と、明示的なstart/stop制御の両方に対応しています。 設定オプションには、アプリバージョン、デバッグモード、最大バッチサイズ（最大25イベント）、フラッシュ間隔、HTTPタイムアウトが含まれます。 エラーハンドリングでは、ネットワーク問題用（`NetworkError`）と一般的なAptabaseエラー用（`AptabaseError`）の個別例外が提供されます。 開発環境は`uv sync --dev`で構築し、テストは`pytest`、リンティングは`ruff`、型チェックは`mypy`で行います。