Skip to content

Latest commit

 

History

History
153 lines (99 loc) · 2.72 KB

Development.md

File metadata and controls

153 lines (99 loc) · 2.72 KB

Meritoo Flash Bundle

Development-related information

Requirements

  • Docker
  • Your favourite IDE :)

Getting started

  1. Build, create and start Docker's containers by running command:

    docker-compose up -d

  2. Install packages by running command:

    docker-compose run --rm composer install

What is Docker?

Composer

Available as composer service. You can run any Composer's command using the composer service:

docker-compose run --rm composer [command]

Examples below.

Install packages
docker-compose run --rm composer install
Update packages
docker-compose run --rm composer update
Add package
docker-compose run --rm composer require [vendor]/[package]
Remove package
docker-compose run --rm composer remove [vendor]/[package]

Coding Standards Fixer

Fix coding standard by running command:

docker-compose exec php php-cs-fixer fix

Omit cache and run the Fixer from scratch by running command:

docker-compose exec php rm .php_cs.cache && docker-compose exec php php-cs-fixer fix

Want more?

Tests

Prerequisites

Install required packages by running command: docker-compose run --rm composer install.

Running tests

Simply & quick, without code coverage

Tests are running using Docker and php service defined in docker-compose.yml. Example:

docker-compose exec php phpunit --no-coverage

You can also run them in container. In this case you have to run 2 commands:

  1. Enter container:

    docker-compose exec php bash

  2. Run tests:

    phpunit --no-coverage

With code coverage

docker-compose exec php phpunit

Mutation Tests

Served by Infection — Mutation Testing Framework.

Running tests

docker-compose exec php vendor/bin/infection --threads=5

Result of testing

Terminal

Example of output:

125 mutations were generated:
     105 mutants were killed
       3 mutants were not covered by tests
       5 covered mutants were not detected
       0 errors were encountered
      12 time outs were encountered

Metrics:
         Mutation Score Indicator (MSI): 93%
         Mutation Code Coverage: 97%
         Covered Code MSI: 95%
Stored in build/reports/infection directory
  • build/reports/infection/infection-log.txt
  • build/reports/infection/summary-log.txt

Other

Rebuild project and run tests by running command:

docker-compose exec php phing

‹ Back to Readme