damianopetrungaro / php-commitizen
Help writing Git commit following conventional commit specs
v0.2.0
2020-07-15 23:51 UTC
Requires
- symfony/console: ^4 || ^5
Requires (Dev)
- phpspec/prophecy-phpunit: ^2.0
- phpunit/phpunit: ^9
This package is auto-updated.
Last update: 2024-10-16 09:17:45 UTC
README
Commitizen is a tool built for create good commits for a clean and readable git history.
This tool follow the Conventional Commit specs and some best practices described in this slides
Installation and usage
You can install it easily with composer
$ php composer.phar require --dev damianopetrungaro/php-commitizen
Usage is simple too
$ php vendor/bin/php-commitizen commit
You can also
- pass a flag for add all the file to the stage:
-a
- specify a custom configuration file adding the file path as argument
You can ask for more information using: $ php vendor/bin/php-commitizen commit --help
Configuration file
The configuration file must return an array (or partial override)
<?php
return [
'type' => [
'lengthMin' => 1, // Min length of the type
'lengthMax' => 5, // Max length of the type
'acceptExtra' => false, // Allow adding types not listed in 'values' key
'values' => ['feat', 'fix'], // All the values usable as type
],
'scope' => [
'lengthMin' => 0, // Min length of the scope
'lengthMax' => 10, // Max length of the scope
'acceptExtra' => true, // Allow adding scopes not listed in 'values' key
'values' => [], // All the values usable as scope
],
'description' => [
'lengthMin' => 1, // Min length of the description
'lengthMax' => 44, // Max length of the description
],
'subject' => [
'lengthMin' => 1, // Min length of the subject
'lengthMax' => 50, // Max length of the subject
],
'body' => [
'wrap' => 72, // Wrap the body at 72 characters
],
'footer' => [
'wrap' => 72, Wrap the footer at 72 characters
],
];