chore(*): embed constellation git hooks to project source

Author: qboileau

README.md

@@ -103,3 +103,13 @@ SMTP server configuration (used to re-initialized user password) :
 * **cstl.mail.smtp.username** : Default value `no-reply@localhost`
 * **cstl.mail.smtp.password** : Default value `mypassword`
 * **cstl.mail.smtp.ssl** : Default value `false`
+
+## Contribute
+
+### Activate Git hooks
+Constellation use Git hooks to standardize commits message format.
+
+```shell
+rm .git/hooks/commit-msg
+ln -s githook/* .git/hooks/
+```

githook/commit-msg

@@ -0,0 +1,59 @@
+#!/usr/bin/env python
+"""
+Git commit hook:
+ .git/hooks/commit-msg
+
+ Check commit message according to angularjs guidelines:
+  * https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#
+
+ Check commit scope according to geomatys internal guidelines:
+  * https://docs.google.com/a/geomatys.com/spreadsheets/d/1hGwogTSwlmMmIgDsDbAFyBDC9G5xixcMAIRbn9A9TtM/edit#
+
+"""
+
+import sys
+import re
+
+valid_commit_types = ['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'chore']
+valid_scope_types = ['Admin', 'Client', 'SDI', 'Services', 'Database', 'Token', 'Engine', 'Gui Swing', 'JSON Binding', 'Library', 'Storage', 'Testing', 'WS', 'XML Binding', 'Docker', '*']
+commit_file = sys.argv[1]
+help_address = 'https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#'
+help_scopes = 'https://docs.google.com/a/geomatys.com/spreadsheets/d/1hGwogTSwlmMmIgDsDbAFyBDC9G5xixcMAIRbn9A9TtM/edit#'
+
+with open(commit_file) as commit:
+    lines = commit.readlines()
+    if len(lines) == 0:
+        sys.stderr.write("\nEmpty commit message\n")
+        sys.stderr.write("\n - Refer commit guide: %s\n\n" % help_address)
+        sys.exit(1)
+
+    # first line
+    line = lines[0]
+    m = re.search('^(.*)\((.*)\): (.*)$', line)
+
+    if not m or len(m.groups()) != 3:
+        sys.stderr.write("\nFirst commit message line (header) does not follow format: type(scope): message\n")
+        sys.stderr.write("\n - Refer commit guide: %s\n\n" % help_address)
+        sys.exit(1)
+    commit_type, commit_scope, commit_message = m.groups()
+    if commit_type not in valid_commit_types:
+        sys.stderr.write("\nCommit type not in valid ones: %s\n" % ", ".join(valid_commit_types))
+        sys.stderr.write("\n - Refer commit guide: %s\n\n" % help_address)
+        sys.exit(1)
+    if commit_scope not in valid_scope_types:
+        sys.stderr.write("\nCommit scope not in valid ones: %s\n" % ", ".join(valid_scope_types))
+        sys.stderr.write("\n - Refer scope guide: %s\n\n" % help_scopes)
+        sys.exit(1)
+
+
+    if len(lines) > 1 and lines[1].strip():
+        sys.stderr.write("\nSecond commit message line must be empty\n")
+        sys.stderr.write("\n - Refer commit guide: %s\n\n" % help_address)
+        sys.exit(1)
+
+    if len(lines) > 2 and not lines[2].strip():
+        sys.stderr.write("\nThird commit message line (body) must not be empty\n")
+        sys.stderr.write("\n - Refer commit guide: %s\n\n" % help_address)
+        sys.exit(1)
+
+sys.exit(0)