aptabase-python

Aptabase Python SDK는 Aptabase의 공식 클라이언트 라이브러리로, 모바일, 데스크톱, 웹 애플리케이션을 지원하는 오픈소스 프라이버시 우선 분석 플랫폼입니다. 주요 특징: - `httpx`와 `asyncio` 기반의 완전한 비동기 구현 - 개인정보 수집 없는 프라이버시 우선 설계 - Python 3.11 이상 필요 - 자동 이벤트 배치 및 주기적 플러싱 - 최소한의 의존성 footprint 사용 패턴: Aptabase 앱 키(영역 코드: 유럽 서버용 `A-EU-*`, 미국 서버용 `A-US-*`)로 클라이언트를 초기화한 후 선택적 속성과 함께 이벤트를 추적합니다. 이벤트는 자동으로 큐에 쌓이고 플러싱되지만, 수동으로 강제 플러싱할 수도 있습니다. SDK는 컨텍스트 매니저 사용을 통한 자동 라이프사이클 관리와 명시적인 start/stop 제어를 모두 지원합니다. 구성 옵션에는 앱 버전, 디버그 모드, 최대 배치 크기(최대 25개 이벤트), 플러시 간격, HTTP 타임아웃이 포함됩니다. 에러 처리는 네트워크 문제(`NetworkError`)와 일반적인 Aptabase 에러(`AptabaseError`)를 구분하는 개별 예외를 제공합니다. 개발 환경 설정은 `uv sync --dev`로 진행하며, 테스트는 `pytest`, 린팅은 `ruff`, 타입 체크는 `mypy`를 사용합니다.