Skip to content

Latest commit

 

History

History
57 lines (32 loc) · 1.69 KB

Contributing.md

File metadata and controls

57 lines (32 loc) · 1.69 KB
Raw

Contributing to SARB

Contributions are welcome.

If you want to support another static analysis tool then please read Adding support for new static analysis tools / formats.

Requirements for code created

Given SARB's use case it will probably be used with older code bases. For that reason the aim is to keep supported PHP versions and dependencies as wide as possible.

Supported PHP versions

SARB must support all PHP versions that are either in active or security support.

Support for out of date versions of PHP should only be dropped if it is too difficult to keep them.

Please make sure that the code runs on the following PHP versions:

  • 7.3
  • 7.4
  • 8.0
  • 8.1

Including new libraries

SARB's main dependencies are Symfony Components. SARB must work with all currently supported Symfony versions (maintained and security fixes).

Unless there is a very good reason do NOT add any other libraries.

Code checks

After writing your code run code style fixer, this will automatically format the code to the project style:

composer cs-fix

Check all the CI tasks would run. NOTE you'll need to download the deptrac PHAR, see instructions:

composer ci-<php version>

# e.g.
composer ci-8.1

In addition to the above code coverage needs to 100%. Documented usage of @codeCoverageIgnore is allowed for the cases for lines of code where it is impossible to get test coverage.

Also attempt to keep Infection PHP's Mutation Score Indicator (MSI) above 90%.