Tavs šīs stundas izaicinājums: Lietot profesionālus koda rakstīšanas standartus, sastādīt skaidrus komentārus un strukturēt programmu tā, lai tā būtu saprotama gan datoram, gan citiem izstrādātājiem.
2.4.8. Dokumentē kodu un ievero koda noformēšanas vadlīnijas.Programmēšanā koda lasāmība ir tikpat svarīga kā tā funkcionalitāte. Lūk, galvenie standarti:
#: Dators tos ignorē, bet tie palīdz cilvēkiem saprast koda nolūku. Raksti par to, kāpēc kods kaut ko dara, nevis apraksti acīmredzamo.
# Slikti: Pārvērš ievadi par skaitli un pieskaita 10
rezultats = int(input()) + 10
# Labi: Pievieno bāzes bruņu bonusu jaunajam spēlētājam
kopejais_hp = int(input("HP: ")) + 10speletaja_vards = "Varonis" # Pareizi
SpeletajaVards = "Varonis" # Nepareizi (Camel Case nav ieteicams Python mainīgajiem)a = 5 + 2 # PEP 8 standarts
a=5+2 # Kļūdains stils""": Vairāku rindu komentāri faila sākumā vai funkcijās, lai aprakstītu kopējo mērķi un autorību.
"""
Spēles 'Duelis' galvenais aprēķinu modulis.
Autors: Jānis Bērziņš (2026)
"""Izmanto dokumentācijas virknes un vienas rindas komentārus, lai loģiski strukturētu jaunu programmu.
dokumentets_duelis.py."""), kurā norādi programmas mērķi, savu vārdu un datumu.input().#), izskaidrojot, kāda informācija šeit tiek iegūta.Uzlabo slikti uzrakstītu koda fragmentu, ievērojot Snake Case un PEP 8 standartus.
tirs_kods.py un iekopē tajā šo problemātisko koda gabalu:
X = int(input("Speks: "))
y_BONUSS=10
REzultAtS=X+y_BONUSS
print(REzultAtS)X, y_BONUSS un REzultAtS atbilstoši Snake Case standartam (piemēram, baze_speks).=) un pluss (+) zīmēm saskaņā ar PEP 8.Izveido labi dokumentētu aprēķinu programmu, apvienojot matemātiku ar skaidriem paskaidrojumiem.
duelisa_logika.py.input() un int(), lai iegūtu divus mainīgos: uzvaru skaitu un zaudējumu skaitu. Nosauc tos atbilstoši Snake Case.# Pieskaitām 1 dalītājam, lai izvairītos no ZeroDivisionError, ja spēlētājam nav zaudējumu.f"Spēlētāja reitings ir: {reitings}").Iejūties vecākā izstrādātāja (Senior Developer) lomā un sakārto sarežģītāku koda fragmentu.
revizija.py."""), lai veiktu sava koda "revīziju" – uzraksti pa punktiem, ko šajā kodā nepieciešams uzlabot.# Izvada rezultātu blakus print(rezultats). Tas jau ir acīmredzami.mans_speks, bet nākamo TavsSpeks, kods izskatīsies neprofesionāli un būs grūtāk atcerēties pareizo sintaksi. Pieturies pie Snake Case.""") gan sākumā, gan beigās.| Kritērijs | Slikts piemērs | Labs piemērs (Snake Case) |
|---|---|---|
| Skaidrība | s = 100 |
sakuma_dzivibas = 100 |
| Konsekvence | SpeletajaVards |
speletaja_vards |
| Jēga | d1, d2, d3 |
speks, aizsardziba, veiksme |
"""
Vienkāršs aprēķinu skripts cīņas mehānikai.
Izmanto PEP 8 standartus un atbilstošus mainīgo nosaukumus.
"""
ienaidnieka_hp = 100
mana_jauda = 25
# Aprēķins, ievērojot PEP 8 atstarpes ap operatoriem
atlikums = ienaidnieka_hp - mana_jauda
print(f"Ienaidniekam palika {atlikums} HP.")