A set of quality assurance tools that are easily configurable through an installer.
The QA Tools are meant to provide you with a decent base build setup, conforming to Ibuildings standards. They are not meant to provide a solution for every use case. If you want a more complex setup, you can use the resulting configurations as a base and configure it manually.
The official, full documentation can be found on our GitHub pages.
At this moment, QA Tools requires your project to be under Git version control.
Furthermore, it requires you to have a Linuxy environment with the Dash shell
(sh), Ant (ant), and the common tools find, tr, and xargs in your
PATH. After installing Ant, QA Tools should work on your Linux or
macOS machine.
The recommended way to install the QA Tools is by using our installer:
php -r "copy('https://raw.githubusercontent.com/ibuildingsnl/qa-tools/master/installer.php', 'qa-tools-setup.php');"
php -r "if (hash_file('SHA384', 'qa-tools-setup.php') === '2f83e895f1fda9e44334f452e9abedfde9152ba1aa95d1ea411eef0d1c96086e8d8c68909ffeaa3ec7d72de420c85287') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('qa-tools-setup.php'); } echo PHP_EOL;"
php qa-tools-setup.php
php -r "unlink('qa-tools-setup.php');"
If you want, you can use the --install-dir option for qa-tool-setup.php to indicate where QA tools
should be installed. E.g., php qa-tools-setup.php --install-dir=/usr/local/bin. It is recommended you
download QA tools to either your project directory or to some location that is in your PATH.
A specific version can be installed by specifying the --version option: php qa-tools-setup.php --version=3.0.0-alpha2. This is useful when installing unstable versions of QA Tools.
To see all the options of the installer, run php qa-tools-setup.php --help.
Read why we release the QA Tools as a Phar here.
Usage:
command [options] [arguments]
Available commands:
configure Configure the Ibuildings QA Tools
self-update Updates Ibuildings QA Tools to the latest version
help Displays help for a command
list Lists commandsThe configure subcommand will start an interactive questionnaire to help you
quickly configure various QA tools to your project's testing needs. It remembers
your answers, so you can easily reconfigure the tools.
The QA Tools Phar distributable is self-updateable in a way that is very similar to Composer. The following command will check the QA Tools' [Releases][github-qa-releases] page for the latest stable version, and replace your executable Phar:
$ ./qa-tools.phar self-update