QA-Automation

Installation
1.1 Install through composer.json
1.2 Install with composer command
Usage for PHPCS
2.1 Four different sets of standards
2.1.1 Full manual usage example
2.1.2 Configured usage example
2.1.3 NextEuropa Platform usage example

Holds all quality assurance automation tools. It currently consists of 2 parts. The PHP CodeSniffer sniffs that contain standards regarding the FPFIS platform. And a symfony console implementation for running QA analysis and/or reviews on subsite projects.

1. Installation

The QA-Automation is a package created to QA the platform-dev and subsites that are part of the FPFIS project. This package can be found at:

1.1 Install through composer.json

add package to composer.json

{
  "require-dev": {
    "ec-europa/qa-automation": "~3.0.0"
}

execute composer install

Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Installing symfony/yaml (v3.3.6)
    Loading from cache

  - Installing squizlabs/php_codesniffer (2.9.1)
    Loading from cache

  - Installing drupal/coder (8.2.12)
    Downloading: 100%

  - Installing symfony/finder (v3.3.6)
    Loading from cache

  - Installing psr/log (1.0.2)
    Loading from cache

  - Installing symfony/debug (v3.3.6)
    Loading from cache

  - Installing symfony/polyfill-mbstring (v1.4.0)
    Loading from cache

  - Installing symfony/console (v3.3.6)
    Loading from cache

  - Installing symfony/event-dispatcher (v3.3.6)
    Loading from cache

  - Installing symfony/process (v3.3.6)
    Loading from cache

  - Installing cpliakas/git-wrapper (1.7.0)
    Downloading: 100%

  - Installing ec-europa/qa-automation (dev-release/3.0 e8e1b7c)
    Cloning e8e1b7cacd2aca92390d92219467dcf282c65287

symfony/console suggests installing symfony/filesystem ()
symfony/event-dispatcher suggests installing symfony/dependency-injection ()
symfony/event-dispatcher suggests installing symfony/http-kernel ()
cpliakas/git-wrapper suggests installing monolog/monolog (Enables logging of executed git commands)
Writing lock file
Generating autoload files

1.2 Install with composer command

execute composer require "ec-europa/qa-automation:~3.0.0"

./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Installing symfony/yaml (v3.3.6)
    Loading from cache

  - Installing squizlabs/php_codesniffer (2.9.1)
    Loading from cache

  - Installing drupal/coder (8.2.12)
    Loading from cache

  - Installing symfony/finder (v3.3.6)
    Loading from cache

  - Installing psr/log (1.0.2)
    Loading from cache

  - Installing symfony/debug (v3.3.6)
    Loading from cache

  - Installing symfony/polyfill-mbstring (v1.4.0)
    Loading from cache

  - Installing symfony/console (v3.3.6)
    Loading from cache

  - Installing symfony/event-dispatcher (v3.3.6)
    Loading from cache

  - Installing symfony/process (v3.3.6)
    Loading from cache

  - Installing cpliakas/git-wrapper (1.7.0)
    Loading from cache

  - Installing ec-europa/qa-automation (dev-release/3.0 dd8b20d)
    Cloning dd8b20d1f4f9663b3940829d5af311b0af7f3d4b

symfony/console suggests installing symfony/filesystem ()
symfony/event-dispatcher suggests installing symfony/dependency-injection ()
symfony/event-dispatcher suggests installing symfony/http-kernel ()
cpliakas/git-wrapper suggests installing monolog/monolog (Enables logging of executed git commands)
Writing lock file
Generating autoload files

2. Usage for PHPCS

2.1 Four different sets of standards

Two internal and two external:

Type	Provided by package	Location in package	Provided Standards
Main	ec-europa/qa-automation	/phpcs/Standards/*	DrupalSecure and QualityAssurance
Sub	ec-europa/qa-automation	/phpcs/SubStandards/*	Platform, Subsite and QA
Main	drupal/coder	/coder_sniffer/*	Drupal and DrupalPractice
Main	squizlabs/php_codesniffer	/src/Standards/*	PHPCS, Zend, PSR2, PSR1, MySource, PEAR and Squiz

Each set is either a main or sub standard:
- Main standards contain actual sniffs and possibly ruleset.
- Sub standards are compilations of main standards and only contain a ruleset.

2.1.1 Full manual usage example:

add installed_paths to CodeSniffer.conf

<?php
// Put paths into array for readability.
// Using relative paths in regard to the location of this file:
// vendor/squizlabs/php_codesniffer/CodeSniffer.conf
$installedPaths = array(
   '../../drupal/coder/coder_sniffer',
   '../../ec-europa/qa-automation/phpcs/Standards',
   '../../ec-europa/qa-automation/phpcs/SubStandards',
 );
// Add the paths comma seperated to the installed_paths setting.
$phpCodeSnifferConfig = array(
  'installed_paths' => implode(',', $installedPaths),
);

execute ./bin/phpcs -i

The installed coding standards are PHPCS, Zend, PSR2, PSR1, MySource, PEAR, Squiz,
DrupalPractice, Drupal, QualityAssurance, DrupalSecure, QA, Platform and Subsite

execute ./bin/phpcs --standard=Subsite lib/

FILE: /var/www/html/lib/modules/example_module/example_module.info
----------------------------------------------------------------------
FOUND 2 ERRORS AFFECTING 1 LINE
----------------------------------------------------------------------
 1 | ERROR | "php" property is missing in the info file
 1 | ERROR | "multisite_version" property is missing in the info file
----------------------------------------------------------------------
Time: 206ms; Memory: 10Mb

2.1.2 Configured usage example:

add default_standard to CodeSniffer.conf

<?php
$phpCodeSnifferConfig = array(
  'default_standard' => '/var/www/html/phpcs.xml',
);

create phpcs.xml file in project root

<?xml version="1.0" encoding="UTF-8"?>
<ruleset name="NextEuropa_default">
  <config name="installed_paths" value="../../ec-europa/qa-automation/phpcs/SubStandards" />
  <rule ref="Subsite"/>
  <file>/var/www/html/lib</file>
</ruleset>

execute ./bin/phpcs

FILE: /var/www/html/lib/modules/example_module/example_module.info
----------------------------------------------------------------------
FOUND 2 ERRORS AFFECTING 1 LINE
----------------------------------------------------------------------
 1 | ERROR | "php" property is missing in the info file
 1 | ERROR | "multisite_version" property is missing in the info file
----------------------------------------------------------------------
Time: 206ms; Memory: 10Mb

2.1.3 NextEuropa Platform usage example:

execute composer install in your project

execute ./bin/phing setup-php-codesniffer

Buildfile: /platform-dev/build.xml
 [property] Loading /platform-dev/build.properties.local
 [property] Loading /platform-dev/build.properties
 [property] Unable to find property file: /platform-dev/build.properties... skipped
 [property] Loading /platform-dev/build.properties.dist
     [echo] Loading Drush task.
     [echo] Loading Behat tasks.
     [echo] Loading PHP Codesniffer Configuration task.

NextEuropa > setup-php-codesniffer:

     [echo] Deleting existing PHP Codesniffer default configuration file.
   [delete] Deleting: /platform-dev/phpcs.xml
     [echo] Deleting existing PHP Codesniffer global configuration file.
   [delete] Deleting: /platform-dev/vendor/squizlabs/php_codesniffer/CodeSniffer.conf

BUILD FINISHED

Total time: 0.1581 seconds