Laravel Maestro योगदानकर्ता ट्युटोरियल

Laravel Starter Kits तयार करण्यासाठी Maestro चा वापर करते. या किट्समध्ये योगदान देण्यासाठी उपलब्ध असलेली कागदपत्रे (documentation) खूप कमी आहेत.

जर तुम्हाला Starter Kit मध्ये नवीन फीचर्स जोडायचे असतील किंवा बग्स (bugs) फिक्स करायचे असतील, तर तुम्हाला वर्कफ्लो (workflow) समजून घेणे आवश्यक आहे. हे गाईड Maestro चा योग्य वापर कसा करायचा हे स्पष्ट करते.

डिरेक्टरी स्ट्रक्चर (The Directory Structure)

रिपॉझिटरीचे तीन मुख्य भाग आहेत:

  • kits/: यामध्ये प्रत्यक्ष Starter Kit फाइल्स असतात. तुम्ही फक्त हीच डिरेक्टरी कमिट (commit) करता.
  • orchestrator/: हे बिल्ड प्रोसेस मॅनेज करते आणि किट्स रन करते.
  • build/: हे एक तात्पुरते वर्कस्पेस (workspace) आहे. जेव्हा तुम्ही बिल्ड रन करता, तेव्हा Maestro हे तयार करते.

डेव्हलपमेंट वर्कफ्लो (The Development Workflow)

जोपर्यंत तुम्ही एकाच वेळी अनेक फाइल्स अपडेट करत नाही, तोपर्यंत थेट kits/ डिरेक्टरीमध्ये काम करू नका. त्याऐवजी, खालील पायऱ्या फॉलो करा:

  1. एनवायरमेंट सेटअप करा (Setup the environment) orchestrator/ फोल्डरमध्ये जा. composer install आणि npm install रन करा.

  2. तुमचे टार्गेट किट बिल्ड करा (Build your target kit) php artisan build रन करा. तुमचा फ्रेमवर्क, व्हेरिएंट (variant) आणि फीचर्स निवडा. यामुळे build/ फोल्डर तयार होईल.

  3. किट रन करा (Run the kit) orchestrator/ फोल्डरमधून composer kit:run वापरा. यामुळे 8000 पोर्टवर ॲप्लिकेशन सुरू होईल.

  4. तुमचे बदल करा (Make your changes) build/ डिरेक्टरी उघडा. तुम्हाला ज्या फाइल्स बदलायच्या आहेत त्या शोधा आणि त्या एडिट करा.

  5. वॉचरला (watcher) काम करू द्या Maestro वॉचरचा वापर करते. जेव्हा तुम्ही build/ मधील एखादी फाईल सेव्ह करता, तेव्हा ते kits/ डिरेक्टरीमधील योग्य फाईल आपोआप अपडेट करते.

  6. तुमचे बदल तपासा (Test your changes) प्रथम kit:run प्रोसेस थांबवा. किट रन होत असताना तुम्ही टेस्ट रन करू शकत नाही. orchestrator/ फोल्डरमधून, रन करा:

  • composer kits:pint (formatting साठी)
  • composer kits:check (PHP टेस्टसाठी)
  • composer kits:lint (JavaScript टेस्टसाठी)
  1. तुमचे काम कमिट करा (Commit your work) तुमचा git status तपासा. तुम्हाला kits/ फोल्डरमध्ये बदल दिसले पाहिजेत. तुमच्या कमिटमध्ये फक्त kits/ डिरेक्टरी जोडा.

उदाहरण: "Log in" मधून "Log on" असा मजकूर बदलणे

  • build/ मधील blade किंवा component फाईल एडिट करा.
  • वॉचरने kits/ अपडेट करेपर्यंत प्रतीक्षा करा.
  • इतर व्हेरिएंट्समध्ये काही बिघाड झाला नाही याची खात्री करण्यासाठी टेस्ट रन करा.
  • kits/ मधील फाइल्स कमिट करा.

ही प्रक्रिया तुमचे योगदान स्वच्छ (clean) ठेवते आणि Maestro आर्किटेक्चरचे पालन करते याची खात्री देते.

Source: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89