Download the PHP package kylekatarnls/multi-tester without Composer
On this page you can find all versions of the php package kylekatarnls/multi-tester. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kylekatarnls/multi-tester
More information about kylekatarnls/multi-tester
Files in kylekatarnls/multi-tester
Package multi-tester
Short Description Test your package change inside other packages
License MIT
Informations about the package multi-tester
multi-tester
When you get multiple projects with strong dependencies between themselves or a project that many other depends on and make a change on one of them, you not only want this project's unit tests to pass, but all other to still pass considering this change. Even with a full coverage of each project, it's not rare to get a project broken by a very small change in one of its dependencies despite that change seemed pretty harmless.
If you package manager is composer, here comes multi-tester to the rescue. It will allow you to run unit tests of other project(s) replacing your package in their vendor directory with the current state of your package.
multi-tester is Travis CI friendly. Packages with .travis.yml
will automatically be handled using Travis CI
standard commands.
Installation
You first need to use composer for your project and have a composer.json file at the root of your project with a "name" property defined (it will be used to replace the code of your project from the vendor directory of other projects with the current changes).
Then you need to install multi-tester as a development dependency:
Use
Once installed, the local command vendor/bin/multi-tester
will be available.
With --add
option it will create .multi-tester.yml (or the config file you passed as first argument)
if it does not exist and add a project with default settings in it.
Without --add
it will run tests on specified projects in the config file.
Without argument, it will try to load its configuration from .multi-tester.yml file in the current directory.
But you can specify an other location as the first argument: vendor/bin/multi-tester ./directory/config.json
(config file can be a .json
or a .yml
).
You also can get detailed output with -v
or --verbose
flag.
Configuration
The .multi-tester.yml config file is where you will list projects and how to download, install and test them.
All entry of a project configuration are optionals.
If you don't specify clone
, multi-tester will check the package name at packagist.org (composer registry) and
get the Git url from it (other VCS are not supported yet). Instead of clone
, you can also specify a version
entry
to filter packages versions (using packagist.org API). Without version, the last stable will be used.
If you don't specify install
, composer install --no-interaction
will be used by default.
If you don't specify script
, vendor/bin/phpunit --no-coverage
will be used by default.
If you set install: travis
, multi-tester will copy the install
command from the .travis.yml file of
the package you test.
If you set script: travis
, multi-tester will copy the script
command from the .travis.yml file of
the package you test.
To get both from .travis.yml, use the shortcut:
Travis
To not have to check manually with multi-tester, you should have it in your CI (continuous integration) process. For example if you use Travis, here is how to integrate in it and then get every project tested at each commit.
Let's say you have the following .travis.yml:
Then you can add a line for multi-tester to your builds with:
All versions of multi-tester with dependencies
ext-json Version *
composer/metadata-minifier Version ^1.0
composer/semver Version ^1.0 || ^2.0 || ^3.0
symfony/yaml Version ^4.0 || ^5.0 || ^6.0 || ^7.0