Lekcja 19: Programowanie - projekt indywidualny (3): testowanie

Dlaczego testowanie jest wazne?

Testowanie to kluczowy etap tworzenia oprogramowania. Nawet doswiadczeni programisci popelniaja bledy. Testowanie pozwala je wykryc i naprawic zanim program trafi do uzytkownika.

1. Rodzaje testow

• Testy reczne - uruchamiasz program i sprawdzasz rozne scenariusze
• Testy jednostkowe - automatyczne testy poszczegolnych funkcji
• Testy brzegowe - sprawdzanie zachowania dla wartosci granicznych (0, pusta lista, bardzo duze liczby)
• Testy negatywne - sprawdzanie, jak program reaguje na bledne dane

2. Testy jednostkowe w Pythonie

# plik: test_quiz.py
import unittest
from quiz import sprawdz_odpowiedz, wczytaj_pytania

class TestQuiz(unittest.TestCase):

    def test_poprawna_odpowiedz(self):
        pytanie = {"poprawna": "A"}
        self.assertTrue(sprawdz_odpowiedz(pytanie, "A"))
        self.assertTrue(sprawdz_odpowiedz(pytanie, "a"))

    def test_bledna_odpowiedz(self):
        pytanie = {"poprawna": "A"}
        self.assertFalse(sprawdz_odpowiedz(pytanie, "B"))
        self.assertFalse(sprawdz_odpowiedz(pytanie, "C"))

    def test_wczytaj_pytania_pusty_plik(self):
        # Test z nieistniejacym plikiem
        wynik = wczytaj_pytania("nieistniejacy.csv")
        self.assertEqual(wynik, [])

    def test_wczytaj_pytania_poprawne(self):
        # Test z poprawnym plikiem
        wynik = wczytaj_pytania("pytania_test.csv")
        self.assertIsInstance(wynik, list)
        self.assertGreater(len(wynik), 0)

if __name__ == "__main__":
    unittest.main()

3. Debugowanie - szukanie bledow

Najczestsze techniki debugowania:

• Print debugging - dodawanie print() w kluczowych miejscach kodu
• Debugger - krokowe wykonywanie programu (np. w VS Code lub IDLE)
• Analiza komunikatow bledow - czytaj traceback od dolu do gory
• Metoda polowienia - zakomentuj polowe kodu i sprawdz, w ktorej polowie jest blad

4. Najczestsze bledy w Pythonie

# SyntaxError - blad skladni
print("Hello"    # brakuje nawiasu zamykajacego

# NameError - niezdefiniowana zmienna
print(zmiena)    # literowka w nazwie zmiennej

# TypeError - zly typ danych
"tekst" + 5      # nie mozna dodac stringa i inta

# IndexError - indeks poza zakresem
lista = [1, 2, 3]
print(lista[5])  # indeks 5 nie istnieje

# FileNotFoundError - brak pliku
open("nieistniejacy.txt")  # plik nie istnieje

# ZeroDivisionError - dzielenie przez zero
wynik = 10 / 0

5. Dokumentacja projektu

Dobra dokumentacja zawiera:

• Opis programu - co robi i do czego sluzy
• Instrukcja uruchomienia - jak uruchomic program
• Instrukcja uzytkowania - jak korzystac z programu
• Opis funkcji - co robi kazda funkcja
• Znane ograniczenia - czego program nie obsluguje

"""
QUIZ EDUKACYJNY Z GEOGRAFII
===========================
Autor: Jan Kowalski
Data: 2026-02-17
Wersja: 1.0

OPIS:
Program quizu wielokrotnego wyboru z pytan z geografii.
Pytania wczytywane z pliku CSV.

WYMAGANIA:
- Python 3.8+
- Plik pytania.csv w tym samym folderze

URUCHOMIENIE:
  python quiz.py

STRUKTURA PLIKU PYTAN (pytania.csv):
  pytanie;odpA;odpB;odpC;odpD;poprawna_litera
  Stolica Polski?;Krakow;Warszawa;Gdansk;Poznan;B
"""