headsnet / grumphp-gitlab-lint
Lint your Gitlab CI configuration in a GrumPHP pre-commit hook
Installs: 8 357
Dependents: 0
Suggesters: 1
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >7.4
- phpro/grumphp: ^2.3
- symfony/http-client: ~5.3 || ~6.0 || ~7.0
- symfony/options-resolver: ~5.3 || ~6.0 || ~7.0
- symfony/serializer: ~5.3 || ~6.0 || ~7.0
Requires (Dev)
- phpstan/phpstan: ^1.8
- phpunit/phpunit: ^8.0 || ^9.0
- symplify/easy-coding-standard: ^11
README
GrumPHP Gitlab Lint
Lint your Gitlab CI configuration in a GrumPHP pre-commit hook
Installation
Supports Symfony 5.3 and above, with PHP 7.4 or higher.
Install with Composer:
composer require --dev headsnet/grumphp-gitlab-lint
Usage
# grumphp.yml grumphp: tasks: gitlab_lint: api_token: '%env(GITLAB_TOKEN)%' # required gitlab_file: .gitlab-ci.yml # optional gitlab_url: gitlab.com # optional extensions: - Headsnet\GrumPHP\GitlabLint\Loader
API Token (required)
You must create an API token to authenticate with. The token must have api
access.
You can use '%env(YOUR_ENV_VAR_NAME)%'
syntax to import an environment variable so you don't commit the token to your
repository.
Gitlab File (optional)
Optional parameter to specify an alternative file to lint. Default is .gitlab-ci.yml
in the project root.
Gitlab URL (optional)
A custom location for your on-premises Gitlab instance.
Contributing
Contributions are welcome. Please submit pull requests with one fix/feature per pull request.
Composer scripts are configured for your convenience:
> composer test # Run test suite
> composer cs # Run coding standards checks
> composer cs-fix # Fix coding standards violations
> composer static # Run static analysis with Phpstan
Licence
This code is released under the MIT licence. Please see the LICENSE file for more information.