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

# odp-stockholm সুইডেনের স্টকহোমের ওপেন ডেটাসেটের জন্য একটি অ্যাসিনক্রোনাস Python ক্লায়েন্ট। এটি শহরের Open Data Platform API-এর সাথে যোগাযোগ করে যাতে Python অ্যাপ্লিকেশনগুলো হাতে HTTP রিকোয়েস্ট না লিখে ডেটাসেট সংগ্রহ করতে পারে। ## এটি যা করে প্যাকেজটি মূলত শুধুমাত্র পার্কিং ডেটা সংগ্রহের জন্য তৈরি করা হয়েছিল, তবে কোডবেসটি এমনভাবে সাজানো হয়েছে যাতে পরবর্তীতে একই প্ল্যাটফর্মের অন্যান্য ডেটাসেট যুক্ত করা যায়। README-তে বর্তমানে একটি ডেটাসেটের কথা উল্লেখ করা হয়েছে: - **Disabled parkings** (rörelsehindrade förare med särskilt tillstånd) — প্রায় ২০৪৫টি লোকেশন। ## প্রয়োজনীয়তা এবং অ্যাক্সেস ডেটা ব্যবহারের জন্য একটি API key প্রয়োজন, যা প্ল্যাটফর্মের ওয়েবসাইট থেকে অনুরোধ করা যেতে পারে। এই প্রজেক্টটি Python 3.12 বা তার পরবর্তী সংস্করণের জন্য তৈরি এবং PyPI-তে `odp-stockholm` হিসেবে ডিস্ট্রিবিউট করা হয়েছে। ## ইনস্টলেশন এবং ব্যবহার ```bash pip install odp-stockholm ``` ক্লায়েন্টটি একটি async context manager হিসেবে ব্যবহৃত হয়। ডকুমেন্ট করা উদাহরণটিতে একটি API key দিয়ে `ParkingStockholm` ইনস্ট্যানশিয়েট করা হয়েছে এবং `disabled_parkings(limit=10)` কল করে রিটার্ন করা লোকেশনগুলো প্রিন্ট করা হয়েছে। ## ডেটাসেট ফিল্ডস রিকোয়েস্টগুলো একটি `limit` প্যারামিটার (ডিফল্ট ১০) গ্রহণ করে। রিটার্ন করা রেকর্ডগুলোর মধ্যে থাকে: - `location_id`, `location_type`, পার্কিং স্পটের `number` - `street`, `address`, `district` - `parking_rate` এবং `parking_rules` (স্টকহোমের পার্কিং রেগুলেশনের একটি URL) - `valid_from` এবং `valid_to` (পরেরটি `None` হতে পারে) - ফ্লোট লিস্ট হিসেবে `coordinates` ## ডেভেলপমেন্ট সেটআপ প্রজেক্টটি ডিপেন্ডেন্সি ম্যানেজমেন্টের জন্য Poetry ব্যবহার করে এবং এটি VS Code Dev Container বা GitHub CodeSpace-এ খোলা যেতে পারে। কমিটগুলো `prek` হুক ফ্রেমওয়ার্কের মাধ্যমে লিন্ট এবং টেস্ট করা হয় (`poetry run prek install`, `poetry run prek run --all-files`)। টেস্টের জন্য pytest ব্যবহৃত হয়, যার মধ্যে syrupy স্ন্যাপশট টেস্ট অন্তর্ভুক্ত যা `poetry run pytest --snapshot-update` দিয়ে রিফ্রেশ করা যায়। ## লাইসেন্সিং MIT লাইসেন্সের অধীনে প্রকাশিত, কপিরাইট Klaas Schoute (২০২৩–২০২৬)। ## মূল্যায়নকারীদের জন্য নোট এটি একটি পূর্ণাঙ্গ অ্যাপ্লিকেশনের পরিবর্তে একটি ফোকাসড ডেটা-অ্যাক্সেস লাইব্রেরি: এর মূল্য হলো একটি মিউনিসিপ্যাল ওপেন-ডেটা সোর্সে টাইপড, অ্যাসিনক্রোনাস অ্যাক্সেস প্রদান করা এবং একটি টেমপ্লেট তৈরি করা যা স্টকহোমের আরও ডেটাসেটে সম্প্রসারিত করা যেতে পারে। এটি স্টকহোম সিটির সাথে যুক্ত নয় বা তাদের দ্বারা অনুমোদিত নয়; ব্যবহারকারীরা তাদের নিজস্ব API key প্রদান করবেন এবং প্ল্যাটফর্মের শর্তাবলীর অধীন থাকবেন।