Enhetstesta dina klasser med PHPUnit i Symfony

Du skall jobba med enhetstestning mot din kod från kortspelet i Symfony. Dina testobjekt är alltså de klasser som du har i kortspelet. Vi kan inledningsvis exkludera controller-klasser och enbart fokusera på modell-klasserna.

Du skall skapa en testsuite av testfall som testar så mycket som möjligt och rimligt i dina testobjekt.

Tanken är att du försöker nå så hög kodtäckning som är möjligt och rimligt

#Förkunskaper

Du kan grunderna i enhetstestning med phpunit.

Du har installerat Xdebug och kan mäta kodtäckning med phpunit.

Du kan köra enhetstester i Symfony.

Du kan generera dokumentation med phpdoc.

#Krav

Kraven är uppdelade i sektioner.

#Installera och konfigurera

1. Installera phpunit och lägg till det som ett skript composer phpunit.

2. Gör så att kodtäckningsrapport för HTML genereras till katalogen docs/coverage.

#Bygg en test suite

1. Skapa en test suite för ditt kortspel.

2. Dina modellklasser är dina testobjekt och varje modellklass skall ha minst en testklass med testfall.

3. Varje testfall har minst en assertion.

4. Du har en kodtäckning som överträffar 70% på varje testobjekt men sikta mot att nå över 90% kodtäckning.

5. Det är helt okey om du vill uppdatera din källkod för att göra den bättre eller mer testbar. Code refactoring (att skriva om sin kod för att förbättra den) är ofta ett bra alternativ.

6. Kär enhetstesterna med composer phpdoc.

[OPTIONELLT] Som en extra utmaning kan du se om dina controllers är testbara med phpunit och i vilken mån du kan testa dem eller vad som krävs för att du skall kunna testa dem.

#Dokumentera kod

1. Välj ut minst en av dina klasser och lägg till kommentarer med PHP DockBlock. Dina kommentarer skall minst innehålla en rads beskrivning av vad metoderna och klassen gör.

2. Generera dokumentationen till katalogen docs/api med kommandot composer phpdoc.

#Utvecklingsmiljö

1. Fixa till din kod enligt den kodstil du kör genom att köra composer csfix.

2. Kolla din kod hur den matchar dina linters genom att köra composer lint.

3. Dubbelkolla att dina testfall passerar med composer phpunit.

4. Generera documentation av din kod med composer phpdoc.

#Publicera

1. Committa alla filer och lägg till en tagg 4.0.0. Om du gör uppdateringar så ökar du taggen till 4.0.1, 4.0.2, 4.1.0 eller liknande.

2. Kör dbwebb test kmom04 för att kolla att du inte har några fel.

3. Pusha upp repot till GitHub, inklusive taggarna.

4. Gör en dbwebb publishpure report och kontrollera att att det fungerar på studentservern.

#Tips från coachen

Lycka till och hojta till i chatt och forum om du behöver hjälp!

#Revision history