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

یہ ریپوزٹری Monash University کی جانب سے شائع کردہ پارکنگ کی خالی جگہوں کا ڈیٹا جمع کرتی ہے۔ یونیورسٹی ایک عوامی JSON فائل فراہم کرتی ہے جس میں پارکنگ سینسرز سے لیس ہر Monash کار پارک کی دستیابی کی فہرست ہوتی ہے، بشمول تمام بڑے پارکنگ ایریاز۔ وہ JSON ہر دو منٹ بعد ریفریش ہوتا ہے اور ایک عوامی URL پر دستیاب ہے، جسے یہ پروجیکٹ اپنے ڈیٹا سورس کے طور پر استعمال کرتا ہے۔ ریپوزٹری کا مرکز ایک واحد Python اسکرپٹ، scraper.py ہے، جو اس JSON کو پڑھتا ہے اور نتائج کو monash_all_parking_availabilities.csv نامی ایک CSV فائل میں ریکارڈ کرتا ہے۔ اس اسکرپٹ کو دستی طور پر چلانے کے بجائے خودکار طور پر چلانے کے لیے ڈیزائن کیا گیا ہے: ایک ورک فلو فائل، scrape.yml، اسے GitHub Actions کے ذریعے چلاتی ہے، اور یہ رنز بیرونی شیڈولنگ سروس cron-job.org کے ذریعے ہر چھ منٹ بعد متحرک ہوتے ہیں۔ مصنف کا بیان ہے کہ ڈیٹا کا مجموعہ 21 اگست 2026 کو شروع ہوا اور توقع ہے کہ CSV مستقبل قریب میں بڑھتا رہے گا، اور کوئی بھی حاصل شدہ ڈیٹا کو قانونی طور پر اپنی مرضی کے مطابق استعمال کر سکتا ہے۔ README پروجیکٹ کے آغاز کے بارے میں واضح ہے۔ یہ مصنف کا پہلا GitHub پروجیکٹ ہے اور اسے بنیادی طور پر یہ سیکھنے کے لیے شروع کیا گیا کہ GitHub کیسے کام کرتا ہے۔ زیادہ تر اسکرپٹس مصنف کی نگرانی میں Gemini اسسٹنٹ کی مدد سے لکھے گئے، اور ریپوزٹری سیٹ اپ اسسٹنٹ کی ہدایات کے مطابق کیا گیا۔ مصنف نے نوٹ کیا ہے کہ ڈیٹا آخر کار بہت بڑا ہو جائے گا: 29 اگست 2026 کی ایک اپ ڈیٹ کہتی ہے کہ فائل سائز کی حدود ممکنہ طور پر تقریباً پانچ مہینوں میں ختم ہو جائیں گی، اور مستقبل کے کاموں کی فہرست فراہم کرتی ہے۔ ان منصوبوں میں تمام ڈیٹا سیریز کا تجزیہ کرنا؛ ڈیٹا اکٹھا کرنے کو کار پارک N1 (تمام پرمٹ) کے فعال سیریز اور دیگر نیلے یا سرخ پرمٹ والے کار پارکوں تک محدود کرنا؛ ڈیٹا کو وائیڈ فارمیٹ میں اسٹور کرنا (اس دلیل کے ساتھ کہ ڈیٹا ڈینس ہونا چاہیے نہ کہ اسپارس کیونکہ ایک سال میں بہت کم سیریز تبدیل ہوتے ہیں)؛ اور ممکنہ طور پر ایک GitHub ویب پیج شائع کرنا جو تاریخی رجحانات کی بنیاد پر یہ بتائے کہ کیا ایک گھنٹے بعد پارکنگ کی جگہ دستیاب ہونے کی پیش گوئی کی جا سکتی ہے، ساتھ ہی CSV ڈیٹا کا ایک انٹرایکٹو ویو فراہم کرنا، جسے ماہانہ فائلوں میں تقسیم کیا جا سکتا ہے۔ اپنی موجودہ حالت میں، یہ پروجیکٹ ایک سادہ شیڈول شدہ ڈیٹا کلیکشن پائپ لائن ہے: سورس کے طور پر ایک ہوسٹڈ JSON اینڈ پوائنٹ، ایک Python فیچ-اینڈ-اپینڈ اسکرپٹ، ایگزیکیوشن کے لیے ایک GitHub Actions ورک فلو، اور ٹائمنگ کے لیے ایک بیرونی cron سروس۔ README میں تصدیق (authentication)، پارسنگ کی تفصیلات، ایرر ہینڈلنگ، یا کسی تجزیاتی ٹولنگ کا ذکر نہیں ہے، اور فہرست میں شامل مستقبل کے آئٹمز کو نافذ شدہ فیچرز کے بجائے ارادوں کے طور پر بیان کیا گیا ہے۔