Documentare teste PHPUnit

Salutare,

Aveti cumva cunostinta de vreun tool sau metoda de a documenta testele PHPUnit in mod automat? Mi-ar placea sa pot avea un tag in DocBlock in care sa scriu o scurta descriere a testului respectiv.

Apoi as vrea ca separat sa pot sa generez un document cu toate testele dintr-o clasa in care sa fie agregate toate acele comentarii.

Din documentatia PHPUnit reiese ca adnotarea @testdox ar fi ce am nevoie pentru prima etapa, dar nu stiu sa existe ceva care sa ma ajute cu cea de-a doua etapa.

Multumesc

1 Like

--testdox e și flag în CLI și îți transformă metodele în ceva mai citibil:

Routes (Tests\Feature\Routes)
 ✔ Form submission show errors
 ✘ Users see page

Metodele din test sunt de forma test_user_see_page sau test_form_submission_show_errors.

Cred că ar fi mai bine să dezvolți ideea în numele metodei de test, nu se supără nimeni să ai ceva de genul test_user_creation_failure_when_email_is_already_registered :smiley:

În sublime îmi făcusem un snippet care îmi transforma comentariu automat în numele metodei scrisă în camelCase :slight_smile:

1 Like

E un prim pas, insa mi-ar fi placut ceva care la final sa genereze un fel de raport.