منصوبے کے بارے میں

# odp-stockholm اسٹاک ہولم، سویڈن کے اوپن ڈیٹا سیٹس کے لیے ایک asynchronous Python کلائنٹ۔ یہ شہر کے Open Data Platform API سے رابطہ کرتا ہے تاکہ Python ایپلی کیشنز دستی HTTP درخواستیں لکھے بغیر ڈیٹا سیٹس حاصل کر سکیں۔ ## یہ کیا کرتا ہے یہ پیکیج اصل میں صرف پارکنگ ڈیٹا حاصل کرنے کے لیے بنایا گیا تھا، لیکن کوڈ بیس کو جان بوجھ کر اس طرح ترتیب دیا گیا ہے کہ اسی پلیٹ فارم سے دیگر ڈیٹا سیٹس بعد میں شامل کیے جا سکیں۔ README میں فی الحال ایک ڈیٹا سیٹ کی دستاویز موجود ہے: - **Disabled parkings** (rörelsehindrade förare med särskilt tillstånd) — تقریباً 2045 مقامات۔ ## ضروریات اور رسائی ڈیٹا استعمال کرنے کے لیے ایک API key کی ضرورت ہوتی ہے، جس کی درخواست پلیٹ فارم کی ویب سائٹ سے کی جا سکتی ہے۔ یہ پروجیکٹ Python 3.12 یا اس سے نئے ورژن کو ٹارگٹ کرتا ہے اور PyPI پر `odp-stockholm` کے طور پر دستیاب ہے۔ ## انسٹالیشن اور استعمال ```bash pip install odp-stockholm ``` کلائنٹ کو ایک async context manager کے طور پر استعمال کیا جاتا ہے۔ دستاویز میں دی گئی مثال API key کے ساتھ `ParkingStockholm` کو انسٹینشئیٹ کرتی ہے اور `disabled_parkings(limit=10)` کو کال کرتی ہے، جس سے واپس ملنے والے مقامات پرنٹ ہوتے ہیں۔ ## ڈیٹا سیٹ کے فیلڈز درخواستیں `limit` پیرامیٹر (ڈیفالٹ 10) قبول کرتی ہیں۔ واپس ملنے والے ریکارڈز میں شامل ہیں: - `location_id`، `location_type`، پارکنگ اسپاٹس کی `number` - `street`، `address`، `district` - `parking_rate` اور `parking_rules` (اسٹاک ہولم کے پارکنگ قوانین کا ایک URL) - `valid_from` اور `valid_to` (بعد والا `None` ہو سکتا ہے) - `coordinates` بطور floats کی لسٹ ## ڈویلپمنٹ سیٹ اپ پروجیکٹ ڈیپینڈینسی مینجمنٹ کے لیے Poetry استعمال کرتا ہے اور اسے VS Code Dev Container یا GitHub CodeSpace میں کھولا جا سکتا ہے۔ Commits کو `prek` hook فریم ورک (`poetry run prek install`, `poetry run prek run --all-files`) کے ذریعے لنٹ اور ٹیسٹ کیا جاتا ہے۔ ٹیسٹ کے لیے pytest استعمال ہوتا ہے، بشمول syrupy snapshot ٹیسٹ جنہیں `poetry run pytest --snapshot-update` کے ذریعے ریفریش کیا جا سکتا ہے۔ ## لائسنسنگ MIT لائسنس کے تحت جاری کیا گیا، کاپی رائٹ Klaas Schoute (2023–2026)۔ ## ایویلیو ایٹرز کے لیے نوٹس یہ ایک مکمل ایپلی کیشن کے بجائے ایک فوکسڈ ڈیٹا ایکسیس لائبریری ہے: اس کی اہمیت بلدیاتی اوپن ڈیٹا سورس تک typed، async رسائی فراہم کرنے اور ایک ٹیمپلیٹ مہیا کرنے میں ہے جسے اسٹاک ہولم کے مزید ڈیٹا سیٹس تک بڑھایا جا سکتا ہے۔ اس کا اسٹاک ہولم سٹی کے ساتھ کوئی تعلق یا توثیق نہیں ہے؛ صارفین اپنی API key فراہم کرتے ہیں اور پلیٹ فارم کی شرائط کے پابند ہیں۔