1. tēma: 1.4 Failu sistēma un organizācija

Tavs šīs stundas izaicinājums: Izprast projektu struktūras nozīmi, strukturēt savus koda failus apakšmapēs un konfigurēt izņēmumus, izmantojot .gitignore failu.

2.4.12. Sagatavo un konfigurē programmēšanas vidi.
2.4.9. Lieto versiju pārvaldības sistēmas (Git).

Teorija: Kārtība projektā un .gitignore

Profesionālos projektos faili netiek glabāti vienā lielā mapē. Tos organizē loģiskās struktūrās, izmantojot apakšmapes un ceļus (Paths). Lai GitHub mākoni nepiesārņotu ar liekiem failiem, izmanto īpašu sistēmas failu.

Projekta sakne (Root directory): Tava projekta galvenā mape (mūsu gadījumā — krātuve programmesana-pamatkurss). Tajā atrodas visas pārējās mapes.
Relatīvie ceļi (Relative paths): Norāde uz failu attiecībā pret vietu, kur Tu pašlaik atrodies. Piemēram, uzdevumi/diena1.py nozīmē "diena1.py fails, kas atrodas mapē uzdevumi".
.gitignore: Teksta fails, kurā uzskaitīti faili vai mapes, kurus Git sistēmai vajadzētu "ignorēt" (neuzskaitīt un nesūtīt uz GitHub). Tie parasti ir personīgie piezīmju faili, paroles vai programmu ģenerētie pagaidu faili.

1. uzdevums: Projekta mapju struktūras izveide

Sakārtot savu GitHub krātuvi, izveidojot loģisku apakšmapju sistēmu turpmākajam mācību gadam.

Izpildes soļi:

Atver VS Code savu klonēto programmesana-pamatkurss mapi.
Kreisajā sānjoslā (Explorer) izveido trīs jaunas mapes (ikona New Folder): teorija, uzdevumi un projekti.
Ar peli "paņem" un ievelc savu iepriekšējā stundā izveidoto diena1.py failu iekš mapes uzdevumi. Ja VS Code jautā apstiprinājumu faila pārvietošanai, spied "Move".
Atver GitHub Desktop un aplūko Changes logu. Ievēro, ka programma ir fiksējusi faila pārvietošanu (veco lokāciju atzīmējot ar mīnusu, jauno ar plusu).

2. uzdevums: .gitignore faila izveide un testēšana

Izveidot noteikumus, lai pasargātu noteiktus failus no nejaušas augšupielādes mākoņkrātuvē.

Izpildes soļi:

VS Code projekta saknes mapē (blakus README failam) izveido jaunu failu ar precīzu nosaukumu: .gitignore (neaizmirsti punktu pašā sākumā!).
Šajā failā ieraksti vienu vārdu: noslepums.txt un saglabā (Ctrl+S).
Izveido jaunu teksta failu ar nosaukumu noslepums.txt. Ieraksti tajā jebkādu tekstu un saglabā.
Atver GitHub Desktop. Apskati, kādi faili ir redzami Changes sarakstā.
Svarīgi: Sarakstā vajadzētu parādīties failam .gitignore, bet fails noslepums.txt tur nedrīkst būt. Sistēma to sekmīgi ignorē!

3. uzdevums: Izmaiņu fiksēšana (Commit & Push)

Nofiksēt jauno failu struktūru un izņēmumu noteikumus, nosūtot tos uz GitHub.

Izpildes soļi:

Pārliecinies, ka GitHub Desktop sarakstā ir atzīmēti .gitignore faila pievienošana un tava Python faila pārvietošana.
Summary laukā ieraksti aprakstu: "Izveidota mapju struktūra un pievienots gitignore".
Nospied Commit to main.
Nospied Push origin, lai nosūtītu izmaiņas uz internetu.
Dodies uz savu GitHub profilu pārlūkprogrammā un pārbaudi, vai jaunās mapes un .gitignore fails ir redzami publiski. Fails noslepums.txt tur nebūs!

Papildus uzdevums: Mapju (Directories) ignorēšana

Pielāgot .gitignore failu, lai tas izslēgtu veselu mapi, nevis tikai atsevišķu failu.

Izpildes soļi:

VS Code izveido jaunu mapi ar nosaukumu pagaidu_dati.
Ieliec tajā jebkādu jaunu Python vai teksta failu.
Atver savu .gitignore failu un jaunā rindiņā ieraksti pagaidu_dati/ (slīpsvītra beigās norāda, ka tā ir mape).
Pārbaudi GitHub Desktop — visai šai mapei un tās saturam jābūt ignorētam. Nofiksē un augšupielādē atjaunināto .gitignore failu.

Biežākās kļūdas (un kā tās labot):

Aizmirsts punkts: Faila nosaukumam jābūt tieši .gitignore. Ja to nosauksi par gitignore.txt vai gitignore, sistēma to neatpazīs kā versiju kontroles noteikumu failu.
Nepareiza atrašanās vieta: .gitignore failam ir jāatrodas projekta pašā galvenajā mapē (saknē). Ja ieliksi to apakšmapē, tas darbosies tikai uz to konkrēto mapi.
Mēģinājums ignorēt jau nofiksētus failus: .gitignore strādā tikai uz failiem, kas vēl nav tikuši uztaisīti par Commit. Ja fails jau iepriekš tika augšupielādēts, tā pievienošana .gitignore failam viņu automātiski neizdzēsīs no GitHub mākoni.

Koda piemērs: Kā izskatās klasisks .gitignore fails

# Ar tēmturi (#) arī šeit var rakstīt komentārus
# Ignorēt konkrētu failu:
noslepums.txt
paroles.csv

# Ignorēt visus failus ar konkrētu paplašinājumu (piem., attēlus):
*.jpg
*.png

# Ignorēt veselu mapi:
pagaidu_dati/
__pycache__/

Visi faili un mapes, kas atbilst šiem noteikumiem, tiks paslēpti no GitHub Desktop acīm un paliks tikai tavā personīgajā datorā.