alexgt9 / testing-playground

Playground for (unit/integration/acceptance) testing-oriented workshops.

PHP testing playground

Option 1: Use with locally installed PHP

Requirements

• PHP (>= 7.1)
• Composer

Getting started

• Clone this repository and cd into it.
• Run composer install --prefer-dist to install the project's dependencies.

Usage

• Run ./run_tests.sh to run the tests.

Option 2: Use with Docker

Requirements

• Docker Engine
• Docker Compose

Getting started

• Follow the instructions for setting environment variables HOST_UID, HOST_GID and DOCKER_HOST_NAME_OR_IP.
• Clone this repository and cd into it.
• Run docker-compose pull.
• Run bin/composer.sh install --prefer-dist to install the project's dependencies.
• Optionally, configure PhpStorm for debugging.

Usage

• Run bin/composer.sh to use Composer (e.g. bin/composer.sh require --dev symfony/var-dumper).
• Run bin/run_tests.sh to run the tests.

Sharing patches

If you want to share your work with the group, make sure you stage any file you want to share. You can do this with git add [filename] on the command line. Make sure to also stage renamed and deleted files that you want to share. When you're done, run:

git diff > [name-of-the-patch].patch

Now share this patch via email, Slack, or whatever.

Someone else who has push rights (the workshop leader?) should apply this patch to the latest version of the code:

git apply [name-of-the-patch].patch

They should then add everything, commit it, and push it to the main branch.