Лесен урок, за да направите своя първи PR (Искане за изтегляне)

Е, този мисля, че ще бъде доста кратък урок и надявам се дидактичен;). Ще направя малко хранилище на ваше разположение на моя github, за да можете да изпращате вашите PR и едновременно, така че да можете да се упражнявате как да правите всички стъпки, които ще оставя по-долу. Ето връзката, за да направите своя тестов PR:

https://github.com/CodeLabora/TuPrimerPR

Е, нека бързо изброим стъпките, необходими за изпращане на PR:

1. Вилица
2. Clone
3. Дистанционно управление
4. Клон
5. промени
6. Добави
7. Поемане на ангажимент
8. Тласък
9. PR

Поставям ги на английски, за да намерят съответните опции в командния ред на git.

Вилица

Форк е вашата собствена версия на хранилище на Github. Това ви позволява да клонирате работата на друг проект и да го имате във вашия акаунт, така че да можете да променяте нещата, без да се притеснявате, че ще загубите промените си. За да направите вилица е необходимо само да отидете на страницата и да кликнете върху бутона Fork, който е в горната дясна част.

След като разклонението приключи, ще видите, че хранилището се появява във вашия акаунт.

Clone

Сега, след като разполагаме с хранилище, ще го клонираме към нашия екип. (Предполагам, че хората, които използват Linux, ме следват, но за потребители на други системи има и версии на git, които можете да изтеглите на официалната им страница.

И с нашия терминал правим следното.

С това ще имаме нова папка, наречена TuPrimerPR, в която ще бъде нашият проект Github. Влизаме в папката с командата «cd TuPrimerPR» и ще видим, че вътре са файловете, които са в нашата вилица.

(Обърнете внимание, че броят на файловете може да варира в зависимост от това, което намират в хранилището ми, когато се разклоняват)

Дистанционно управление

Това е незадължителна стъпка, но такава, която избягва много проблеми при непрекъсната работа по проект. Fork по подразбиране създава точно копие на хранилището, но в точния момент на създаване. Това означава, че ако проектът продължи да напредва, вашето хранилище ще изостане с изминаването на дни или часове. „Git remote“ ни позволява да посочим друга точка за изтегляне (оригиналния проект) и по този начин да можем да актуализираме проекта си всеки път, когато видим, че родителският проект се актуализира.

За да намерите вашия родителски проект, просто трябва да използвате връзката, която е точно под името на вашето хранилище. (Проверете второто изображение на раздела Fork). Ще добавим тази информация по-долу:

Това е оригиналният проект (ще го наречем срещу течението за да сте в крак с много проекти).

Както можете да видите, добавих дистанционното с »git remote add »

С това ще можем да актуализираме проекта, когато е необходимо, но няма да го използваме сега, защото не е необходимо. (Ще го обясня по-късно или в друга публикация, в зависимост от нуждата)

Клон

Клоновете (или клоновете) ви позволяват да създавате секции с код, които можете да работите в изолирана среда. Това означава, че това, което правите в клон, не засяга непременно оригиналния код, докато не се използва „git merge“. Освен това е допълнителна функционалност, която Github ви позволява, всеки път, когато създавате клон, Github автоматично генерира източника на искане за изтегляне, когато е необходимо.

Сега, когато сме в нашия специален клон, можем да работим върху нашия принос.

промени

Ще добавя няколко файла, за да можете да видите как се прави.

"Touch" ни позволява да създадем празен файл (ако не съществува). с това можем да преминем към следващата ни стъпка.

Добави

»Git add» ни позволява да добавяме файлове към нашия коммит (ще обясня по-късно). За да видите какви файлове можете да добавите, можете да използвате командата »git status»

С това имаме всичко готово за нашия ангажимент

Поемане на ангажимент

Ангажиментите са марки (или етапи) във времето. те определят състояние за всички файлове в проекта и натрупват промените, необходими, за да стигнат от началото на проекта до текущото състояние. Звучи малко сложно, но е съвсем просто, просто не забравяйте, че те са стълбите на вашия проект. Пишем »git commit» и ще получим прозорец за писане на нашето съобщение за фиксиране.

И когато завършваме и запазваме текста, ще видим нещо като:

Където е показано обобщение на това, което прави ангажиментът.

Тласък

С push ние качваме в нашия акаунт в Github всички ангажименти, които имаме на компютъра, които не са в нашето хранилище в интернет. Това ще позволи на Github да генерира новия PR автоматично.

Забележете, че използваме името на нашия клон и че той ни пита за потребителско име и парола. Накрая ни показва, че клонът myImprovement е създаден в нашия акаунт в Github. Нека да видим какво сме постигнали в браузъра. 😉

PR

Както можете да видите, създаден е нов ред, който казва „Заявка за сравнение и изтегляне“. Тази функционалност на Github ни позволява да създадем PR по прост начин, ще щракнем, за да видим какво се случва.

Github е доста умен. Както можете да видите, части от ангажимента се добавят към формуляра за изпращане. Необходимо е само да щракнете върху бутона и това е. 🙂 Просто.

екстра

Това е зад кулисите на проектите, появява се PR и мениджърът решава дали да приеме или не, или да напише още съобщения. В моя случай ще го приема незабавно.

След като обединението приключи, те ще могат да видят дневника на ангажиментите на проекта и да видят името си в него.

Но сега имаме проблем. Този ангажимент не се появява в Nuestro хранилище, само в проекта. Помните ли отдалечения ни проход? Сега е, когато се отплати 🙂

Връщаме се към нашия главен клон и правим следното:

С това изтеглихме цялата информация от оригиналния проект на нашия екип. Както можете да видите, нашият ангажимент се появява там. Сега ще запазим цялата тази работа в нашето хранилище на Github, за да можем да изтрием клона, който има приноса, който те вече са добавили към проекта.

След като имаме актуализираното хранилище на Github, ще изтрием нашия клон, но първо се уверяваме, че е вътре в нашия основен клон (master)

Както можете да видите, имах лека грешка, това беше, защото бях в моя клон myImprovement, когато исках да изтрия. Това се поправя чрез връщане към главния клон.

Заключение

Готово 🙂 толкова просто. Сега, когато сте усвоили тъмните тайни на Github за изпращане на PR, очаквам с нетърпение да видя вашите приноси в различни проекти. И ако искате, можете да оставите първия си PR в хранилището ми 😉 за запомняне.

Не съм докоснал хиляда и една полза от Git (Охо, а не Github) и както бихте очаквали от разработчици, които са обвързани с общността на ядрото, Git е изключително мощен инструмент със стотици функции.

За да получите по-добра представа за това, което прави и цялата мощ на Git, горещо препоръчвам това книга. Сигурен съм, че ще ви помогне много за подобряване на работата с git.

Поздрави и се надявам да ви помогне 😉