Laravel Maestro કન્ટ્રીબ્યુટર ટ્યુટોરિયલ

Laravel Starter Kits બનાવવા માટે Maestro નો ઉપયોગ કરે છે. આ કિટ્સમાં યોગદાન (contribute) આપવા માટેનું ડોક્યુમેન્ટેશન ખૂબ ઓછું છે.

જો તમે Starter Kit માં નવી સુવિધાઓ ઉમેરવા માંગતા હોવ અથવા બગ્સ (bugs) સુધારવા માંગતા હોવ, તો તમારે વર્કફ્લો સમજવો જરૂરી છે. આ માર્ગદર્શિકા સમજાવે છે કે Maestro નો સાચી રીતે ઉપયોગ કેવી રીતે કરવો.

ડિરેક્ટરી સ્ટ્રક્ચર (The Directory Structure)

રિપોઝિટરીના ત્રણ મુખ્ય ભાગો છે:

  • kits/: આમાં વાસ્તવિક Starter Kit ફાઇલો હોય છે. આ એકમાત્ર ડિરેક્ટરી છે જેને તમે commit કરો છો.
  • orchestrator/: આ બિલ્ડ પ્રક્રિયાનું સંચાલન કરે છે અને કિટ્સ ચલાવે છે.
  • build/: આ એક કામચલાઉ વર્કસ્પેસ છે. જ્યારે તમે બિલ્ડ રન કરો છો ત્યારે Maestro આ બનાવે છે.

ડેવલપમેન્ટ વર્કફ્લો (The Development Workflow)

જ્યાં સુધી તમે એકસાથે ઘણી ફાઇલો અપડેટ ન કરી રહ્યા હોવ ત્યાં સુધી સીધી kits/ ડિરેક્ટરીમાં કામ કરશો નહીં. તેના બદલે, આ સ્ટેપ્સ અનુસરો:

  1. એન્વાયરમેન્ટ સેટઅપ કરો orchestrator/ ફોલ્ડરમાં જાઓ. composer install અને npm install રન કરો.

  2. તમારી ટાર્ગેટ કિટ બનાવો (Build) php artisan build રન કરો. તમારું framework, variant, અને features પસંદ કરો. આનાથી 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. તમારું કામ કમિટ (Commit) કરો તમારું git status ચેક કરો. તમારે kits/ ફોલ્ડરમાં ફેરફારો જોવા મળવા જોઈએ. તમારા કમિટમાં ફક્ત kits/ ડિરેક્ટરી જ ઉમેરો.

ઉદાહરણ: ટેક્સ્ટને "Log in" થી બદલીને "Log on" કરવું

  • build/ ની અંદર રહેલી blade અથવા component ફાઇલ એડિટ કરો.
  • kits/ ને અપડેટ કરવા માટે વોચરની રાહ જુઓ.
  • અન્ય variants ને નુકસાન ન થાય તેની ખાતરી કરવા માટે ટેસ્ટ રન કરો.
  • kits/ માં રહેલી ફાઇલો કમિટ કરો.

આ પ્રક્રિયા સુનિશ્ચિત કરે છે કે તમારું યોગદાન (contribution) ક્લીન રહે અને Maestro આર્કિટેક્ચરનું પાલન કરે.

સ્ત્રોત: https://dev.to/catatsumuri/laravel-maestro-contributor-tutorial-2p89