🧪 Tests#

Here below are listed the commands to run all the various possible tests.

Backend tests:#

Unit tests#

To run python backend unit tests with pytest execute:

pixi run test-backend

Warning

⚠️ Some tests depend on generated models - Always run code generation before testing, if your changes had an impact on the models, see code generation.

Frontend tests:#

Python unit tests#

To run python frontend unit tests with pytest execute:

pixi run test-frontend-py

Javascript unit tests#

To run javascript frontend unit tests with Mocha execute:

pixi run test-frontend-js

To run a specific Mocha test file (e.g. base.test.js) execute:

npx mocha src/qualpipe_webapp/frontend/unit_tests_js/base.test.js

Note

Add new unit tests in the folder: src/qualpipe_webapp/frontend/unit_tests_js/

To see the coverage of your unit-tests execute:

npm run coverage

This will create:

  • report.xml file inside the folder /js-unittests/,

  • the folder /coverage/ which contains all the coverage files (obtained using c8).

To inspect in the browser the interactive html coverage files execute:

open coverage/lcov-report/index.html

To exclude some files/folders from the coverage, properly edit the file .c8rc

End-to-end tests#

By default the installed test browsers are chromium, firefox, and webkit (Safari). Other browsers can be installed modifying the file playwright.config.ts. To execute the tests with all browsers run:

pixi run test-frontend-e2e

If the tests are failing for some browsers, or if you want to execute the tests only with a specific browser (e.g. Chromium), add the flag --project=chromium to the above command.

See also

Refer to the troubleshooting for issues.

The command automatically executes the e2e tests for the three standard browsers, and create the folder /playwright-snapshot/ which contains the test snapshots taken, and an index.html report file inside the folder /playwright-report/. To inspect the interactive html generated report simply execute:

npx playwright show-report

This will serve the interactvie html report at http://localhost:9323. Press CTRL+C to quit.

Instead, to run a specific Playwright test (e.g. the lst.test.js), with a specific browser (e.g. Chromium), execute:

npx playwright test src/qualpipe_webapp/frontend/tests_e2e_js/lst.test.js --project=chromium

Note

Add new end-to-end tests in the folder: src/qualpipe_webapp/frontend/tests_e2e_js/

All tests#

To run all kinds of tests execute:

pixi run all-tests

You can always add the flag --project=chromium (or firefox or webkit) at the end of the previous command.