Lekcja 20: Programowanie - projekt indywidualny (2): implementacja

Od planu do kodu

Na poprzedniej lekcji zaplanowales projekt - teraz czas na implementacje, czyli zapisanie algorytmu w kodzie Pythona. Pamietaj: dobry plan to polowa sukcesu. Trzymaj sie specyfikacji i szkieletu kodu.

Dobre praktyki kodowania w Pythonie

1. Nazewnictwo - uzywaj opisowych nazw zmiennych i funkcji:
   • Dobrze: liczba_punktow, oblicz_srednia()
   • Zle: x, f1()
2. Komentarze - opisuj CO robi kod i DLACZEGO, nie JAK:

   # Dobrze:
   # Oblicz srednia ocene z pominieciem najnizszej
   oceny.remove(min(oceny))
   srednia = sum(oceny) / len(oceny)
   
   # Zle:
   # Usun minimum i podziel sume przez dlugosc
   oceny.remove(min(oceny))
   srednia = sum(oceny) / len(oceny)

3. Funkcje - kazda funkcja powinna robic JEDNA rzecz:

   def wczytaj_dane(plik):
       """Wczytuje dane z pliku CSV."""
       with open(plik, 'r') as f:
           return f.readlines()
   
   def oblicz_statystyki(dane):
       """Oblicza srednia, mediane i odchylenie."""
       # ...
       return srednia, mediana, odchylenie

4. Obsluga bledow - uzywaj try/except:

   try:
       plik = open("dane.txt", "r")
       dane = plik.read()
   except FileNotFoundError:
       print("Blad: plik nie istnieje!")
   except Exception as e:
       print(f"Nieoczekiwany blad: {e}")

5. Formatowanie - stosuj PEP 8 (styl kodowania Pythona):
   • 4 spacje na wciecie (nie tabulatory)
   • Maksymalnie 79 znakow w linii
   • Puste linie miedzy funkcjami
   • Spacje wokol operatorow: x = 5, nie x=5

Przydatne techniki

• f-stringi do formatowania tekstu: print(f"Wynik: {wynik:.2f}")
• List comprehension: parzyste = [x for x in lista if x % 2 == 0]
• Praca z plikami: with open() as f: (automatycznie zamyka plik)
• Slowniki do przechowywania danych strukturalnych
• Modul json do zapisu/odczytu danych

Strategia implementacji krok po kroku

1. Zacznij od funkcji main() - szkielet glownego przeplywu
2. Zaimplementuj wejscie danych - wczytywanie z klawiatury lub pliku
3. Dodaj glowna logike - obliczenia, przetwarzanie
4. Zaimplementuj wyjscie - wyswietlanie wynikow
5. Dodaj obsluge bledow - co jesli uzytkownik poda ble dane?
6. Ulepsz interfejs - menu, instrukcje, kolorowanie