CONTRIBUTING

Contributions are welcome, and are accepted via pull requests. Please review these guidelines before submitting any pull requests.

Process

Fork the project
Create a new branch
Code, test, commit and push
Open a pull request detailing your changes. Make sure to follow the template

Guidelines

Please ensure the coding style running composer lint.
Send a coherent commit history, making sure each individual commit in your pull request is meaningful.
You may need to rebase to avoid merge conflicts.
Please remember that we follow SemVer.

Setup

Clone your fork, then install the dev dependencies:

composer install

Lint

Lint your code:

composer lint

Tests

Update the snapshots:

composer update:snapshots

Run all tests:

composer test

Check types:

composer test:types

Unit tests:

composer test:unit

Integration tests:

composer test:integration

Simplified setup using Docker

If you have Docker installed, you can quickly get all dependencies for Pest in place using our Docker files. Assuming you have the repository cloned, you may run the following commands:

docker compose build to build the Docker image
docker compose run --rm composer install to install Composer dependencies
docker compose run --rm composer test to run the project tests and analysis tools

If you want to check things work against a specific version of PHP, you may include the PHP build argument when building the image:

docker compose build --build-arg PHP=8.2

The default PHP version will always be the lowest version of PHP supported by Pest.

1.8 KiB Raw Blame History