Laravel Maestro معاون (Contributor) ٹیوٹوریل

Laravel Starter Kits بنانے کے لیے Maestro کا استعمال کرتا ہے۔ ان کٹس میں حصہ ڈالنے (contributing) کے لیے دستاویزات کی کمی ہے۔

اگر آپ کسی Starter Kit میں فیچرز شامل کرنا چاہتے ہیں یا بگ (bugs) ٹھیک کرنا چاہتے ہیں، تو آپ کو ورک فلو (workflow) کو سمجھنا ہوگا۔ یہ گائیڈ بتاتی ہے کہ Maestro کو صحیح طریقے سے کیسے استعمال کیا جائے۔

ڈائریکٹری کا ڈھانچہ (Directory Structure)

ریپوزٹری (repository) کے تین اہم حصے ہیں:

  • kits/: اس میں اصل Starter Kit فائلیں ہوتی ہیں۔ یہ واحد ڈائریکٹری ہے جسے آپ کمٹ (commit) کرتے ہیں۔
  • orchestrator/: یہ بلڈ پروسیس کو مینیج کرتا ہے اور کٹس کو چلاتا ہے۔
  • build/: یہ ایک عارضی ورک سپیس ہے۔ جب آپ بلڈ چلاتے ہیں تو Maestro اسے تخلیق کرتا ہے۔

ڈویلپمنٹ ورک فلو (Development Workflow)

kits/ ڈائریکٹری میں براہ راست کام نہ کریں جب تک کہ آپ ایک ساتھ بہت سی فائلیں اپ ڈیٹ نہ کر رہے ہوں۔ اس کے بجائے، ان مراحل پر عمل کریں:

  1. ماحول (environment) سیٹ اپ کریں orchestrator/ فولڈر میں جائیں۔ composer install اور npm install چلائیں۔

  2. اپنی مطلوبہ کٹ بلڈ کریں php artisan build چلائیں۔ اپنا فریم ورک، ویرینٹ (variant) اور فیچرز منتخب کریں۔ اس سے build/ فولڈر بن جائے گا۔

  3. کٹ چلائیں orchestrator/ فولڈر سے composer kit:run استعمال کریں۔ یہ پورٹ 8000 پر ایپلی کیشن شروع کر دے گا۔

  4. اپنی تبدیلیاں کریں build/ ڈائریکٹری کھولیں۔ وہ فائلیں تلاش کریں جنہیں آپ تبدیل کرنا چاہتے ہیں اور انہیں ایڈٹ کریں۔

  5. واچر (watcher) کو کام کرنے دیں Maestro ایک واچر استعمال کرتا ہے۔ جب آپ build/ میں کوئی فائل سیو کرتے ہیں، تو یہ خود بخود kits/ ڈائریکٹری میں متعلقہ فائل کو اپ ڈیٹ کر دیتا ہے۔

  6. اپنی تبدیلیوں کا ٹیسٹ کریں پہلے kit:run پروسیس کو روکیں۔ جب کٹ چل رہی ہو تو آپ ٹیسٹ نہیں چلا سکتے۔ orchestrator/ فولڈر سے، یہ چلائیں:

  • composer kits:pint (فارمیٹنگ کے لیے)
  • composer kits:check (PHP ٹیسٹ کے لیے)
  • composer kits:lint (JavaScript ٹیسٹ کے لیے)
  1. اپنا کام کمٹ کریں اپنا git status چیک کریں۔ آپ کو kits/ فولڈر میں تبدیلیاں نظر آنی چاہئیں۔ اپنے کمٹ میں صرف kits/ ڈائریکٹری کو شامل کریں۔

مثال: ٹیکسٹ کو "Log in" سے "Log on" میں تبدیل کرنا

  • build/ کے اندر موجود blade یا component فائل کو ایڈٹ کریں۔
  • kits/ کو اپ ڈیٹ کرنے کے لیے واچر کا انتظار کریں۔
  • ٹیسٹ چلائیں تاکہ اس بات کو یقینی بنایا جا سکے کہ آپ نے دیگر ویرینٹس کو خراب نہیں کیا۔
  • kits/ میں موجود فائلوں کو کمٹ کریں۔

یہ عمل اس بات کو یقینی بناتا ہے کہ آپ کا حصہ (contribution) صاف ستھرا رہے اور Maestro کے آرکیٹیکچر کے مطابق ہو۔

ماخذ: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89