CONTRIBUTING.md

Contributing

The project follows the Open Knowledge International coding standards.

All PHP Code MUST conform to PHP-FIG accepted PSRs.

Flow Framework has a nice guide regarding coding standards:

• Printable summary of most important coding guidelines on one page (.pdf)
• The full guide (.html)

Getting Started

1. Clone the repo
2. Run the tests

$ composer install
$ composer test

Phpunit - for unit tests

Phpunit is used for unit tests, you can find the tests under tests directory

Running Phpunit directly: vendor/bin/phpunit --bootstrap tests/autoload.php tests/

Coveralls - for coverage

when running composer test phpunit generates coverage report in coverage-clover.xml - this is then sent to Coveralls via Travis.

Scrutinizer-ci - for code analysis

Scrutinizer-ci integrates with GitHub and runs on commits.

It does static code analysis and ensure confirmation to the coding stnadards.

At the moment, the integration with frictionlessdata repo is not working, you can setup a Scrutinizer-ci account for your fork and run against that.

php-cs-fixer - code style check & autofix

php-cs-fixer can be used to check and fix code style

you need to manually install it, then you can run : composer style-check or composer style-fix

Publishing to Packagist

• Packagist is automatically updated by the Packagist GitHub service
• all releases from GitHub appear as releases on Packagist automatically

Updating the json schema

The json schema for table schema might be modified from time to time, to update it run composer update-schema

Then, you should review the changes, and possibly write / update unit tests to match the new schema.