dpi / enhanced-drupal-phpunit-results
Installs: 3 469
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 5
Requires
- php: ^8
Requires (Dev)
- behat/mink: ^1.10
- dpi/drupal-phpunit-bootstrap: ^9.4
- drupal/core: >=10@alpha
- friendsofphp/php-cs-fixer: ^3.8
- mikey179/vfsstream: ^1.6.10
- phpstan/phpstan: ^1.7
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-strict-rules: ^1.2
- phpunit/phpunit: ^9.5.20
This package is auto-updated.
Last update: 2024-10-20 02:11:31 UTC
README
Provides tooling to improve the output of PHPUnit tests with Drupal.
After
Before
Highlights
- Command-click/control click URL to open artifact in web browser.
- Command-click/control click file+line to open in IDE (PHPStorm / VSCode / MacVim / Emacs / Sublime Text / Textmate)
- The URL fetched is shown.
drupalGet
/drupalLogin
/drupalLogout
/htmlOutput
/submitForm
page loads are detected,- Icon shown indicating whether artifact is associated with a page load: 📄
drupalGet
🛂drupalLogin
🥾drupalLogout
⚡️htmlOutput
🖍submitForm
- Test method is green or red depending on test pass/failure.
- Execution stack is shown between the test method and the point of page load.
- For direct invocations of page load from a test, a short stack is shown.
The project is intended for use with functional tests, specifically projects
utilizing Drupal Test Traits. Its recommended to utilize
phpunit --printer
or create a new phpunit.xml
to separate Kernel and
Unit tests.
Tests will need to use the included trait. Out of the box this enhancement
cannot be used with tests out of your control, unless base test classes are
patched, such as \Drupal\Tests\BrowserTestBase
.
Drupal is a registered trademark of Dries Buytaert.
Installation and setup
composer require dpi/enhanced-drupal-phpunit-results
In PHPUnit configuration files such as phpunit.xml
, phpunit.xml.dist
, etc,
modify printerClass to reference the class from this library:
<phpunit printerClass="\dpi\EnhancedDrupalPhpunitResults\EnhancedResultPrinter" />
In base test files, replace use \Drupal\Tests\UiHelperTrait
with
use \dpi\EnhancedDrupalPhpunitResults\CombinedEnhancedUiHelperTrait
.
Or if there are collisions,
use EnhancedUiHelperTrait { EnhancedUiHelperTrait::htmlOutput insteadof UiHelperTrait; }
Configuration
Optional configuration is available.
Set these values as environment variables in the executor or phpunit.ini file.
IDE launch links
Will trigger control/command-clicks on file paths to open in an editor of choice.
Possible values:
emacs
macvim
phpstorm
sublime
textmate
vscode
export ENHANCED_RESULTS_IDE=phpstorm
<php> <env name="ENHANCED_RESULTS_IDE" value="phpstorm" /> </php>
Repeat context
Will repeat the executing test at the top of the stack. Normally the executed test is only printed once at the beginning. This option will print the test in context for each drupalGet at the top of the stack. This is useful for tests with many drupalGets.
export ENHANCED_RESULTS_USE_REPEAT_CONTEXT=TRUE
<php> <env name="ENHANCED_RESULTS_USE_REPEAT_CONTEXT" value="TRUE" /> </php>
Disable trimming columns to terminal width
Disable trimming file and URL text strings to terminal width. Instead strings will display untruncated.
export ENHANCED_RESULTS_DISABLE_TRIM_COLUMNS=TRUE
<php> <env name="ENHANCED_RESULTS_DISABLE_TRIM_COLUMNS" value="TRUE" /> </php>
Disable stacks
Disable long stacks if they are noisy
export ENHANCED_RESULTS_DISABLE_OUTPUT_STACK=TRUE
<php> <env name="ENHANCED_RESULTS_DISABLE_OUTPUT_STACK" value="TRUE" /> </php>
Use sequential IDS instead of artifact numbers
Display numbers next to each drupalGet, starting from 1, relative to the current test run. Instead of artifact numbers.
export ENHANCED_RESULTS_USE_SEQUENTIAL_IDS=TRUE
<php> <env name="ENHANCED_RESULTS_USE_SEQUENTIAL_IDS" value="TRUE" /> </php>
Change file prefix
Changes file prefix so clickable files work, useful when used with Docker mounts or symlinks.
export ENHANCED_RESULTS_FILE_PREFIX=/home/user/www
<php> <env name="ENHANCED_RESULTS_FILE_PREFIX" value="/home/user/www" /> </php>
Other notes
- Utilize Drupal's builtin
BROWSERTEST_OUTPUT_BASE_URL
if artifacts are accessed by a different URL by the host OS, than the test runner. This helps to resolve issues with incorrect clickable artifact URLs.