Giti kasutamine PyCharmis

Siin juhendis eeldatakse, et teil on Giti salv loodud. Selle jaoks leidub juhend siin: Giti kasutamine TTÜs

Welcome aken

../_images/pycharm_setup_welcome.png

Uus projekt Gitist

Loome uue projekti oma GitLab salvest klikates Get from VCS:

../_images/pycharm_git_vcs.png

Giti salve asukoht

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

UNIID asenda oma Uni-ID-ga.

../_images/pycharm_git_repository.png

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

../_images/clone.png

Salve kloonimine

Kui olete salve asukoha sisestanud, vajutage akna all leiduvat Clone nuppu. Teilt küsitakse kasutajanime ja parooli:

../_images/pycharm_git_login.png

Log In nupule vajutades laeb PyCharm teie projekti arvutisse alla ning avab selle arendamiseks. Kui mingil põhjusel läheb parool kaks korda valesti ning logimise aken kaob ilma teateta, tasuks lihtsalt uuesti proovida

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_create_dir.png

Kausta nimeks läheb ex01_cashier:

../_images/pycharm_create_dir_dialog.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_create_file.png

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

../_images/pycharm_create_file_dialog.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_add_file_to_git.png

Vajadusel saab ka käsitsi lisada, failile parem hiireklikk -> Git -> Add

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_commit_directory.png

Avaneb dialoog, kus saab eelvaadelda üleslaetavat koodi:

../_images/pycharm_commit_dialog.png
Tasuks järgida selliseid asju:
  • Tekkinud aknaosa üleval 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 ning ka endal on pärast kergem ajaloost otsida. Häid stiilinäiteid saab nt siit: https://chris.beams.io/posts/git-commit/

  • 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_name_dialog.png

Failide üleslaadimine (push)

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

../_images/pycharm_push_dialog.png

Kiirnupud Git kasutamiseks

Kui avatud PyCharm projekt kasutab Git'i, siis tekivad selle jaoks akna paremale üles nurka nupud tüüpilisemate käskluste jaoks.

../_images/pycharm_git_buttons.png
Sinine nool alla

Tirib GitLab'ist tehtud muudatused sinu arvutisse. On kasulik, kui soovid koolis tehtud töid koju alla laadida või vastupidi. Sellele klikates avaneb kaks varianti: Rebase viib sinu seisu pilves olevate muudatuste otsa, Merge aga üritab kokku liita erinevused mõlemate vahel. Üldjuhul oleme kursuse jooksul algajatel soovitanud kasutada Rebase, kuna see tekitab vähem segadusi. Lisavaatamist

Roheline linnuke

Commit ning kõige tihedamini kasutatum Git'i funktsionaalsus. See on Git'i versioon salvestamisest, kus säilitatakse praegune seis koos lühikirjeldusega.

Roheline nool üles

Push laeb üles kõik kohalikud commitid. PyCharm võimaldab commit ajal koheselt ka push teha, seega seda nuppu ei ole vaja ilmtingimata eraldi vajutada.

Kell

Näitab commitide ja hargude ajalugu. Neile peale klikates saab võrrelda muutusi praeguse seisuga.

Rollback

Taastab failide seisu eelmise commit'ini.