Skip to content

Latest commit

 

History

History
173 lines (112 loc) · 3.15 KB

Development.md

File metadata and controls

173 lines (112 loc) · 3.15 KB

Meritoo Common Library

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. Rebuild project by running command (installs packages, prepares required directories and runs tests):

    docker-compose exec php phing

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

or

docker-compose exec php phing -f phing/tests.xml build:fix-coding-standards

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 PHPUnit tests

Easy (with code coverage)
docker-compose run --rm phpunit --verbose

or

docker-compose exec php phing -f phing/tests.xml test:phpunit
Quick (without code coverage)
docker-compose run --rm phpunit --verbose --no-coverage

Infection - Mutation Testing

Served by Infection — Mutation Testing Framework.

Running tests

$ docker-compose exec php bash
root@18f2f0cfaa5d:/var/www/application# XDEBUG_MODE=coverage ./vendor/bin/infection --threads=$(nproc)

or

$ docker-compose exec php bash
root@18f2f0cfaa5d:/var/www/application# XDEBUG_MODE=coverage phing -f phing/tests.xml test:infection

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

PHPStan

Running analysis

docker-compose exec php vendor/bin/phpstan analyse --memory-limit 256M

Generating the baseline file

docker-compose exec php vendor/bin/phpstan --generate-baseline

Other

Rebuild project and run tests by running command:

docker-compose exec php phing

‹ Back to Readme