Il s'agit d'un plugin oh-my-zsh
qui vous permet d'exécuter des tests phpunit
dans un conteneur Docker. Ce plugin est livré avec la saisie semi-automatique pour exécuter des conteneurs, des commandes et des groupes phpunit.
Pour installer, vous avez besoin Docker
et oh-my-zsh
. Ensuite, vous pouvez installer le plugin en procédant comme suit :
cd ~/.oh-my-zsh/custom/plugins
git clone https://github.com/windler/zsh-phpunit-docker.git
zsh
Après avoir installé le plugin, vous devez définir deux variables. Ce plugin doit savoir où se trouve l'exécutable phpunit dans vos conteneurs. Si vous souhaitez générer des rapports de couverture, vous devez également définir le dossier de sortie. L'archive vous permet d'ajouter les variables suivantes à votre fichier ~/.zshrc
:
__DOCKER_PHPUNIT="./vendor/phpunit/phpunit/phpunit"
__DOCKER_PHPUNIT_COVERAGE_DIR="coverage_report"
La commande de base est
dockertests <container> [<option> [<arg>]]
##Example
dockertests my_php_fpm_container group integration_tests
L'argument <container>
est le nom ou l'identifiant d'un conteneur en cours d'exécution. Vous pouvez utiliser tab
pour la saisie semi-automatique. Après avoir choisi un conteneur, vous disposez de plusieurs options :
all - Runs all tests except the ignore-group (if used). This is the default command.
group - Runs tests for a phpunit group
filter - provides a filter for e.g. running one tests
coverage - runs all tests except ignore-group and prints coverage (console)
coverage-report - runs all tests except ignore-group with coverage report (html)
Si la commande group
est fournie, vous pouvez compléter automatiquement le groupe phpunit (cela prend un certain temps).
En plus d'exécuter des tests, vous pouvez simplement lancer un bash
sur un conteneur en utilisant
dockerbash <container>
L'argument <container>
est le nom ou l'identifiant d'un conteneur en cours d'exécution. Vous pouvez utiliser tab
pour la saisie semi-automatique.