6.3 GitHub - Bir Layihənin Saxlanılması

Kimsə gəlir və kodunuza dəyişiklik edir və Pull Request göndərir. Yeni Pull Request barədə sizi xəbərdar edən bir e-poçt almalısınız və bu Yeni Pull Request barədə e-poçt bildirişi kimi bir şey görünməlidir.

Bu e-poçtla əlaqəli bir neçə şey var. Kiçik bir diffstat verəcəkdir - Pull Request-da nə qədər dəyişdiyiniz sənədlərin siyahısı. GitHub üzərindəki Pull Request-ə bir link verir. Ayrıca, əmr sətrindən istifadə edə biləcəyiniz bir neçə URL verir.

git pull <url> patch-1 deyilən xətti görsəniz, bu, uzaq bir branch-a qoşulmanın sadə bir yoldur. Biz bu işi tez bir zamanda Uzaq Branch’ları Yoxlamaq-də keçdik. İstəyirsinizsə, bir mövzu branch-ı yarada və həmin branch-a keçə bilərsiniz və sonra Pull Request dəyişikliklərində birləşmək üçün bu əmri işlədə bilərsiniz.

Digər maraqlı URL-lər .diff və .patch URL-ləridir, ehtimal ki, Pull Request-nin vahid diff və patch versiyalarını təmin edir. Texniki olaraq Pull Request işini bu kimi bir şeylə birləşdirə bilərsiniz:

GitHub Axını-da bəhs etdiyimiz kimi Pull Request-ni açan şəxslə söhbət edə bilərsiniz. Hər yerdə GitHub Flavored Markdown istifadə edərək kodun müəyyən sətirlərini şərh edə bilərsiniz, bütün commit-ləri şərh edə bilərsiniz və ya Pull Request-in özünə şərh verə bilərsiniz.

Pull Request-nə başqaları hər dəfə rəy verdikdə fəaliyyətin baş verdiyini bildiyiniz üçün e-poçt bildirişləri almağa davam edəcəksiniz. Onların hər birində fəaliyyətin baş verdiyi yerdən Pull Request-ə bir keçid olacaq və siz də Pull Request mövzusuna şərh vermək üçün e-poçta birbaşa cavab verə bilərsiniz.

Kod istədiyiniz yerdə olanda və onu birləşdirmək istədikdə daha əvvəl gördüyünüz git pull <url> <branch> əmri ilə və ya kodu əlavə edərək local olaraq və ya fork ilə uzaqdan fetch edə, birləşdirə bilərsiniz.

Birləşmə mənasızdırsa, GitHub saytındakı “Merge” düyməsini vura bilərsiniz. Bu sürətli bir irəli daxil olma ehtimalı olsa belə, birləşmə əməliyyatı yaradaraq, “sürətli olmayan irəli” birləşməsini həyata keçirəcəkdir. Bu o deməkdir ki, nə olursa olsun, birləşmə düyməsini vurduğunda, birləşmə əməliyyatı yaradılır. Birləşdirmək düyməsini və Pull Request-in manual birləşməsi üçün təlimatları da gördüyünüz kimi, işarə bağlantısını vurursanız, GitHub bu məlumatların hamısını verir.

Birləşdirmək istəmədiyinizə qərar verdiyiniz təqdirdə yalnız Pull Request-i bağlaya bilərsiniz və bu onu açan şəxsə bildiriləcəkdir.

Pull Request-lərin bir çoxu ilə məşğul olursunuzsa və bir qrup uzaqdan əlavə etmək və ya hər səfərində bir dəfə pull etmək istəmirsinizsə, GitHub-ın etməynizə sizə imkan verəcək səliqəli bir hiylə var. Bu bir az inkişaf etmiş bir hiylədir və bunun təfərrüatlarını bir az daha Refspec-də araşdıracağıq, bu olduqca faydalı ola bilər.

GitHub, əslində serverdəki pseudo-branch-lar kimi bir depo üçün Pull Request branch-larını reklam edir. Varsayılan olaraq, onları klonladığınız zaman almırsınız, ancaq gizli bir şəkildə var və onlara olduqca asanlıqla daxil ola bilərsiniz.

Bunu nümayiş etdirmək üçün ls-remote adlı aşağı səviyyəli bir əmrdən (daha çoxPlumbing və Porcelain-də oxuyacağımız bir “plumbing” əmri olaraq xatırlanır.) istifadə edəcəyik. Bu əmr ümumiyyətlə gündəlik Git əməliyyatlarında istifadə edilmir, lakin serverdə hansı istinadların mövcud olduğunu bizə göstərmək faydalıdır.

Bu əmri əvvəllər istifadə etdiyimiz “yanıb-sönmə” deposuna qarşı işləsək, depodakı bütün branch-ların və etiketlərin və digər istinadların siyahısını alacağıq.

Əlbəttə ki, depo içərisindəsinizsə və git ls-remote origin və ya yoxlamaq istədiyiniz hər hansı bir uzaqdan çalışırsınızsa, bu sizə bənzər bir şey göstərəcəkdir. Depo GitHub-dadırsa və açılan hər hansı bir Pull Request-ləriniz varsa, refs/pull/ ilə prefiks edilmiş bu istinadları alacaqsınız. Bunlar əsasən branch-lardır, amma refs/heads/ altında olmadığından onları klonlaşdırdıqda və ya serverdən götürəndə normal qəbul etmirsiniz - fetching prosesi onları normal qəbul etmir.

Pull Request-ə iki müraciət var - /head nöqtəsində sonu Pull Request branch-dakı sonuncu commit-lə eyni.

Beləliklə, kimsə depoda Pull Request açsa və onların branch-ı bug-fix adlanırsa və a5a775 əməliyyatını göstərirsə, onda bizim depoda bug-fix branch-ı olmayacaq (çünki bu onların fork-larıdı), amma biz a5a775 işarəsini verən pull/<pr#>/head olacaqdır. Bu o deməkdir ki, uzaqdan bir qrup əlavə etmədən hər Pull Request branch-ını bir dəfəyə asanlıqla pull down edə bilərik.

İndi referansı birbaşa fetching edə bilərsiniz.

Bu, Git-ə ‘` origin remote-a qoşulun və refs/pull/958/head adlı ref-i yükləyin.’' Git xoşbəxt şəkildə itaət edir və bu ref düzəltmək üçün lazım olan hər şeyi yükləyir və .git/FETCH_HEAD altından istədiyiniz commit-ə göstərici qoyur. Bunu test etmək istədiyiniz bir branch-a git merge FETCH_HEAD ilə təqib edə bilərsiniz, lakin bu birləşmə mesajı bir az qəribə görünür. Ayrıca, çox pull request-ləri nəzərdən keçirirsinizsə, bu yorucu olur.

Pull request-lərin hamısını fetch etməyin və uzaqdan əlaqə qurduğunuz zaman onları yeniləməyin bir yolu da var. Sevdiyiniz redaktorda`.git/config` açın və uzaqdan origin-i axtarın. Bu belə görünməlidir:

fetch = ilə başlayan xətt “refspec.”-dir. Bu uzaqdakə adları local .git qovluğunuzdakı adlarla çəkilməsinin bir yoludur. Bu, xüsusilə Git-ə "uzaqdan idarə olunanlar refs/heads altındakı şeylər local depolarımda refs/remotes/origin altında getməlidir." deyir. Bu hissəni başqa bir refspec əlavə etmək üçün dəyişdirə bilərsiniz:

Bu son sətir Git’ə ‘` refs/pull/123/head kimi görünən bütün istinadlar,refs/remotes/origin/pr/123 kimi local olaraq saxlanılmalıdır.’' İndi həmin faylı yadda saxlasanız, git fetch edin:

İndi uzaqdan pull request-lərin hamısı local olaraq, branch-ları izləyən branch-lar kimi təmsil olunur; yalnız oxuyursunuz və fetch etdiyiniz zaman yeniləyirlər. Bu, local bir pull request-də kodu sınamağı asanlaşdırır:

Aranızdakı qartal gözlü, refspecin uzaq hissəsinin sonundakı head hissəsini qeyd edəcək. GitHub tərəfində refs/pull/#/merge ref də var, saytdakı “merge” düyməsini basdığınız zaman nəticəni təmin edəcəkdir. Bu, düyməni vurmadan əvvəl birləşməni sınamağa imkan verə bilər.

Yalnız əsas və ya master branch-nı hədəf alan Pull Request-ləri deyil, həm də şəbəkədəki istənilən branch-ı hədəf alan Pull Request aça bilərsiniz. Əslində, başqa bir Pull Request-i də hədəfə ala bilərsiniz.

Əgər düzgün istiqamətdə irəlilədiyini görsəniz və ona bağlı bir dəyişiklik üçün bir fikriniz varsa və ya yaxşı bir fikir olduğuna əmin deyilsinizsə və ya sadəcə hədəf branch-ına push etmək imkanı yoxdursa, birbaşa Pull Request aça bilərsiniz.

Pull Request açdığınız zaman, səhifənin yuxarısında hansı branch-ı pull etmək istədiyinizi və haradan pull etmək istəyinizi göstərən bir qutu var. Həmin qutunun sağındakı “Edit” düyməsini vurursanız, nəinki branch-ları, həm də fork-ları da dəyişdirə bilərsiniz.

Burada yeni branch-ınızı başqa bir Pull Request-ə və ya layihənin başqa bir fork-una birləşdirmək üçün asanlıqla göstərə bilərsiniz.

GitHub ilə əlaqədar burada “bildirişlər” dedikdə GitHub-da hadisələr baş verdikdə sizinlə əlaqə qurmağa çalışdıqlarını və onları konfiqurasiya edə biləcəyiniz bir neçə fərqli yol olduğunu söyləyirik. Parametrlər səhifəsindəki “Notification center” bölməsinə keçsəniz, əlinizdə olan bəzi variantları görə bilərsiniz.

İki seçim, “E-poçt” və “Web” üzərindən bildirişlər almaqdır və işlərdə fəal iştirak etdiyiniz zaman və seyr etdiyiniz depolardakı fəaliyyət üçün ya birini ya da ikisini də seçə bilərsiniz.

Standart branch kimi “master” dən başqa bir branch istifadə edirsinizsə, insanların Pull Request-ləri açmasını və ya vrasayılan olaraq görməsini istəyirsinizsə, bunu “Options” bölməsində deponun parametrlər səhifəsində dəyişə bilərsiniz.

Açılan menudan standart branch-ı dəyişdirin və o zamandan etibarən bütün əsas əməliyyatlar üçün, o cümlədən kiminsə deponu klonlaşdırdıqda bu barnch-ın yoxlanılması da daxil olmaqla standart olacaqdır.

Bir layihəni GitHub-dakı başqa bir istifadəçiyə və ya bir təşkilata köçürmək istəyirsinizsə, bunu etməyə imkan verən depo parametrləri səhifənizin eyni “Options” bölməsi altındakı “Transfer ownership” seçimi var.

Bir layihədən imtina edirsinizsə və kimsə onu öz üzərinə götürmək istəyirsə və ya layihəniz böyüyürsə, onu bir təşkilata keçirməyiniz daha faydalıdır.

Bu, təkcə bütün izləyiciləri və ulduzları ilə birlikdə deponu başqa yerə köçürmür, eyni zamanda URL-dən yeni yerə yönləndirmə qurur. Bu, yalnız veb sorğularını deyil, Git-dən klonları və alış-verişi yönləndirəcəkdir.