›_ ebskola.lv
← 1.3 1.5 →

1.4 Failu sistēma un organizācija

Stundas uzdevums: 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).

70 min darba sadalījums: 1. uzdevums (~20 min) - atjauno teorijas piemēru vai minimālo prototipu; 2. uzdevums (~25 min) - pielieto to galvenajā uzdevumā; 3. uzdevums (~25 min) - pārbaudi rezultātu, izlabo kļūdas un tikai beigās pieraksti vienu secinājumu. Papildus/4. līmeņa uzdevums ir paredzēts tikai tad, ja pamatdarbs ir pabeigts.

Pirms sāc: izmanto iepriekš apgūto un šīs lapas teorijas/koda piemērus. Ja vajadzīga jauna komanda vai rīks, vispirms atrodi tās paraugu teorijas sadaļā.

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.

Praktiskie uzdevumi

1. uzdevums - Iesildies ar gatavu piemēru

Šis ir īss iesildīšanās uzdevums. Nokopē sagatavi, ielīmē to pareizajā koda vietā un palaid. Šeit pietiek droši izmēģināt tēmu 1.4 Failu sistēma un organizācija; detalizētu izpratni veidosi nākamajos uzdevumos.

Kopējamais piemērs vai sagatave: izmanto šo bloku kā starta punktu, nevis kā gala risinājumu.

mkdir iesildisanas-projekts
cd iesildisanas-projekts
code main.py
temats = "1.4 Failu sistēma un organizācija"

print("Iesildīšanās sākta")
print("Tēma:", temats)
print("Kods darbojas")
  1. Atver darba failu vai rīku. Komandas izpildi terminālī, bet Python piemēru ievieto main.py failā.
  2. Nokopē visu piemēra bloku no šī uzdevuma un ielīmē to norādītajā vietā.
  3. Palaid kodu tieši tādu, kāds tas ir, un pārliecinies, ka parādās rezultāts, izvade vai vismaz nav kļūdas paziņojuma.
  4. Atrodi vienu drošu vietu, ko drīkst mainīt: tekstu, skaitli, krāsu, mainīgā vērtību vai testa ierakstu.
  5. Maini tikai šo vienu vērtību un palaid kodu vēlreiz.
  6. Salīdzini rezultātu pirms un pēc izmaiņas. Ja parādās kļūda, atcel pēdējo izmaiņu un palaid vēlreiz.
  7. Turpini pie 2. uzdevuma tikai tad, kad šis mazais piemērs darbojas.

2. uzdevums - Ievieto algoritmu projektā

Pievieno šīs stundas paņēmienu kā nelielu, pārbaudāmu projekta daļu.

  1. Izvēlies vienu konkrētu projekta vietu: failu struktūru, Git darbību, README ierakstu, palaižamu Python failu vai pārbaudes komandu.
  2. Nosauc failus, mainīgos un commit ziņas skaidri pēc to lomas.
  3. Uzraksti kodu vai komandu secību, kas veic vienu skaidru darbību un dod pārbaudāmu rezultātu.
  4. Savieno šo darbu ar esošo projekta mapi, nevis atstāj to atsevišķā demonstrācijā.
  5. Pievieno vienu īsu komentāru vai README rindu tikai tur, kur tas palīdz saprast darbību.
  6. Pārbaudi, ka fails palaižas vai Git stāvoklis ir saprotams.
  7. Salabo pirmo atrasto kļūdu pirms paplašini risinājumu.
  8. Veic Git commit ar īsu ziņu par izveidoto projekta daļu.

3. uzdevums - Testē darbu un izdari secinājumu

Pārbaudi, vai projekta fragments ir atkārtojams un saprotams.

  1. Izveido trīs pārbaudes scenārijus: parasta palaišana, tukša/nepareiza vērtība un atkārtota palaišana pēc izmaiņām.
  2. Palaid parasto scenāriju un pārbaudi termināļa, faila vai Git izvadi.
  3. Palaid kļūdaino scenāriju un pārbaudi, vai problēma ir saprotama.
  4. Palaid atkārtotu scenāriju pēc vienas mazas izmaiņas.
  5. Izlabo vienu konkrētu problēmu kodā, failu struktūrā vai komandu secībā.
  6. Pārbaudi labojumu vēlreiz.
  7. Beigās pieraksti vienu secinājumu: kura koda rinda, komanda vai projekta struktūras solis vislabāk palīdzēja saprast tēmu 1.4 Failu sistēma un organizācija.

Papildu uzdevums - Pievieno mazu projekta uzlabojumu

Ja pamatdarbs ir pabeigts, paplašini projektu ar vienu nelielu, pārbaudāmu uzlabojumu.

  1. Izvēlies vienu papildinājumu: jaunu pārbaudes komandu, README sadaļu, palaišanas piemēru vai mazu Python funkciju.
  2. Pievieno to esošajā projekta struktūrā.
  3. Pārbaudi, ka pamatdarbs un papildinājums darbojas kopā.
  4. Saglabā izmaiņas ar Git commit tikai pēc veiksmīgas pārbaudes.

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ā.
⬅ Iepriekšējā stunda Nākamā stunda ➡