TDD w praktyce. Niezawodny kod w języku Python

Table of contents

1. okładka
2. tytuł strony
3. Prawa autorskie strony
4. Pochwały dla książki TDD w praktyce
5. Spis treści
6. Wprowadzenie
   1. Dlaczego napisałem książkę o programowaniu sterowanym testami?
   2. Cel książki
   3. Zarys książki
   4. Konwencje zastosowane w książce
   5. Użycie przykładowych kodów
7. Przygotowania i założenia
   1. Python 3 i programowanie
   2. Jak działa HTML?
   3. JavaScript
   4. Wymagane oprogramowanie
      1. Domyślny edytor Git oraz pozostała podstawowa konfiguracja Git
      2. Wymagane moduły Pythona
8. Podziękowania
9. Część I. Podstawy TDD i Django
   1. Rozdział 1. Konfiguracja Django za pomocą testu funkcjonalnego
      1. Słuchaj Testing Goat! Nie rób nic, dopóki nie przygotujesz testu
      2. Rozpoczęcie pracy z frameworkiem Django
      3. Utworzenie repozytorium Git
   2. Rozdział 2. Rozszerzenie testu funkcjonalnego za pomocą modułu unittest
      1. Użycie testu funkcjonalnego do przygotowania minimalnej aplikacji
      2. Moduł unittest ze standardowej biblioteki Pythona
      3. Ukryte oczekiwanie
      4. Przekazanie plików do repozytorium
   3. Rozdział 3. Testowanie prostej strony głównej za pomocą testów jednostkowych
      1. Nasza pierwsza aplikacja Django i test jednostkowy
      2. Testy jednostkowe i różnice dzielące je od testów funkcjonalnych
      3. Testy jednostkowe w Django
      4. MVC w Django, adresy URL i funkcje widoku
      5. Wreszcie zaczynamy tworzyć kod aplikacji
      6. urls.py
      7. Testy jednostkowe widoku
         1. Cykl test jednostkowy — tworzenie kodu
   4. Rozdział 4. Do czego służą te wszystkie testy?
      1. Programowanie przypomina wyciąganie wiadrem wody ze studni
      2. Użycie Selenium do testowania interakcji użytkownika
      3. Reguła „nie testuj stałych” i szablony na ratunek
         1. Refaktoryzacja w celu użycia szablonu
      4. Refaktoryzacja
      5. Nieco więcej o stronie głównej
      6. Przypomnienie — proces TDD
   5. Rozdział 5. Zapis danych wejściowych użytkownika
      1. Od formularza sieciowego do wykonania żądania POST
      2. Przetwarzanie żądania POST w serwerze
      3. Przekazanie zmiennych Pythona do wygenerowania w szablonie
      4. Do trzech razy sztuka, a później refaktoryzacja
      5. Django ORM i nasz pierwszy model
         1. Pierwsza migracja bazy danych
         2. Zdumiewająco duży postęp w teście
         3. Nowa kolumna oznacza nową migrację
      6. Zapis w bazie danych informacji z żądania POST
      7. Przekierowanie po wykonaniu żądania POST
         1. Poszczególne testy powinny testować pojedyncze rzeczy
      8. Wygenerowanie elementów w szablonie
      9. Utworzenie produkcyjnej bazy danych za pomocą polecenia migrate
   6. Rozdział 6. Przygotowanie minimalnej działającej wersji witryny
      1. Gwarancja izolacji testu w testach funkcjonalnych
         1. Wykonanie tylko testów jednostkowych
      2. Stawiaj na małe projekty
         1. YAGNI!
         2. REST
      3. Implementacja nowego projektu za pomocą TDD
      4. Iteracja w kierunku nowego projektu
      5. Testowanie widoków, szablonów i adresów URL za pomocą testu klienta Django
         1. Nowa klasa testowa
         2. Nowy adres URL
         3. Nowa funkcja widoku
            1. Zielony? Refaktoryzacja
         4. Oddzielny szablon do wyświetlania list
      6. Kolejny adres URL i widok pozwalający na dodanie elementów listy
         1. Klasa testowa dla operacji tworzenia nowej listy
         2. Adres URL i widok przeznaczony do tworzenia nowej listy
         3. Usunięcie zbędnego kodu i dalsze testy
         4. Wskazanie formularzy w nowym adresie URL
      7. Dostosowanie modeli
         1. Związek klucza zewnętrznego
         2. Dostosowanie reszty świata do naszych nowych modeli
      8. Każda lista powinna mieć własny adres URL
         1. Przechwytywanie parametrów z adresów URL
         2. Dostosowanie new_list do nowego świata
      9. Jeszcze jeden widok pozwalający na dodanie elementu do istniejącej listy
         1. Uwaga na żarłoczne wyrażenia regularne!
         2. Ostatni nowy adres URL
         3. Ostatni nowy widok
         4. Jak można użyć adresu URL w formularzu?
      10. Ostatnia refaktoryzacja za pomocą polecenia include
10. Część II. Programowanie sieciowe
    1. Rozdział 7. Upiększanie — jak przetestować układ i style?
       1. Jaką funkcjonalność należy testować w przypadku układu i stylów?
       2. Upiększanie za pomocą frameworka CSS
       3. Dziedziczenie szablonu w Django
       4. Integracja z frameworkiem Bootstrap
          1. Wiersze i kolumny
       5. Pliki statyczne w Django
          1. Zaczynamy używać klasy StaticLiveServerCase
       6. Użycie komponentów Bootstrap do poprawy wyglądu witryny
          1. Jumbotron
          2. Ogromne pola danych wejściowych
          3. Nadanie stylu tabeli
       7. Użycie własnych arkuszy stylów CSS
       8. Co zostało zatuszowane — polecenie collectstatic i inne katalogi statyczne
       9. Kilka tematów, które nie zostały omówione
    2. Rozdział 8. TDD na przykładzie witryny prowizorycznej
       1. Techniki TDD i niebezpieczeństwa związane z wdrożeniem
       2. Jak zwykle zaczynamy od testu
       3. Pobranie nazwy domeny
       4. Ręczne przygotowanie serwera do hostingu naszej witryny
          1. Wybór hostingu dla witryny
          2. Uruchomienie serwera
          3. Konto użytkownika, SSH i uprawnienia
          4. Instalacja Nginx
          5. Konfiguracja domen dla witryn prowizorycznej i rzeczywistej
          6. Użycie testów funkcjonalnych do potwierdzenia działania domeny i serwera Nginx
       5. Ręczne wdrożenie kodu
          1. Dostosowanie położenia bazy danych
          2. Utworzenie virtualenv
          3. Prosta konfiguracja Nginx
          4. Utworzenie bazy danych za pomocą polecenia migrate
       6. Wdrożenie w środowisku produkcyjnym
          1. Użycie Gunicorn
          2. Użycie Nginx do obsługi plików statycznych
          3. Użycie gniazd systemu Unix
          4. Przypisanie opcji DEBUG wartości False i ustawienie ALLOWED_HOSTS
          5. Użycie Upstart do uruchamiania Gunicorn wraz z systemem
          6. Zachowanie wprowadzonych zmian — dodanie Gunicorn do pliku requirements.txt
       7. Automatyzacja
          1. Zachowanie informacji o postępie
    3. Rozdział 9. Zautomatyzowane wdrożenie za pomocą Fabric
       1. Analiza skryptu Fabric dla naszego wdrożenia
       2. Wypróbowanie rozwiązania
          1. Wdrożenie w środowisku produkcyjnym
          2. Pliki konfiguracyjne Nginx i Gunicorn odtworzone za pomocą sed
       3. Użycie polecenia git tag do oznaczenia wydania
       4. Dalsza lektura
    4. Rozdział 10. Weryfikacja danych wejściowych i organizacja testu
       1. Testy funkcjonalne weryfikacji danych — ochrona przed pustymi elementami
          1. Pominięcie testu
          2. Podział testów funkcjonalnych na wiele plików
          3. Wykonanie pojedynczego pliku testu
          4. Podparcie testów funkcjonalnych
       2. Sprawdzenie warstwy modelu
          1. Refaktoryzacja testów jednostkowych na oddzielne pliki
          2. Testy jednostkowe sprawdzania modelu oraz menedżer kontekstu self.assertRaises()
          3. Dziwactwo Django — zapis modelu nie wywołuje operacji sprawdzenia poprawności
       3. Wyświetlanie w widoku błędów z weryfikacji modelu
          1. Upewnienie się, że nieprawidłowe dane nie zostaną zapisane w bazie danych
       4. Wzorzec Django — przetwarzanie żądań POST w widoku generującym formularz
          1. Refaktoryzacja — przekształcenie funkcjonalności new_item na view_list
          2. Egzekwowanie w widoku view_list weryfikacji modelu
       5. Refaktoryzacja — usunięcie na stałe zdefiniowanych adresów URL
          1. Znacznik szablonu {% url %}
          2. Użycie get_absolute_url w przekierowaniach
    5. Rozdział 11. Prosty formularz
       1. Przeniesienie do formularza logiki odpowiedzialnej za sprawdzanie poprawności danych
          1. Użycie testu jednostkowego do analizy API formularzy
          2. Przejście do Django ModelForm
          3. Testowanie i dostosowanie do własnych potrzeb logiki weryfikacji formularza
       2. Użycie formularza w widokach
          1. Użycie formularza w widoku za pomocą żądania GET
          2. Duża operacja znajdź i zastąp
       3. Użycie formularza w widoku obsługującym żądania POST
          1. Adaptacja testów jednostkowych dla widoku new_list
          2. Użycie formularza w widoku
          3. Użycie formularza w celu wyświetlenia błędów w szablonie
       4. Użycie formularza w innym widoku
          1. Metoda pomocnicza dla wielu krótkich testów
       5. Użycie metody save() formularza
    6. Rozdział 12. Bardziej skomplikowane formularze
       1. Kolejny test funkcjonalny dotyczący powielonych elementów
          1. Ochrona przed duplikatami w warstwie modelu
          2. Mała dygresja dotycząca kolejności API Querystring i przedstawiania ciągu tekstowego
          3. Przepisanie testu starego modelu
          4. Pewne błędy spójności ujawniają się podczas zapisu
       2. Eksperymenty w warstwie widoku sprawdzające, czy są powielone elementy
       3. Bardziej skomplikowany formularz do obsługi unikalności elementów
       4. Użycie istniejącego formularza w widoku listy
    7. Rozdział 13. Zagłębiamy się ostrożnie w JavaScript
       1. Rozpoczynamy od testów funkcjonalnych
       2. Konfiguracja prostego silnika wykonywania testów JavaScript
       3. Użycie jQuery i stałych elementów <div>
       4. Utworzenie testu jednostkowego JavaScript dla żądanej funkcjonalności
       5. Testowanie JavaScript w cyklu TDD
       6. Zdarzenie onload i przestrzenie nazw
       7. Kilka rozwiązań, które się nie sprawdzają
    8. Rozdział 14. Wdrożenie nowego kodu
       1. Wdrożenie prowizoryczne
       2. Wdrożenie rzeczywiste
       3. A jeśli wystąpi błąd bazy danych?
       4. Podsumowanie — git tag i nowe wydanie
11. Część III. Bardziej zaawansowane zagadnienia
    1. Rozdział 15. Użycie JavaScript do uwierzytelniania użytkownika, integracji wtyczek i przygotowania imitacji
       1. Mozilla Persona (BrowserID)
       2. Kod eksperymentalny, czyli „Spiking”
          1. Utworzenie nowej gałęzi dla Spike
          2. Łączenie kodu JavaScript i interfejsu użytkownika
          3. Protokół Browser-ID
          4. Kod po stronie serwera — niestandardowe uwierzytelnienie
       3. Zamiana rozwiązania eksperymentalnego na zwykłe
          1. Często stosowana technika Selenium — wyraźne oczekiwanie
          2. Wycofanie kodu eksperymentalnego
       4. Testy jednostkowe JavaScript obejmujące komponenty zewnętrzne — nasze pierwsze imitacje
          1. Porządkowanie — katalog plików statycznych dla całej witryny
          2. Imitacja: kto, co i dlaczego?
          3. Przestrzenie nazw
          4. Prosta imitacja dla testów jednostkowych dla naszej funkcji inicjującej
          5. Bardziej zaawansowane imitacje
             1. Użycie imitacji sinon.js do sprawdzenia, czy API zostało prawidłowo wywołane
          6. Sprawdzenie wywołania argumentów
          7. Konfiguracja QUnit i testowanie żądań Ajax
             1. Wylogowanie
          8. Więcej zagnieżdżonych wywołań zwrotnych! Testowanie kodu asynchronicznego
    2. Rozdział 16. Uwierzytelnianie po stronie serwera i imitacje w Pythonie
       1. Rzut oka na wersję eksperymentalną widoku logowania
       2. Imitacje w Pythonie
          1. Testowanie widoku za pomocą imitacji funkcji uwierzytelnienia
          2. Sprawdzenie, czy widok faktycznie loguje użytkownika
       3. Zmiana eksperymentalnej wersji uwierzytelniania na zwykłą — imitacja żądania internetowego
          1. Polecenie if oznacza więcej testów
          2. Poprawki na poziomie klasy
          3. Strzeż się imitacji w porównaniach wartości boolowskich
          4. Utworzenie użytkownika, jeśli to konieczne
          5. Metoda get_user()
       4. Minimalny niestandardowy model użytkownika
          1. Małe rozczarowanie
          2. Testy jako dokumentacja
          3. Użytkownicy są uwierzytelnieni
       5. Chwila prawdy — czy testy funkcjonalne zostaną zaliczone?
       6. Zakończenie testu funkcjonalnego, przetestowanie wylogowania
    3. Rozdział 17. Konfiguracja testu, rejestracja i debugowanie po stronie serwera
       1. Pominięcie procesu logowania przez wstępne utworzenie sesji
          1. Sprawdzamy rozwiązanie
       2. Dowód znajdziesz w praktyce — użycie wersji prowizorycznej do wychwycenia błędów
          1. Konfiguracja rejestracji danych
          2. Usunięcie błędu systemu Persona
       3. Zarządzanie testową bazą danych w serwerze prowizorycznym
          1. Polecenie Django służące do tworzenia sesji
          2. Test funkcjonalny uruchamiający w serwerze narzędzie zarządzania
          3. Dodatkowy krok za pomocą modułu subprocess
       4. Zachowanie kodu odpowiedzialnego za rejestrację danych
          1. Użycie konfiguracji hierarchicznej rejestracji danych
       5. Podsumowanie
    4. Rozdział 18. Kończymy „Moje listy” — podejście Outside-In
       1. Alternatywa, czyli podejście Inside-Out
       2. Dlaczego preferowane jest podejście Outside-In?
       3. Test funkcjonalny dla strony Moje listy
       4. Warstwa zewnętrzna — prezentacja i szablony
       5. Przejście o jedną warstwę w dół do funkcji widoku (kontroler)
       6. Kolejne zaliczenie — podejście Outside-In
          1. Szybka restrukturyzacja hierarchii dziedziczenia szablonu
          2. Projektowanie API za pomocą szablonu
          3. Przejście w dół do kolejnej warstwy — co widok przekazuje szablonowi?
       7. Kolejne „wymaganie” z warstwy widoku — nowe listy powinny „zapamiętywać” swego właściciela
          1. Czy przejść do kolejnej warstwy, gdy test kończy się niepowodzeniem?
       8. Przejście w dół do warstwy modelu
          1. Ostatni krok — uzyskanie z poziomu szablonu dostępu do właściciela za pomocą API .name
    5. Rozdział 19. Izolacja i „słuchanie” testów
       1. Powrót do miejsca, w którym podjęliśmy decyzję — warstwa widoku zależy od nieutworzonego jeszcze kodu modelu
       2. Pierwsza próba użycia imitacji w celu zapewnienia izolacji
          1. Użycie side_effect do sprawdzenia sekwencji zdarzeń
       3. Posłuchaj testu — brzydki test oznacza konieczność refaktoryzacji
       4. Ponowne utworzenie testów dla widoku, tym razem w pełni odizolowanych
          1. Pozostawienie starych zintegrowanych testów jako punktu odniesienia
          2. Nowy zestaw w pełni odizolowanych testów
          3. Myślimy w kategoriach współpracy
       5. Przejście w dół do warstwy formularzy
          1. Nadal słuchaj testów — usunięcie kodu ORM z aplikacji
       6. Wreszcie przechodzimy w dół do warstwy modelu
          1. Powrót do widoków
       7. Moment prawdy (i ryzyko związane z imitacjami)
       8. Potraktowanie interakcji między warstwami jak kontraktów
          1. Identyfikacja niejawnych kontraktów
          2. Usunięcie przeoczonego problemu
       9. Jeszcze jeden test
       10. Porządkowanie, czyli co zachować z pakietu testów zintegrowanych?
           1. Usunięcie powielonego kodu w warstwie formularzy
           2. Usunięcie starej implementacji widoku
           3. Usunięcie zbędnego kodu w warstwie formularzy
       11. Podsumowanie — testy odizolowane kontra zintegrowane
           1. Niech poziom skomplikowania będzie Twoim przewodnikiem
           2. Czy powinienem tworzyć oba rodzaje testów?
           3. Do przodu!
    6. Rozdział 20. Ciągła integracja
       1. Instalacja serwera Jenkins
          1. Konfiguracja zabezpieczeń w Jenkins
          2. Dodanie wymaganych wtyczek
             1. Poinformuj Jenkins, gdzie znajdzie Pythona 3 i Xvfb
       2. Konfiguracja projektu
       3. Pierwsza kompilacja
       4. Konfiguracja ekranu wirtualnego, aby testy funkcjonalne można było wykonywać bez monitora
       5. Wykonanie zrzutów ekranu
       6. Najczęstszy problem w Selenium — stan wyścigu
       7. Wykonanie testów QUnit w Jenkins za pomocą PhantomJS
          1. Instalacja node
          2. Dodanie kolejnych kroków kompilacji w Jenkins
       8. Więcej zadań do wykonania za pomocą serwera ciągłej integracji
    7. Rozdział 21. Token serwisów społecznościowych, wzorzec strony i ćwiczenie dla czytelnika
       1. Test funkcjonalny z wieloma użytkownikami i funkcja addCleanup()
       2. Implementacja w Selenium wzorca interakcja-oczekiwanie
       3. Wzorzec strony
       4. Rozszerzenie testu funkcjonalnego na drugiego użytkownika i stronę „Moje listy”
       5. Ćwiczenie dla czytelnika
    8. Rozdział 22. Szybkie testy, wolne testy i gorąca lawa
       1. Teza — testy jednostkowe są niezwykle szybkie, mają także inne zalety
          1. Szybsze testy oznaczają szybsze tworzenie kodu
          2. Uczucie błogostanu
          3. Wolne testy nie są wykonywane zbyt często, co przekłada się na gorszej jakości kod
          4. Teraz jest dobrze, ale wraz z upływem czasu testy zintegrowane są wykonywane coraz wolniej
          5. Nie zabieraj mi tego
          6. Testy jednostkowe pozwalają przygotować dobry projekt
       2. Problemy związane z czystymi testami jednostkowymi
          1. Testy odizolowane mogą być trudniejsze w odczycie i zapisie
          2. Testy odizolowane nie testują automatycznie integracji
          3. Testy jednostkowe rzadko przechwytują nieoczekiwane błędy
          4. Testy oparte na imitacji stają się ściśle powiązane z implementacją
          5. Jednak wszystkie wymienione problemy można pokonać
       3. Synteza — jakie mamy oczekiwania wobec testów?
          1. Poprawność
          2. Czytelny, łatwy w obsłudze kod
          3. Produktywna praca
          4. Oceń testy pod kątem korzyści, jakich oczekujesz dzięki ich użyciu
       4. Rozwiązania architektoniczne
          1. Porty i adaptery, czysta architektura i architektura heksagonalna
          2. Architektura Functional Core, Imperative Shell
       5. Podsumowanie
    9. Kieruj się Testing Goat!
       1. Testowanie jest trudne
          1. Zachowuj kolor zielony w serwerze ciągłej integracji
          2. Bądź dumny z testów, podobnie jak z kodu
       2. Nie zapomnij o napiwku
       3. Przedstaw się
12. Dodatki
    1. Dodatek A. PythonAnywhere
       1. Sesje Firefox Selenium przy użyciu Xvfb
       2. Konfiguracja Django jako aplikacji sieciowej PythonAnywhere
       3. Porządek w katalogu /tmp
       4. Zrzuty ekranu
       5. Rozdział poświęcony wdrożeniom
    2. Dodatek B. Widoki oparte na klasach Django
       1. Ogólne widoki oparte na klasach
       2. Strona główna jako widok FormView
       3. Użycie form_valid w celu dostosowania widoku CreateView do naszych potrzeb
       4. Bardziej złożony widok przeznaczony do obsługi wyświetlania listy i dodawania do niej elementów
          1. Testy nas prowadzą, przynajmniej przez chwilę
          2. Jesteśmy zdani na metodę prób i błędów
          3. Wracamy do gry
          4. Czy to już rozwiązanie ostateczne?
       5. Porównanie starego i nowego widoku
       6. Najlepsze praktyki w zakresie testów jednostkowych dla ogólnych widoków opartych na klasach?
          1. Jesteśmy w domu — pomocne jest przygotowanie wielu odizolowanych testów widoku wraz z pojedynczymi asercjami
    3. Dodatek C. Przygotowanie serwera za pomocą Ansible
       1. Instalacja pakietów systemowych i Nginx
       2. Konfiguracja Gunicorn i użycie procedur obsługi do ponownego uruchamiania usług
       3. Co dalej?
          1. Przeniesienie wdrożenia z Fabric do Ansible
          2. Użyj Vagrant do obsługi lokalnych maszyn wirtualnych
    4. Dodatek D. Testowanie migracji bazy danych
       1. Próba wdrożenia do serwera prowizorycznego
       2. Lokalne przeprowadzenie testu migracji
          1. Wprowadzenie problematycznych danych
          2. Skopiowanie danych testowych z witryny produkcyjnej
          3. Potwierdzenie istnienia błędu
       3. Wstawienie danych migracji
          1. Ponowne odtworzenie starej migracji
       4. Testowanie razem nowych migracji
       5. Podsumowanie
    5. Dodatek E. Co dalej?
       1. Powiadomienia zarówno w witrynie, jak i przez e-mail
       2. Przejdź na Postgres
       3. Wykonuj testy względem różnych przeglądarek internetowych
       4. Testy pod kątem błędów o kodach 404 i 500
       5. Witryna administracyjna Django
       6. Sprawdź narzędzie BDD
       7. Utwórz pewne testy dotyczące bezpieczeństwa
       8. Sprawdź aplikację pod kątem eleganckiej degradacji
       9. Testowanie buforowania i wydajności
       10. Frameworki JavaScript MVC
       11. Async i WebSocket
       12. Zacznij używać pakietu PyTest
       13. Szyfrowanie po stronie klienta
       14. Miejsce na Twoje propozycje
    6. Dodatek F. Ściąga
       1. Początkowa konfiguracja projektu
       2. Podstawowy sposób pracy z użyciem technik TDD
       3. Wykraczamy poza testy w komputerze programisty
       4. Najlepsze praktyki dotyczące ogólnego testowania
       5. Najlepsze praktyki dotyczące testów funkcjonalnych i Selenium
       6. Podejście Outside-In, testy odizolowane kontra zintegrowane oraz imitacje
    7. Dodatek G. Bibliografia
13. Skorowidz
14. O autorze
15. Kolofon
16. Przypisy
    1. Wprowadzenie
    2. Przygotowania i założenia
    3. Rozdział 1
    4. Rozdział 2
    5. Rozdział 3
    6. Rozdział 4
    7. Rozdział 5
    8. Rozdział 6
    9. Rozdział 7
    10. Rozdział 8
    11. Rozdział 9
    12. Rozdział 10
    13. Rozdział 11
    14. Rozdział 12
    15. Rozdział 13
    16. Rozdział 15
    17. Rozdział 16
    18. Rozdział 17
    19. Rozdział 19
    20. Rozdział 20
    21. Rozdział 21
    22. Rozdział 22
    23. Kieruj się Testing Goat!
    24. Dodatek A
    25. Dodatek B
    26. Dodatek C
    27. Dodatek D
    28. Dodatek E
17. Tylna okładka