প্রকল্প সম্পর্কে

অ্যাপ্টাবেস পাইথন এসডিএক্স হলো অ্যাপ্টাবেস-এর জন্য অফিশিয়াল ক্লায়েন্ট লাইব্রেরি; যা একটি চলমান মুক্ত, প্রাইভেসি-ফার্স্ট অ্যানালিটিক্স প্ল্যাটফর্ম যা মোবাইল, ডেস্কটপ এবং ওয়েব অ্যাপ্লিকেশনকে সমর্থন করে। মূল বৈশিষ্ট্য: - `httpx` এবং `asyncio`-এর উপর ভিত্তি করে সম্পূর্ণ অ্যাসিঙ্ক ইমপ্লিমেন্টেশন - প্রাইভেসি-ফার্স্ট ডিজাইন; কোনো ব্যক্তিগত তথ্য সংগ্রহ নেই - পাইথন ৩.১১ অথবা তার পরবর্তী সংস্করণ প্রয়োজন - স্বয়ংক্রিয় ইভেন্ট ব্যাচিং এবং পর্যায়ক্রমে ফ্লশিং - ন্যূনতম নির্ভরতার ভাঁড়ার ব্যবহার প্যাটার্ন: ক্লায়েন্টটি আপনার অ্যাপ্টাবেস অ্যাপ কী দিয়ে ইনিশিয়ালাইজ করুন (অঞ্চল-কোডযুক্ত: ইউরোপীয় সার্ভারের জন্য `A-EU-*`, মার্কিন সার্ভারের জন্য `A-US-*`), এরপর ওয়ান-প্রোপার্টি সহ ইভেন্ট ট্র্যাক করুন। ইভেন্টগুলো কোয়্যুতে থাকে এবং স্বয়ংক্রিয়ভাবে ফ্ল্যাশ হয়, তবে ম্যানুয়ালি ফোর্স-ফ্ল্যাশও করা যায়। এসডিএক্স স্বয়ংক্রিয় লাইফসাইকেল ম্যানেজমেন্টের জন্য কনটেক্সট ম্যানেজার ব্যবহার এবং স্পষ্ট start/stop নিয়ন্ত্রণ উভয়ই সমর্থন করে। কনফিগারেশন অপশনগুলোর মধ্যে রয়েছে অ্যাপ ভার্সন, ডিবাগ মোড, সর্বোচ্চ ব্যাচ সাইজ (২৫ ইভেন্ট পর্যন্ত), ফ্ল্যাশ ইন্টারভাল, এবং এইটিপি টাইমআউট। ত্রুটি হ্যান্ডলিং-এ নেটওয়ার্ক সমস্যার জন্য আলাদা এক্সসেপশন (`NetworkError`) এবং সাধারণ অ্যাপ্টাবেস ত্রুটির জন্য (`AptabaseError`) দেওয়া হয়েছে। ডেভেলপমেন্ট সেটআপ `uv sync --dev` ব্যবহার করে; টেস্ট `pytest`, লিন্টিং `ruff`, এবং টাইপ চেকিং `mypy` দিয়ে করা হয়।