fairpm/fair-plugin
0
0
Fork 0
mirror of https://ghproxy.net/https://github.com/fairpm/fair-plugin.git synced 2026-08-07 13:20:26 +08:00
Code Issues Projects Packages Activity Actions
fair-plugin/tests/unit/README.md
Chuck Adams 8859783c8f
 Phase 1: migrate test infrastructure to tests/unit/ 
Rename tests/phpunit/ → tests/unit/, phpunit.xml.dist → tests/unit/phpunit.xml.
Adjust all paths in phpunit.xml and multisite.xml for new location.
Update composer.json scripts: test → test:unit, test:multisite → test:unit:multisite.
Update coverage:* paths and package.json npm scripts.
Bump .wp-env.json PHP version 7.4 → 8.0 (hard floor per AGENTS.md).
All 19 existing tests pass (5 test classes, 30 assertions).

Known issue: composer.lock has PHP 8.2-bound dev deps; tests-cli needs --ignore-platform-reqs on PHP 8.0.

Signed-off-by: Chuck Adams <chaz@chaz.works>
2026-06-09 10:59:50 -06:00

1.9 KiB
Raw Permalink Blame History

Instructions

Setting up the dev environment

Option 1: wp-env

  1. Copy wp-tests-config-sample.php to wp-tests-config.php.
  2. Ensure Docker is installed and running.
  3. Run npm i
  4. Run npm run env start
  5. Run npm run test:php:install-deps

Option 2: Local web server and MySQL database:

  • Run composer install
  • Create a new database using mysql -u<username> -p -> CREATE DATABASE <database_name>; -> exit;
    • Note: Don't use an existing database - the database is reset before every test run by default.
  • Copy wp-tests-config-sample.php to wp-tests-config.php.
  • Ensure that DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST in wp-tests-config.php match your setup.
  • Run ./bin/install-wp-tests.sh with the appropriate credentials.

Running PHPUnit tests

Single Site

npm run test:php

If you're not using wp-env, you can just run composer run test:unit.

Multisite

npm run test:php:multisite

If you're not using wp-env, you can just run composer run test:unit:multisite.

Running PHPUnit tests with line coverage

First, start the environment with xDebug:

npm run env start -- --xdebug=coverage

If you're not using wp-env, make sure the xDebug PHP module is installed and enabled.

Single Site

npm run coverage:php:single

If you're not using wp-env, you can just run composer run coverage:single.

A coverage report will be available at /tests/unit/coverage/html/single-site.

Multisite

npm run coverage:php:multisite

If you're not using wp-env, you can just run composer run coverage:multisite.

A coverage report will be available at /tests/unit/coverage/html/multisite.

Single Site and Multisite

npm run coverage:php:full

If you're not using wp-env, you can just run composer run coverage:full.

A merged coverage report will be available at /tests/unit/coverage/html/full.