Changeset 59356 for trunk/README.md

Timestamp:

11/05/2024 07:59:49 PM (15 months ago)

Author:

desrosj

Message:

Build/Test Tools: Add script for generating code coverage report.

This adds documentation for how to generate code coverage reports to the README.md file.

test:coverage has also been added as an npm script to make it easier to generate a report using the local Docker environment. The script will generate an HTML, PHP, and text report file.

Props pbearne, hellofromTonya, netweb.
Fixes #53414.

Location:

trunk

Files:

• . (modified) (1 prop)
• README.md (modified) (1 diff)

trunk

@@ -19 +19 @@
 /docker-compose.override.yml
 .env
+coverage

@@ -19 +19 @@
 /docker-compose.override.yml
 .env
+coverage

trunk/README.md

@@ -95 +95 @@
 ```
 
+#### Generating a code coverage report
+PHP code coverage reports are [generated daily](https://github.com/WordPress/wordpress-develop/actions/workflows/test-coverage.yml) and [submitted to Codecov.io](https://app.codecov.io/gh/WordPress/wordpress-develop).
+
+After the local Docker environment has [been installed and started](#to-start-the-development-environment-for-the-first-time), the following command can be used to generate a code coverage report. 
+
+```
+npm run test:coverage
+```
+
+The command will generate three coverage reports in HTML, PHP, and text formats, saving them in the `coverage` folder.
+
+**Note:** xDebug is required to generate a code coverage report, which can slow down PHPUnit significantly. Passing selection-based options such as `--group` or `--filter` can decrease the overall time required but will result in an incomplete report.
+
 #### To restart the development environment
 

@@ -19 +19 @@
 /docker-compose.override.yml
 .env
+coverage