Giti kasutamine PyCharmis

Siin juhendis eeldatakse, et teil on Giti salv loodud. Kui see pole tehtud, siis juhend on siin:Giti kasutamine TTÜs

Andmete import vanemast versioonist

Kui käivitate PyCharmi (uue versiooni) esimest korda, pakub ta importida vanu seadeid eelmisest installatsioonist:

../_images/pycharm_git_s1_import.png

Kui te eelnevalt PyCharmi pole kasutanud, siis pole vahet, mida siin valida.

Tingimustega nõustumine

Seejärel tuleb nõustuda kasutustingimustega:

../_images/pycharm_git_s2_agree.png

Litsents

Peate sisestama PyCharmi litsentsi andmed. TalTech arvutklassides valige License server. Seejärel peaks serveri aadress ise ilmuma. Kui ei ilmu, kirjutage http://license1.intra.ttu.ee:1111

../_images/pycharm_git_s3_license.png

Kui kasutate oma arvutit, siis saate logida sisse oma JetBrainsi kontoga või valige "Evaluate for free".

Seaded

PyCharm pakub teile võimalust seadistada väljanägemist:

../_images/pycharm_git_s4_configuration.png

Vaikimisi seaded sobivad. Neid saab hiljem alati muuta.

Welcome aken

../_images/pycharm_git_s5_welcome.png

Uus projekt Gitist

Loome uue projekti oma GitLab salvest:

../_images/pycharm_git_s6_git.png

Giti salve asukoht

Määrake oma salve asukoht. See on kujul: https://UNIID@gitlab.cs.ttu.ee/UNIID/iti0102-2020.git

UNIID asenda oma Uni-ID-ga.

https://cdn.discordapp.com/attachments/526124304035872798/617048443256569866/unknown.png

Te võite oma salve asukoha kopeerida ka GitLab keskkonnast, vajutades oma GitLabi projektis (UNIID/iti0102-2020) nupule Clone ning valides sealt 'Clone with HTTPS'. NB! UNIID asemel on sinu Uni-ID!

../_images/clone.png

Salve kättesaadavuse testimine

Kui olete salve asukoha sisestanud, vajutage "Test" nuppu. Teilt küsitakse kasutajanime ja parooli:

https://cdn.discordapp.com/attachments/526124304035872798/617050183863369782/unknown.png

Kui salv on kättesaadav, peaksite saama vastava teate:

https://cdn.discordapp.com/attachments/526124304035872798/617050703000502295/unknown.png

Projekti avamine

Kui olete giti salve kättesaadavuse ära testinud ning vajutanud nuppu "Clone", saate vastlaetud projekti avada:

../_images/pycharm_git_s10_open.png

Kausta loomine

Iga ülesanne algkursuse aines läheb eraldi kausta. Kausta nimi on näidatud ülesande juures. Kõige esimene ülesanne läheb näiteks kausta ex01_cashier. Suured ja väikesed tähed on erinevad! Ilmselt on praktikumiülesande kaust umbes selline pr01_python. All olevad pildinäited on ex01_cashier näitega.

Kaust looge projekt nime peal parema hiire klikiga, sealt New -> Directory:

../_images/pycharm_git_s10_1_new_directory.png

Kausta nimeks läheb ex01_cashier:

../_images/pycharm_git_s10_2_directory_name.png

Faili loomine

Ülesande lahendus läheb faili. Ülesande tekstis on kirjas, mis on faili nimi. Ehk siis täpsemalt paikneb esimese ülesande lahendus ex01_cashier/ex01_cashier.py failis. Esimese ülesande faili nimi peaks olema küll cashier.py aga selles näites on ex01_cashier.py.

Nüüd loome kausta sisse faili (ehk siis ülesande sisse lahenduse). Paremklikk kausta ex01_cashier peal, sealt New -> Python File

../_images/pycharm_git_s10_3_new_file.png

Paneme faili nimeks ex01_cashier. Tähelepanu, faililaiend .py lisatakse automaatselt!

../_images/pycharm_git_s10_4_file_name.png

Faili ettevalmistamine (add) Giti lisamiseks

Kui loote faili, küsib PyCharm teilt, kas soovite selle ette valmistada Giti lisamiseks. Mõistlik on siin vastata positiivselt.

../_images/pycharm_git_s10_5_git_add.png

Faili üles laadimine Giti

Selleks, et tehtud muudatus jõuaks GitLab serverisse (ja automaattester seda hinnata saaks), tuleb teha kaks asja: commit ja push.

Kausta peal parem hiireklikk -> Git -> Commit directory...

../_images/pycharm_git_s11_git_commit.png

Avaneb dialoog, kus saab eelvaadelda üleslaetavat koodi:

../_images/pycharm_git_s12_commit_dialog.png
Tasuks järgida selliseid asju:
  • üleval vasakul on failide nimekiri, mis üleslaadimisele lähevad. Mõistlik oleks laadida vaid vajalikud py-failid. Kõiksugu PyCharm konfiguratsioonifailid jms võivad tekitada segadust. Teisest küljest, kui kasutate kooliarvutit ja koduarvutit kordamööda, on võib-olla mõistlik ka PyCharmi konfiguratsioon Giti panna.

  • Commit Message võiks olla mõistlik. Me otseselt seda ei jälgi. Samas on hea ennast harjutada mõistlikke kommentaare lisama. Häid stiilinäiteid saab nt siit: https://chris.beams.io/posts/git-commit/

  • Check TODO "linnukese" võite maha võtta - kui see on peal, siis iga "TODO" kommentaar koodis annab hoiatuse.

  • Commit nupu noolekesest valida Commit and Push

Giti seaded

Kui te veel pole seda sammu täitnud, siis küsitakse teilt nime ja emaili:

../_images/pycharm_git_s13_set_conf.png

Failide üleslaadimine (push)

Lõpuks kuvatakse viimane samm (push). Seal vajutage lihtsalt Push:

../_images/pycharm_git_s14_push_dialog.png