andkirby/commithook

PHP Commit Hooks

Friday, October 13, 2017
by andkirby
Repository
3 Watchers
8 Stars
144 Installations

PHP
0 Dependents
0 Suggesters
2 Forks
47 Open issues
73 Versions
0 % Grown

The README.md

CmHook

CmHook is GIT commit hook the code validator for PHP (Code Sniffer), CSS (base only), JS (JsHint) code and commit message formatter/filler with the issue tracker integration (JIRA, GitHub)., _(*1)

, _(*2)

The main purpose of this project is - checking coding standards before commit (by using PHP CodeSniffer, JSHint, RuboCop, or any lint tool) - filling up commit messages automatically to proper format (details), _(*3)

Supported file types: php, phtml, js, coffee, css, scss, xml, sh, scss, css, json, less, html, htm., _(*4)

The simplest commit message you could ever make

Target commit message:, _(*5)

Implemented #33: Make smth good now
 - Added my file.

This commit message will be generated automatically, we need to type only commit description:, _(*6)

$ git add myfile.php
$ git commit -m 'Added my file.'

See more details about short commit messages., _(*7)

Installation

Latest release is `v2.0.0-beta.47`

Install globally

To get last beta version please define your minimum-stability., _(*8)

{
  "minimum-stability": "beta",
  "prefer-stable": true
}

Due to reason the package requires one package which still in "dev", please fetch it first:, _(*9)

$ composer global require chobie/jira-api-restclient ^2.0@dev

Now fetch the package:, _(*10)

$ composer global require andkirby/commithook ~2.0@beta

Enable hooks in a project (with predefined configuration)

If a project already have base configuration files all what you need to: - define interpreters (PHP for PHPCS, Ruby for Rubocop, NodeJs for JSHint) - PHP example: shell $ commithook config --xpath code/interpreter/php d:/s/php-7.0.14/php.exe --project-self (You may try to use PHP Windows Binaries Downloader (gist)) - Install extra code validators: - PHPCS shell $ composer global require squizlabs/php_codesniffer:~2.0@stable - JSHint (original). - Rubocop installation. - (optional) Perhaps, you have to define binaries for extra code validators in case they are not allow to use globally. (e.g. JSHint, any see how to install any "linter" in this example.) - Install GIT hook files $ commithook install - Enable your tracker integration: $ commithook tracker:wizard, _(*11)

Sample `.bashrc`

Here is an example of .bashrc file for global using., _(*12)

Separate installation

If global way doesn't work you may use installation via create-project., _(*13)

Documentation references

Problems

Bugs

Issue bugs list., _(*18)

Code validators doesn't work with GIT cache

The code validation works with GIT but it doesn't support git cache. It means if you added a file (git add file.php), changed it, and trying to commit (without adding it into GIT cache). In commit, of course, you will get code from cache but validators will validate your real file. (#113), _(*19)

Minor bugs in short commit message

#92, #91, #32, _(*20)

Tips & tricks

Redundant gaps in code

You may quickly find gaps/trailing spaces in your code by the regular expression:, _(*21)

(\n\s*\n\s*\})|(\n\s*\n\s*\n)|(\{\n\s*\n)| +\n

Just use it in your IDE., _(*22)

OS environment

Tested on Windows in GIT Bash v2.9., _(*23)

Feel free to create your faced issue., _(*24)

Release notes

The Versions

13/10 2017

dev-master

9999999-dev

PHP Commit Hooks

library commithook

PHP Commit Hooks

andkirby/commithook

The README.md

CmHook

The simplest commit message you could ever make

Installation

Latest release is v2.0.0-beta.47

Install globally

Enable hooks in a project (with predefined configuration)

Sample .bashrc

Separate installation

Documentation references

Installation

Password tracker update

Code validation

Commit message

Problems

Bugs

Code validators doesn't work with GIT cache

Minor bugs in short commit message

Tips & tricks

Redundant gaps in code

OS environment

Release notes

The Versions

dev-master

The Requires

The Development Requires

dev-develop

The Requires

The Development Requires

v2.0.0-beta.46

The Requires

The Development Requires

v2.0.0-beta.45

The Requires

The Development Requires

v2.0.0-beta.44

The Requires

The Development Requires

v2.0.0-beta.43

The Requires

The Development Requires

v2.0.0-beta.42

The Requires

The Development Requires

v2.0.0-beta.41

The Requires

The Development Requires

v2.0.0-beta.40

The Requires

The Development Requires

v2.0.0-beta.39

The Requires

The Development Requires

v2.0.0-beta.38

The Requires

The Development Requires

v2.0.0-beta.37

The Requires

The Development Requires

v2.0.0-beta.36

The Requires

The Development Requires

v2.0.0-beta.35

The Requires

The Development Requires

v2.0.0-beta.34

The Requires

The Development Requires

v2.0.0-beta.33

The Requires

The Development Requires

v2.0.0-beta.32

The Requires

The Development Requires

v2.0.0-beta.31

The Requires

The Development Requires

Latest release is `v2.0.0-beta.47`

Sample `.bashrc`