›_ ebskola.lv
← 1.5

1.6 Noslēguma pārbaudes darbs - Darba vide un kodu pārvaldība

Stundas uzdevums: Patstāvīgi izveidot, dokumentēt un publicēt nelielu Python projektu, izmantojot tikai 1. tēmā apgūto VS Code, GitHub Desktop, Markdown, `.gitignore` un ergonomikas saturu.

SR 2.4.8. Dokumentē kodu un ievēro noformēšanas vadlīnijas SR 2.4.9. Versiju pārvaldība ar Git SR 2.4.12. Programmēšanas vides sagatavošana SR 3.1.1. Ergonomika un droša darba vide

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: pārbaudes darbā vērtē procesu, ne tikai failus

Šajā darbā nav jāizmanto jaunas Python konstrukcijas. Vērtēts tiek tas, vai tu proti sakārtot projektu, pasargāt nevajadzīgus failus ar .gitignore, dokumentēt darbu README failā un publicēt izmaiņas GitHub krātuvē ar saprotamu vēsturi.

# PD1 darba vide
Autors: **Vārds Uzvārds**

## Palaišana
python sveiciens.py

## Ergonomika
- Monitors acu līmenī.
- Regulāri atpūtinu acis.
- Sēžu ar taisnu muguru.
Šis README izmanto tikai iepriekš apgūtos Markdown virsrakstus, treknrakstu un sarakstus.

70 min plāns: projekta struktūra ~20 min, programma un README ~25 min, GitHub publicēšana ~25 min.

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.6 Noslēguma pārbaudes darbs - Darba vide un kodu pārvaldība; 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.6 Noslēguma pārbaudes darbs - Darba vide un kodu pārvaldība"

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.6 Noslēguma pārbaudes darbs - Darba vide un kodu pārvaldība.

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)

Vērtēšanas kritēriji (SLA)

Kritēriji Sācis apgūt (1-3) Turpina apgūt (4-6) Apguvis (7-8) Apguvis padziļināti (9-10)
Struktūra un ignorēšana Faili nav sakārtoti atbilstoši mapēm vai .gitignore nedarbojas. Struktūra ir izveidota, bet slepenais.txt ir netīšām publicēts internetā. Precīza mapju struktūra; .gitignore veiksmīgi bloķē lieko failu. Nevainojama resursu pārvaldība un izpratne par ceļiem un failu paplašinājumiem.
Versiju kontrole (Desktop) Izmaiņas netiek fiksētas (nav Commit) vai nav nosūtītas uz mākoni. Veikts Commit, bet ziņojums ir tukšs, nesaprotams vai fails nav augšupielādēts (Push). Kods ir augšupielādēts; izmantots skaidrs un aprakstošs Commit ziņojums. Nevainojama sinhronizācijas rīku lietošana, pārliecinoties par izmaiņām pirms fiksēšanas.
Dokumentācija (Markdown) README faila nav vai tas rakstīts kā parasts teksts bez formāta. README ir nepilnīgs; nav izmantots Markdown virsrakstiem vai sarakstiem. README satur visas prasītās sadaļas, pareizi pielietojot `#`, `**` un `-` Markdown elementus. Izsmeltinoša dokumentācija, kas ir vizuāli pievilcīga un demonstrē dziļu izpratni par ergonomiku.
Koda izpilde un Iesniegšana Python fails nedarbojas vai nav iesniegta saite E-klasē. Kods darbojas ar kļūdām; iesniegta neprecīza saite (piem., lokālā C: diska adrese). Kods izpildās bez kļūdām; iesniegta korekta GitHub pārlūka saite uz PD1 mapi. Kods ir papildināts ar komentāriem; process veikts patstāvīgi bez aizķeršanās.

Pašpārbaudes saraksts pirms iesniegšanas

# Pārbaudes koda paraugs tavam README.md
# Projekta nosaukums
Autors: **Jānis Programmētājs**

## Ergonomika
- Monitors atrodas acu līmenī.
- Ik pēc 20 minūtēm skatos 20 pēdu attālumā uz 20 sekundēm.
- ...
Pārliecinies, ka VS Code priekšskatījumā (Ctrl+Shift+V) teksts tiek attēlots pareizi noformatēts!
⬅ Iepriekšējā stunda Tēmas apkopojums ➡