2. tēma: Python pamati. 4. stunda: Koda komentēšana un lasāmības standarti.

Tavs šīs stundas izaicinājums: Tu iemācīsies rakstīt kodu ne tikai datoram, bet arī cilvēkam. Apgūsi Snake Case nosaukumu došanas stilu, PEP 8 standartus un iemācīsies izmantot komentārus kā "vēstules nākotnes sev".

SR 2.4.8. (Koda komentēšana un dokumentēšana)

Teorija: Profesionāla koda kultūra

Komentāri (#): Dators tos ignorē. Tie domāti cilvēkam. Raksti par to, kāpēc kods kaut ko dara, nevis apraksti acīmredzamo.
Snake Case: Python standarts mainīgo nosaukumiem. Visu rakstām ar mazajiem burtiem, vārdus atdalot ar apakšsvītru (piem., speletaja_vards).
PEP 8: Oficiālā Python stila rokasgrāmata. Galvenais noteikums iesācējiem: vienmēr lieto atstarpes ap operatoriem (a = 5 + 2, nevis a=5+2).
Docstrings ("""): Vairāku rindu komentāri faila sākumā, lai aprakstītu programmas mērķi un autorību.

1. uzdevums: Duelīša "higiēna"

Iemācīties pareizi dokumentēt programmas sākumu un paskaidrot koda soļus.

Izpildes soļi:

VS Code izveido jaunu failu dokumentets_duelis.py.
Faila sākumā pievieno vairāku rindu komentāru ("""), kurā ieraksti spēles nosaukumu, savu vārdu un datumu.
Uzraksti kodu, kas prasa ievadīt divu spēlētāju vārdus.
Virs katras input() rindas pievieno vienas rindas komentāru (#), paskaidrojot, ka šeit tiek reģistrēti cīņas dalībnieki.

2. uzdevums: Mainīgo "pārvērtības"

Labot sliktu koda stilu un ieviest profesionālu mainīgo nosaukumu došanas kārtību.

Izpildes soļi:

Izveido failu tirs_kods.py un iekopē šo "slikto" paraugu:

X = int(input("Speks: "))
y_BONUSS = 10
REzultAtS = X + y_BONUSS
print(REzultAtS)

Pārveido visus mainīgo nosaukumus atbilstoši Snake Case.
Sakārto atstarpes ap operatoriem (=, +) atbilstoši PEP 8 standartam.
Pievieno komentāru, kas paskaidro, ko aprēķina šī programma.

3. uzdevums: Duelīša matemātiskais modelis

Apvienot aprēķinus ar augstiem lasāmības standartiem un paskaidrot "kāpēc" loģiku.

Izpildes soļi:

Izveido failu duelisa_logika.py.
Uzraksti programmu, kas aprēķina reitingu pēc formulas: $$Reitings = \frac{Uzvaras \times 100}{Zaudējumi + 1}$$
Izmanto tikai jēgpilnus Snake Case mainīgos (piem., uzvaru_skaits).
Pievieno komentāru, kas paskaidro: "Pieskaitām 1 dalītājam, lai izvairītos no ZeroDivisionError."
Izvadi rezultātu, izmantojot f-string.

Mainīgo nosaukumu salīdzinājums

Kritērijs	Slikts piemērs	Labs piemērs (Snake Case)
Skaidrība	`s = 100`	`sakuma_veseliba = 100`
Konsekvence	`SpeletajaVards`	`speletaja_vards`
Jēga	`d1, d2, d3`	`speks, aizsardziba, veiksme`

Atceries: Labs kods lasās kā stāsts. Ja Tev pašam ir grūti saprast savu vakar rakstīto kodu, tātad tas nav pietiekami labi dokumentēts!

Profesionāla koda paraugs

# Aprēķinām ienaidnieka atlikušo veselību pēc trieciena
ienaidnieka_hp = 100
mana_jauda = 25

# Aprēķins ievērojot PEP 8 atstarpes
atlikums = ienaidnieka_hp - mana_jauda

print(f"Ienaidniekam palika {atlikums} HP.")

Ienaidniekam palika 75 HP.