PyCharm-dan istifadə edərək GitHub ilə işləmək

10.1 Repository-nin klonlanması

Xatırlayırsız, sizə faylların saxlandığı 3 yer haqqında danışmışdım? Yenə xatırladım: uzaq repository, lokal repository və işçi qovluq (working directory).

İndi isə sizdən tələb olunur ki, özünüzün yaratdığınız uzaq repository-ni (GitHub-da yaratdığınız) öz lokal repository-nizə (kompüterinizdəki) klonlayasınız.

Ona görə də PyCharm-ı başladın və başlayaq…

Adım 1. Açıq layihəni bağlayın. Və Clone Repository düyməsini basın

Adım 2. Uzaq repository-nizin url-ni göstərin, hansı ki, onu kompüterinizə klonlamaq istəyirsiniz.

Bu üsul birinin repository-sini klonlamaq istəyirsinizsə faydalıdır.

Əgər öz repository-nizi klonlayırsınızsa, daha asan şəkildə sadəcə PyCharm vasitəsilə GitHub-da daxil olun.

Layihəni seçin və Clone düyməsini basın

Adım 3. Heç kimə etibar etmək olmaz. Hətta özünüzə də.

PyCharm xəbərdarlıq edir ki, naməlum repository-lərdən kodu işə salmayın. Bu sizin öz repository-niz olduğuna görə "etibar et" seçimini işarələyin.

Adım 4. Əgər Windows istifadə edirsinizsə, standart antivirus sizə xəbərdarlıq edəcək ki, bəzi naməlum fayllar yaradılıb. Ümumiyyətlə antiviruslar naməlum proqramları sevmir.

ANCAQ! Biz həmin proqramları yaradacağıq, ona görə də IDE-dən antivirusunuza deyin ki, gələcək proqramlarınızı bloklamasın. "Automatically" düyməsinə basın, sonra — "YES".

10.2 İlk commit

Əgər təzə yaradılmış repozitoriyanı klonlamısınızsa, o, yalnız bir fayl daxilində olacaq — README.md

Adım 1. Faylı açın README.md.

Vacib! md uzantısı Markdown deməkdir – bu, mətn fayllarının sadə stilizasiyası üçün formatdır. Onun necə işlədiyini görmək üçün sağ yuxarı küncdəki düyməni basmaqla baxa bilərsiniz.

Bu faylı istəyinizə uyğun dəyişdirin: istənilən xoş bir mesaj və ya repozitoriyanın təsvirini yaza bilərsiniz...

Adım 2. Faylı dəyişdirdikdən sonra PyCharm sol tərəfdəki fayl ağacında onu mavi rəngdə göstərməyə başlayacaq. Mavi rəngdə işarələnmiş fayllar, əgər iş direktoriyasında edilmiş dəyişikliklər lokal repozitoriyaya əlavə edilməyibsə, dəyişdirilmiş fayllardır.

Adım 3. Commit.

Fayla və ya fayllara bütün planlaşdırılmış dəyişiklikləri etdikdən sonra (və doğruluğundan əmin olduqdan sonra), onları lokal git-repozitoriyanızda əlavə etməlisiniz. Hələ ki, onlar yalnız işçi qovluğunuzda yerləşir.

Bunun üçün Commit düyməsini basmalı, dəyişiklik etmək istədiyiniz bütün faylları işarələməli və dəyişikliklərinizi təsvir edən bir şərh əlavə etməlisiniz:

Adım 4. Və «Commit» düyməsini basın.

Adım 5. Yoxlama.

Layihəyə keçid edin və faylların rəngini yoxlayın: əgər fayllar artıq mavi işıqlanmırsa, bu, o deməkdir ki, iş direktoriyasındakı bütün dəyişikliklər uğurla lokal repozitoriyanıza əlavə edilib.

10.3 Fayllarla işləmək

Addım 1. Gəlin PyCharm-da bir fayl yaradaq.

Biz axı Python-da kod yazırıq — qoy bu fayl main.py olsun

Addım 2. Faylı yerli repositoriya əlavə edirik.

PyCharm fayl yaratdığınızı görən kimi onu dərhal sizin yerli repositoriyanıza əlavə etmək təklif edəcək. PyCharm yalnız işçi direktoriyanızda olan və artıq yerli repositoriyanıza əlavə edilmiş fayllardakı dəyişiklikləri izləyir. Yalnız bu fayllar mavi rənglə qeyd olunacaq.

Əgər fayl işçi direktoriyanızdadırsa, amma yerli repositoriyada deyilsə, o qırmızı rənglə qeyd olunur, aşağıdakı şəkil kimi:

Əslində siz həmişə Add düyməsini basa bilərsiniz, amma bu dəfə Cancel düyməsini basıb faylı əl ilə əlavə edək. Beləliklə, bunu necə edəcəyinizi yadda saxlayacaqsınız.

Addım 3. Faylda sevdiyiniz kodu yazın.

Məsələn, mən yazdım: print("first commit")

Addım 4. İndi gəlin main.py faylını yerli repositoriyaya əlavə edək.

Sadəcə faylın istənilən yerində sağ düymə ilə klikləyin və Git -> Add File seçin.

Əgər hər şey müvəffəqiyyətlə keçibsə, əlavə olunan fayl yaşıl rənglə işarələnəcək.

Addım 5. Daha sonra faylı köhnə sxem üzrə commit edirik:

10.4 İlk push

İndi biz yerli repository-də etdiyimiz dəyişiklikləri GitHub-dakı uzaq repository-ə yükləməliyik. Bir neçə proqramçı bir layihə üzərində işləyərkən, onlar kod dəyişikliklərini bu yolla sinxronlaşdırırlar.

Adım 1. Push düyməsinə klikləyirik.

Əslində bunu etmək çox asandır: IDE-nin yuxarı menyusundakı Push düyməsindən istifadə etməlisiniz:

Adım 2. Edilən commitlər təsdiqlənir.

Bu addımda siz edilən bütün dəyişiklikləri görə və təsdiq edə bilərsiniz ki, təsadüfən vacib bir şeyi sındırmamısınız. Və ya digər fayllardan asılı olan bir faylı əlavə etməyi unutmamısınız.

Adım 3. Yoxlayırıq.

Əgər hər şey uğurla keçdisə, aşağıdakı tip mesajları görəcəksiniz:

Adım 4. İndi GitHub repository-nizi açın və yoxlayın:

Texnologiyanın sehridir!

10.5 .gitignore fayllarının istifadəsi

Əgər layihənizdə hansısa servis faylları əlavə etmisinizsə və onların təsadüfən repozitoriyaya düşməsini istəmirsinizsə, onları istisna siyahısına əlavə edə bilərsiniz. Bunun üçün .gitignore adlı bir fayl mövcuddur. Bu, xüsusilə layihədə saxlanılmalı olmayan fayllar (məsələn, müvəqqəti fayllar, loglar, parollar) olduqda çox əlverişlidir.

Addım 1. Əvvəlcə layihənizdə nəzərə alınmamalı olan bir fayl yaradın. Məsələn, istənilən adla .txt fayl yaradın. Faylı yaratdıqdan sonra Cancel klikləyin.

Addım 2. "Project" pəncərəsində yaradılmış hacky_fix_that_somehow_works.txt faylına sağ klikləyin. Git --> Add to .gitignore --> Add to .gitignore keçidini edin. Bu seçim, seçilmiş faylı layihənizin kökündəki .gitignore faylına əlavə edəcək.

Addım 3. Layihənizdə .gitignore faylı yaradın. Repozitoriya yaradılarkən biz .gitignore faylı yaratmamışdıq.

PyCharm avtomatik olaraq hacky_fix_that_somehow_works.txt faylını sizin .gitignore faylınıza əlavə edəcək.

.gitignore faylına əlavə edildikdən sonra, fayllar qəhvəyi rəngdə göstəriləcək. Dəyişiklikləri əlavə etmək cəhdində bu fayllar nəzərə alınmayacaq.

.gitignore yalnız indiyə qədər commit olunmamış fayllara təsir edir. Əgər fayl artıq commit edilibsə, onu nəzərə almamaq üçün əvvəlcə onu repozitoriyadan silmək lazımdır.

.gitignore faylını Git repozitoriyasına commit etməyi və dəyişiklikləri GitHub-a göndərməyi unutmayın ki, layihədə olan hər kəs eyni qaydaları istifadə etsin.

Lokal faylların xaric edilməsi .git/info/exclude

Layihənin bütün istifadəçiləri üçün nəzərdə tutulmuş .gitignore faylından əlavə, Git yalnız sizin lokal layihənizdə tətbiq edilməsi üçün nəzərdə tutulmuş .git/info/exclude faylını yaratmağa imkan verir.

Bu fayl, məsələn, IDE tərəfindən yaradılmış faylları nəzərə almamaq üçün faydalı ola bilər.

Vacib! Lokal xaric etmə qaydaları yalnız sizin lokal repozitoriyanız üçün keçərlidir.

.gitignore üçün qaydalar

.gitignore faylında git-in nəzərə almamalı olduğu fayl və qovluqların ad şablonları göstərilir.

Boş sətirlər nəzərə alınmır. Şərh əlavə etmək üçün sətiri # simvolu ilə başlayın.

Şablonlar:

• * - istənilən sayda hər hansı simvolları əvəz edir. Məsələn, *.log bütün .log genişlənməsinə malik faylları nəzərə almır.
• ? - bir simvolu əvəz edir. Məsələn, temp?.txt temp1.txt, temp2.txt və s. faylları nəzərə almır.
• [] - simvol diapazonunu göstərir. Məsələn, [abc] a, b və ya c simvollarından hər hansı birinə uyğun gəlir.
• ! - şablona uyğun gələn faylları istisna edir. Məsələn, !important.txt, hətta *.txt qaydası olsa belə, important.txt faylını izləyəcək.
• / - şablonun əvvəlində repozitoriyanın kökünü göstərir. /temp/ repozitoriyanın kökündəki temp qovluğunu nəzərə almır.
• ** - istənilən sayda iç-içə qovluqlara uyğun gəlir. Məsələn, **/temp, istənilən səviyyədəki temp qovluqlarını nəzərə almır.

Fayl nümunəsi

# Bayt kodu
*.pyc
**/__pycache__/
*.pyo
*.pyd

# Parol və gizli məlumat faylları
.env
credentials.json

# Müvəqqəti fayllar
*.tmp
*.swp
*~

# Loglar
logs/*
*.log

# PyCharm tərəfindən yaradılan qovluqlar
.idea/
*.iml

# Test üçün qovluqlar
tests/
test/

# Virtual mühitlər
venv/
env/

# Layihə paketləndikdə yaranan fayllar
dist/
build/
*.egg-info/

Hazır şablonlar

1. Fərqli proqramlaşdırma dilləri və inkişaf mühitləri üçün .gitignore kolleksiyası: https://github.com/github/gitignore
2. gitignore.io - .gitignore faylları yaratmaq üçün veb-servis