عن المشروع

تُعد حزمة Aptabase Python SDK المكتبة الرسمية لـ Aptabase، وهي منصة تحليلات مفتوحة المصدر تراعي الخصوصية وتدعم تطبيقات الهاتف المحمول والحاسوب والتطبيقات الويب. الخصائص الرئيسية: - تنفيذ متزامن بالكامل مبني على `httpx` و `asyncio` - تصميم يركز على الخصوصية دون جمع بيانات شخصية - يتطلب Python 3.11 أو إصدار أحدث - تجميع تلقائي للحدث ودفع دوري للبيانات - أثر اعتماديات دنيا نمط الاستخدام: تهيئة العميل باستخدام مفتاح تطبيقك على Aptabase (بصيغة ترميز المنطقة: `A-EU-*` للخوادم الأوروبية، `A-US-*` لخوادم الولايات المتحدة)، ثم تتبع الأحداث مع خصائص اختيارية. يتم وضع الأحداث في طابور وعرضها تلقائياً، ولكن يمكن أيضاً فرض العرض يدوياً. تدعم الحزمة استخدام سياق مدير (context manager) للإدارة التلقائية لدورة الحياة، فضلاً عن التحكم الصريح في البدء/الإيقاف. تشمل خيارات التكوين إصدار التطبيق، ووضع التصحيح (debug mode)، وأقصى حجم دفعة (حتى 25 حدثاً)، وفاصل الزمنية للعرض، ووقت انتظار HTTP. يقدم التعامل مع الأخطاء استثناءات مميزة لمشاكل الشبكة (`NetworkError`) والأخطاء العامة الخاصة بـ Aptabase (`AptabaseError`). يتم إعداد التطوير عبر الأمر `uv sync --dev`، مع الاختبارات بواسطة `pytest`، ومراجعة التعليمات البرمجية عبر `ruff`، وفحص الأنواع باستخدام `mypy`.