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

اوپن آڈیو اسٹیک رجسٹری ایک آڈیو رجسٹری اسپیسیفیکیشن کے ساتھ قابل تلاش پیکیج انڈیکس ہے جو پلگ انز، پریسیٹس، پروجیکٹس اور ایپس کا احاطہ کرتا ہے۔ یہ بنیادی طور پر آڈیو سافٹ ویئر ڈویلپرز کے لیے ہے جو چاہتے ہیں کہ ان کا سافٹ ویئر کسی بھی اوپن آڈیو اسٹیک کے موافق ٹول کے ذریعے قابل دریافت اور قابل انسٹال ہو، اور ثانوی طور پر ان موسیقاروں اور پروڈیوسروں کے لیے جو یہ پیکجز انسٹال کرتے ہیں۔ یہ کیسے کام کرتا ہے: شراکت دار ایک برانچ پر YAML فائلیں شامل کرتے ہیں، ہر پیکیج ورژن کے لیے ایک۔ اسکیننگ کے بعد، تبدیلیاں ضم کر دی جاتی ہیں اور GitHub Actions ایک اسٹیٹک GitHub Pages سائٹ بناتا ہے جس میں رجسٹری کے ہر حصے کے لیے JSON فائلیں ہوتی ہیں۔ موافق کمانڈ لائن ٹولز، ایپس اور ویب سائٹس پیکیجز دریافت کرنے کے لیے ان JSON فائلوں کو پڑھتے ہیں۔ API اسٹیٹک JSON ہے، لہذا انٹیگریٹرز کو اپنی الگ تقسیمی انفراسٹرکچر ہوسٹ کرنے کی ضرورت نہیں۔ پیکیج جمع کرانا تین طریقوں سے کیا جا سکتا ہے: میٹاڈیٹا بھرنے کے لیے ایک ویب فارم، AGENTS.md کی طرف اشارہ کردہ کوڈنگ ایجنٹ، یا دستی طور پر ریپوزٹری فورک کر کے kebab-case میں فولڈرز شامل کرنا جیسے src/plugins/org-name/package-name۔ ہر پیکیج میں ایک JPEG اسکرین شاٹ اور ایک FLAC آڈیو پیش نظارہ شامل ہوتا ہے، جو لوڈنگ کارکردگی کے لیے منتخب کیے گئے ہیں۔ ورژنز سیمنٹک ورژننگ کی پیروی کرتے ہیں، لہذا ایک انسٹالر تازہ ترین غیر توڑنے والی ریلیز منتخب کر سکتا ہے۔ ایپس، پلگ انز، پریسیٹس اور پروجیکٹس کے لیے مثال YAML فائلیں فراہم کی گئی ہیں، اور اسپیسیفیکیشن پلگ ان فیلڈز، فارمیٹس اور اقسام کے ساتھ ساتھ فائل فیلڈز، فارمیٹس، سفارشات اور اقسام کو دستاویز کرتی ہے۔ توثیق مقامی طور پر npm install اور npm run dev:validate کے ذریعے YAML فائل کے راستے کے ساتھ چلتی ہے۔ یہ مسائل کی اطلاع دیتی ہے جیسے حد سے زیادہ لمبی فیلڈز، اور اصل ڈاؤن لوڈ کے خلاف فائل سائز اور sha256 کی جانچ کرتی ہے۔ سائز صارفین کو بتاتا ہے کہ ڈاؤن لوڈ کتنا بڑا ہے؛ sha256 تصدیق کرتا ہے کہ ڈاؤن لوڈ کی گئی فائل مطلوبہ تقسیم سے میل کھاتی ہے۔ عدم مطابقت موصول اور متوقع اقدار پرنٹ کرتی ہے تاکہ URL یا میٹاڈیٹا درست کیا جا سکے۔ پھر پل ریکویسٹ ضم کرنے سے پہلے خودکار ٹیسٹ، توثیق اور وائرس اسکیننگ چلاتی ہیں۔ ان پیکیجز کے لیے جن کی بائنریز براہ راست ریپوزٹری میں جمع کرائی گئی ہیں اور کوئی GitHub ریلیز نہیں ہے، فائل URL کو برانچ کے بجائے ایک مخصوص کمٹ کی طرف اشارہ کرنا چاہیے، کیونکہ برانچ آرکائیو URLs ہر پش پر ہیش تبدیل کرتے ہیں۔ README دکھاتا ہے کہ GitHub CLI کے ساتھ کمٹ SHA کیسے حاصل کیا جائے اور پن شدہ آرکائیو URL فارمیٹ، پھر sha256 اور سائز کو اپ ڈیٹ کرنے کے لیے توثیق دوبارہ چلائیں۔ اسپیسیفیکیشن یا API استعمال کرنے والے پروجیکٹس فراہم کردہ بیج کے ساتھ واپس لنک کر سکتے ہیں۔ رجسٹری Node.js 20.x، TypeScript 5.x، eslint 9.x، prettier 3.x اور vitest 3.x کے ساتھ بنائی گئی ہے، جس میں lint، format، dev، test، build اور start کے لیے npm اسکرپٹس ہیں۔ ریلیزز git ٹیگز کے ساتھ ورژن کی جاتی ہیں اور خودکار طور پر GitHub Pages پر شائع ہوتی ہیں۔ رجسٹری بنیادی طور پر مفت اوپن سورس پیکیجز کے لیے ہے جو Linux، Mac اور Windows کے لیے کراس پلیٹ فارم بنائے گئے ہیں؛ رہنما خطوط پر پورا نہ اترنے والے پیکیجز مسترد یا ہٹائے جا سکتے ہیں۔