Vienkārša apmācība, lai izveidotu savu pirmo PR (Pull Request)

Nu, šī, manuprāt, būs diezgan īsa apmācība un, cerams, didaktika;). Es darīšu jums pieejamu nelielu krātuvi savā github, lai jūs varētu nosūtīt savus PR un tajā pašā laikā, lai jūs varētu praktizēt, kā veikt visas darbības, kuras es atstāšu zemāk. Šeit ir saite, lai veiktu testa PR:

https://github.com/CodeLabora/TuPrimerPR

Labi, ātri uzskaitīsim darbības, kas nepieciešamas PR nosūtīšanai:

1. Dakša
2. Clone
3. Tālvadības
4. Filiāle
5. Izmaiņas
6. Pievienot
7. izdarīt
8. Push
9. PR

Es tos ievietoju angļu valodā, lai viņi atrastu savas attiecīgās opcijas git komandrindā.

Dakša

Dakša ir jūsu pašu Github krātuves versija. Tas ļauj klonēt cita projekta darbu un to ievietot savā kontā, lai jūs varētu mainīt lietas, neuztraucoties par izmaiņu zaudēšanu. Lai izveidotu dakšiņu, ir jāiet tikai uz lapu un jānoklikšķina uz pogas Dakša, kas atrodas augšējā labajā pusē.

Kad dakša ir pabeigta, jūs redzēsiet, ka krātuve parādās jūsu kontā.

Clone

Tagad, kad mums ir krātuve, mēs to klonēsim savā komandā. (Es pieņemu, ka cilvēki, kuri izmanto Linux, seko man, bet citu sistēmu lietotājiem ir arī git versijas, kuras varat lejupielādēt viņu oficiālajā lapā.

Un ar mūsu termināli mēs rīkojamies šādi.

Līdz ar to mums būs jauna mape ar nosaukumu TuPrimerPR, kurā būs mūsu Github projekts. Mēs ievadām mapi ar komandu «cd TuPrimerPR» un redzēsim, ka iekšpusē ir faili, kas atrodas mūsu dakšiņā.

(Ņemiet vērā, ka failu skaits var atšķirties atkarībā no tā, ko viņi atrod manā repozitorijā, kad viņi dakšas)

Tālvadības

Šis ir izvēles solis, taču tas ļauj izvairīties no daudzām problēmām, nepārtraukti strādājot pie projekta. Dakša pēc noklusējuma izveido precīzu repozitorija kopiju, bet precīzā izveides brīdī. Tas nozīmē, ka, ja projekts turpina virzīties uz priekšu, jūsu krātuve atpaliks ar dienām vai stundām. "Git remote" ļauj mums norādīt citu lejupielādes punktu (sākotnējo projektu) un tādējādi spēt atjaunināt mūsu projektu katru reizi, kad redzam, ka vecāku projekts tiek atjaunināts.

Lai atrastu vecāku projektu, jums vienkārši jāizmanto saite, kas atrodas tieši zem jūsu krātuves nosaukuma. (Pārbaudiet sadaļas Dakša otro attēlu). Mēs pievienosim šo informāciju zemāk:

Šis ir sākotnējais projekts (mēs to sauksim) pret straumi daudzus projektus).

Kā redzat, esmu pievienojis tālvadības pulti ar »git remote add »

Ar to mēs varēsim atjaunināt projektu, kad tas būs nepieciešams, bet mēs to tagad neizmantosim, jo ​​tas nav nepieciešams. (Es to paskaidrošu vēlāk vai citā amatā, atkarībā no vajadzības)

Filiāle

Zari (vai filiāles) ļauj jums izveidot koda sadaļas, kuras varat strādāt izolētā vidē. Tas nozīmē, ka tas, ko jūs darāt filiālē, ne vienmēr ietekmē sākotnējo kodu, kamēr netiek izmantota “git merge”. Tā ir arī papildu funkcionalitāte, kuru Github ļauj jums katru reizi, kad izveidojat filiāli, ja nepieciešams, Github automātiski ģenerē izvilkšanas pieprasījuma avotu.

Tagad, kad atrodamies savā īpašajā nozarē, mēs varam strādāt pie sava ieguldījuma.

Izmaiņas

Es pievienošu pāris failus, lai jūs varētu redzēt, kā tas tiek darīts.

"Pieskāriens" ļauj mums izveidot tukšu failu (ja tāda nav). ar to mēs varam pāriet uz nākamo soli.

Pievienot

»Git add» ļauj mums pievienot failus mūsu saistībām (es paskaidrošu vēlāk). Lai redzētu, kurus failus varat pievienot, varat izmantot komandu »git status»

Līdz ar to mums ir viss gatavs mūsu saistībām

izdarīt

Saistības ir laika atzīmes (vai pagrieziena punkti). tie nosaka stāvokli visiem projekta failiem un uzkrāj nepieciešamās izmaiņas, lai no projekta sākuma nonāktu pašreizējā stāvoklī. Tas izklausās mazliet sarežģīti, bet ir pavisam vienkārši, tikai atcerieties, ka tās ir jūsu projekta kāpnes. Mēs rakstām »git commite» un mēs iegūsim logu, lai uzrakstītu mūsu saistību ziņojumu.

Pabeidzot un saglabājot tekstu, mēs redzēsim kaut ko līdzīgu:

Kur tiek parādīts kopsavilkums par izdarīto.

Push

Ar push mēs augšupielādējam savā Github kontā visas saistības, kas mums ir datorā un kuras nav mūsu repozitorijā internetā. Tas ļaus Github automātiski ģenerēt jauno PR.

Ievērojiet, ka mēs izmantojam savas filiāles nosaukumu un ka tā prasa mums lietotājvārdu un paroli. Beigās tas mums parāda, ka myImprovement filiāle ir izveidota mūsu Github kontā. Apskatīsim, ko esam sasnieguši pārlūkprogrammā. 😉

PR

Kā redzat, ir izveidota jauna rinda ar uzrakstu "Salīdzināt un vilkt pieprasījumu". Šī Github funkcionalitāte ļauj mums izveidot PR vienkāršā veidā, mēs noklikšķināsim, lai redzētu, kas notiek.

Gitubs ir diezgan gudrs. Kā redzat, apņemšanās daļas tiek pievienotas iesniegšanas veidlapai. Ir nepieciešams tikai noklikšķināt uz pogas un voila 🙂 Vienkārši.

Papildus

Tas notiek projektu aizkulisēs, parādās PR un vadītājs izlemj, vai pieņemt vai nepieņemt, vai rakstīt vairāk ziņojumu. Manā gadījumā to pieņemšu uzreiz.

Kad apvienošana būs pabeigta, viņi varēs redzēt projekta saistību žurnālu un redzēt tajā savu vārdu.

Bet tagad mums ir problēma. Šī apņemšanās neparādās Nuestro krātuve, tikai projektā. Vai atceraties mūsu attālināto eju? Tagad ir tas laiks, kad tas atmaksājas 🙂

Mēs atgriežamies pie sava meistara filiāles un rīkojamies šādi:

Ar to mēs esam lejupielādējuši visu sākotnējā projekta informāciju savai komandai. Kā redzat, mūsu apņemšanās parādās tur. Tagad mēs saglabāsim visu šo darbu savā Github krātuvē, lai varētu izdzēst filiāli, kurai ir ieguldījums, kuru viņi jau ir pievienojuši projektam.

Tagad, kad mums ir atjaunināta Github krātuve, mēs izdzēsīsim savu filiāli, bet vispirms mēs pārliecināmies, ka tas atrodas mūsu galvenajā filiālē (kapteinis)

Kā redzat, man bija neliela kļūda, tas bija tāpēc, ka es biju savā myImovation filiālē, kad vēlējos izdzēst. Tas tiek novērsts, atgriežoties galvenajā filiālē.

Secinājums

Gatavs tik vienkārši. Tagad, kad esat apguvis Github tumšos noslēpumus PR sūtīšanai, es ceru redzēt jūsu ieguldījumu dažādos projektos. Un, ja vēlaties, varat atstāt savu pirmo PR manā repozitorijā 😉 atmiņai.

Es neesmu pieskāries tūkstoš un vienam Git pabalstam (EYE, nevis Github) un, kā jūs varētu sagaidīt no izstrādātājiem, kuri ir saistīti ar kodola kopienu, Git ir ārkārtīgi spēcīgs rīks ar simtiem funkciju.

Lai gūtu labāku priekšstatu par tā darbību un visu Git spēku, es to ļoti iesaku grāmata. Esmu pārliecināts, ka tas jums ļoti palīdzēs uzlabot jūsu rīcību ar git.

Sveiciens, un es ceru, ka tas jums palīdzēs 😉