Prezentacja z wydarzenia DrupalDay z dnia 25.11.2021

1. Codeception - jak zacząć pisać
automatyczne testy do Drupala
Michał Potasiak

2. kariera.droptica.pl
Poznaj nas:
● O firmie
● Ścieżka kariery
● Szkolenia i rozwój
● Benefity
● Praca zdalna
● Biura
● Projekty i klienci
● Po pracy
● Hardware i software
● Typowy dzień pracy
https://kariera.droptica.pl Social Media: #drupaldaypl
Oferty pracy
● Frontend Developer HTML, CSS
○ 5 000 - 8 500 zł netto (B2B)
● Junior PHP Developer
○ 5 000 - 8 500 zł netto (B2B)
● PHP Fullstack Dev - Laravel lub Symfony (Mid/Senior/TechLead)
○ 9 500 - 16 500 zł netto (B2B)
● Drupal Developer (Mid/Senior/TechLead)
○ 10 500 - 17 500 zł netto (B2B)

3. Agenda
1. Projekt demo - jak wystartować.
2. Co to jest Codeception i dlaczego go wybraliśmy.
3. Konfiguracja Codeception na projekcie.
4. Moduły dla Drupala.
5. Demo
6. Pytania?

4. Codeception co to takiego?
Codeception jest frameworkiem przeznaczonym do tworzenia testów
jednostkowych, akceptacyjnych i funkcjonalnych. Co prawda opiera się on na
języku PHP, jednak do rozpoczęcia z nim pracy potrzebna jest wiedza wyłącznie
na poziomie podstawowym z uwagi na zestaw własnych komend, które
Codeception oferuje. Testy w Codeception są pisane w stylu BDD (Behavior
Driven Development), czyli zbiorze krótkich historyjek, które mówią nam o tym, jak
powinien zachować się system, kiedy coś konkretnego się wydarzy.
https://codeception.com

5. Dlaczego Codeception

6. Krótko o infrastrukturze przykładu
## Run local env with Docksal
* Docksal - (https://docksal.io/)
### Installing
1. Clone the git repository based on https://github.com/andriyun/drupal_codeception_demo
git clone git@github.com:DropticaExamples/drupal_day_codeception_example.git
2. Enter the newly created project directory
cd drupal_day_codeception_example
3. Start docksal environment
fin start
4. Install composer dependencies
fin composer install
5. Install Drupal
fin drush si --db-url=mysql://root:root@db/default
## Run tests
fin test

7. Composer.json
Pakiety od testów dodajemy do sekcji dev,
raczej nie zaleca się uruchamianie testów na
produkcji.

8. Docker

9. Konfiguracja
ogólna
Ogólne dane konfiguracyjne
przechowywane są w pliku
codeception.yml, który powinien
wyglądać mniej więcej tak, jak ten
pokazany tutaj.

10. Konfiguracja
zestawu testów
Nadpisywanie konfiguracji dla zestawu testów np
acceptance.suite.yml, który powinien
wyglądać mniej więcej tak, jak ten
pokazany tutaj.

11. Moduły
Mocą Codeception są jego moduły.

12. Przykładowy test

13. Przykładowy test - PHPUnit

14. Polecenia do uruchomienia
Uruchomienie wszystkich testów:
fin exec "php vendor/bin/codecept run --html"
Uruchomienie tylko testów unit:
fin exec "php vendor/bin/codecept run unit --html"
Uruchomienie tylko jednego pliku z testami:
fin exec "php vendor/bin/codecept run acceptance DrupalDemoCest --html"
Uruchomienie tylko jednego testu z opcją debugowania:
fin exec "php vendor/bin/codecept run acceptance DrupalDemoCest:entityTest --html --debug"

15. Wykonanie testu

16. Raporty

17. Drupal Codeception
https://github.com/guncha25/drupal-codeception

18. Drupal Bootstrap
Pozwala on na używanie funkcji drupalowych w testach
i w innych modułach codeception. Konfiguracja:

19. Drupal Drush
Pozwala on na używanie drusha w testach.
Konfiguracja:

20. Drupal Entity
Pozwala on na dodawanie encji drupalowych w testach
oraz łatwe usuwanie treści testowych. Konfiguracja:

21. Drupal User
Pozwala on na dodawanie testowych użytkowników i
łatwe usuwanie ich treści po wykonanych testach.
Konfiguracja:

22. Drupal Watchdog
Pozwala on na łatwe sprawdzanie logów podczas testów
codeception.
Konfiguracja:

23. Drupal Fields Utility
Pozwala w testach lokalizować
pola drupalowe używając
machine name zamiast innych
lokatorów.

24. Drupal Acceptance
Dostarcza zbiór metod, które pomagają w sprawnym pisaniu testów dla Drupala z
użyciem webdrivera.
Konfiguracja:

25. Drupal Acceptance - przykłady

26. Demo

27. Pytania?

28. W jakim stylu pisane są testy
akceptacyjne w Codeception?

29. Dziękujemy za
wasz cenny czas!
Imię i Nazwisko autora
Michał Potasiak, michal.potasiak@droptica.pl
Dane Kontaktowe
WWW.DROPTICA.COM