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

Smokey ایک سٹیٹک، سنگل فائل ڈویلپر ڈیش بورڈ ہے جو GitHub ریپوزٹریز کی صحت کی نگرانی کے لیے استعمال ہوتا ہے۔ آپ براؤزر میں index.html کھولتے ہیں، GitHub صارف نام یا آرگنائزیشن درج کرتے ہیں، ریپوزٹریز کو owner/repo فارمیٹ میں لسٹ کرتے ہیں، اور صفحہ ان کی موجودہ حالت کو ایک ترتیب پذیر (sortable) ٹیبل میں ظاہر کر دیتا ہے۔ اس کا مقصد GitHub پر بار بار کلک کیے بغیر ریپوزٹری کی صحت دیکھنا ہے۔ ٹیبل کیا ظاہر کرتا ہے - ہر ریپوزٹری کے لیے آخری پش (Last push)، جس میں ڈیفالٹ طور پر سب سے پرانی پش پہلے لسٹ ہوتی ہے؛ کسی بھی کالم ہیڈر (repository, last push, PRs, issues) پر کلک کر کے دوبارہ ترتیب دی جا سکتی ہے۔ - تازہ ترین ریلیز ورژن اور ریلیز کی تاریخ، جو ریپوزٹری کے نام کے نیچے دکھائی جاتی ہے۔ - اوپن پل ریکویسٹ (pull requests) اور اوپن ایشوز (open issues) کی تعداد؛ کسی تعداد پر کلک کرنے سے اس ریپوزٹری کے لیے فلٹر شدہ GitHub صفحہ کھل جاتا ہے۔ - اٹینشن بیجز (Attention badges): اوپن PRs کے لیے ایک قطار اور اوپن ایشوز کے لیے ایک، جو صرف ان ریپوزٹریز کے لیے ظاہر ہوتے ہیں جن میں بیرونی کنٹری بیوٹر کی سرگرمی ہو، اور ہر بیج فلٹر شدہ GitHub ویو سے منسلک ہوتا ہے۔ بوٹس کے ذریعے بھیجی گئی PRs (مثلاً github-actions[bot]) کو خود بخود فلٹر کر دیا جاتا ہے۔ تصدیق (Authentication) عوامی (Public) ریپوزٹریز لاگ ان کے بغیر لوڈ ہو جاتی ہیں۔ نجی ریپوزٹریز اور CI اسٹیٹس کالم کو فعال کرنے کے لیے سیٹنگز پینل میں اختیاری طور پر GitHub پرسنل ایکسیس ٹوکن (PAT) شامل کیا جا سکتا ہے، اور SAML SSO سے محفوظ آرگنائزیشن ریپوزٹریز کے لیے یہ ضروری ہے اگر ٹوکن اس آرگنائزیشن کے لیے مجاز ہو۔ چونکہ غیر تصدیق شدہ API رسائی کی حد 60 درخواستیں فی گھنٹہ ہے اور ہر ریپوزٹری کے لیے چار درخواستیں درکار ہوتی ہیں، اس لیے تقریباً پندرہ عوامی ریپوزٹریز کی نگرانی کے بعد ٹوکن ضروری ہو جاتا ہے؛ ایک تصدیق شدہ ٹوکن اس حد کو 5,000 درخواستیں فی گھنٹہ تک بڑھا دیتا ہے۔ README میں بتایا گیا ہے کہ ٹوکن صرف براؤزر کے localStorage میں محفوظ ہوتا ہے اور صرف api.github.com کو بھیجا جاتا ہے۔ کلاسک ٹوکنز (repo scope) اور فائن گرینڈ ٹوکنز (Contents: Read, Metadata: Read, Actions: Read for CI status) دونوں کی وضاحت کی گئی ہے۔ ٹریفک چارٹ GitHub کی لائیو ٹریفک API کے بجائے، ڈیش بورڈ ایک مکمل تاریخ کا ٹریفک ایریا چارٹ تیار کرتا ہے جس کے لیے traffic-log برانچ میں روزانہ کا اسنیپ شاٹ رکھا جاتا ہے، جسے ایک علیحدہ ہفتہ وار GitHub Actions ورک فلو (log-traffic.yml) کے ذریعے جمع کیا جاتا ہے۔ چارٹ ایک لوگارتھمک ٹائم ایکسس (logarithmic time axis) استعمال کرتا ہے جو حالیہ دنوں کو پھیلاتا ہے اور ایک اسکوائر روٹ ویلیو اسکیل استعمال کرتا ہے۔ اس ویو کے لیے کسی ٹوکن کی ضرورت نہیں ہوتی۔ اگر برانچ یا لاگ شدہ قطاریں موجود نہیں ہیں، تو چارٹ ٹریفک کی کوئی تاریخ رپورٹ نہیں کرتا۔ ہوسٹنگ اور سیٹ اپ اس میں کوئی بلڈ سٹیپ، ڈیپینڈینسی انسٹالیشن یا سرور نہیں ہے۔ GitHub Pages پر ایک ہوسٹڈ کاپی دستیاب ہے، لہذا ڈیش بورڈ کو کچھ بھی انسٹال کیے بغیر استعمال کیا جا سکتا ہے؛ ورنہ آپ index.html ڈاؤن لوڈ کر کے اسے مقامی طور پر کھول سکتے ہیں۔ اپنا انسٹنس چلانے کے لیے، ریپوزٹری کو فورک (fork) کریں اور مین برانچ کے روٹ فولڈر سے GitHub Pages کو فعال کریں۔ لے آؤٹ کو موبائل فرینڈلی اور کومپیکٹ بتایا گیا ہے، جس میں سائیڈ بارز نہیں ہیں۔ README میں ٹربل شوٹنگ کے کیسز کی دستاویزات بھی ہیں: ایک پرانا کیشڈ صفحہ جو مستقل طور پر "add a PAT" کا پیغام دیتا ہے (جسے ہارڈ ریفریش سے حل کیا جاتا ہے، یہ نوٹ کرتے ہوئے کہ پرائیویٹ ونڈوز میں localStorage کلیئر ہو جاتا ہے)، 403 ایررز جو غیر تصدیق شدہ ریٹ لمٹس یا SAML اتھارائزیشن کی کمی کی وجہ سے ہوتے ہیں، اور ٹریفک چارٹ کا خالی رہنا جب تک کہ ریپوزٹریز شامل ہونے کے بعد لاگنگ ورک فلو کم از کم ایک بار نہ چل جائے۔ لائسنس اور رابطہ: MIT لائسنس، کاپی رائٹ 2025 Scott Kirvan۔ ایشوز، فورکس اور پل ریکویسٹ کے ذریعے شراکت کی دعوت دی گئی ہے؛ رابطے کے ذرائع میں LinkedIn اور ایک Discord سرور شامل ہیں، اور ریپوزٹری کے نوٹس فولڈر میں CHANGELOG اور TODO شامل ہیں۔