README

Set of modules and libraries and configurations that helps quality assurance in Drupal.

Automated tasks executed when this plugin is installed

• phpcs.xml.dist gets symlinked to the Composer project root if it does not exist
• phpstan.neon.dist and phpstan.baseline.neon gets copied to the Composer project root if they do not exist

Available commands

Drupal QA commands

• composer drupalqa:phpcs:config-install - installs Pronovix's PHP CodeSniffer configuration for Drupal projects (the plugin tries to install it automatically when it gets installed)
• composer drupalqa:testrunner:download - installs latest version of Pronovix's TestRunner Go application from Github. (You can avoid API rate limit error if you configure your Github OAuth access token.)
• drupalqa:phpstan:ensure-configs-exist ensures base configurations for PHPStan (stored in ./config/skeletons/) are available in Composer project root

3rd-party commands

• composer normalize - Normalizes the composer.json (provided by localheinz/composer-normalize)
• ./vendor/bin/twigcs - Checks TWIG files for violations on coding standards. (provided by friendsoftwig/twigcs)
• ./vendor/bin/phpstan - PHP static analysis tool. (provided by phpstan/phpstan)

Packages included

Code quality

• Composer Normalize: https://github.com/localheinz/composer-normalize
• PHP CodeSniffer Standards Composer Installer Plugin: https://github.com/Dealerdirect/phpcodesniffer-composer-installer
• PHPStan: https://github.com/phpstan/phpstan
• Slevomat Coding Standard: https://github.com/slevomat/coding-standard

Testing

• Behat Screenshot Extension: https://github.com/elvetemedve/behat-screenshot
• Behat Drupal Extension: https://github.com/jhedstrom/drupalextension

Plus various other packages (like Drupal Coder, PHPUnit, etc.) required by webflo/drupal-core-require-dev.

Development notes

ALL classes, interfaces in this project are internal and not meant to be used by other projects. No backward-compatibility promise is given for these.

Running QA checks:

• First fix auto-fixable issues with composer lint:fix && composer static:fix
• then run checkscomposer lint:check && composer static:check