misc: add black files/notes

.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# trivial: apply black & isort
+872f39774a43db59ffc4bbddc77ad3a33ba7ead2

.pre-commit-config.yaml

@@ -0,0 +1,13 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+-   repo: https://github.com/psf/black
+    rev: 20.8b1
+    hooks:
+    - id: black
+      args: ['--target-version', 'py37', '--skip-string-normalization', '--line-length', '110']
+-   repo: https://github.com/PyCQA/isort
+    rev: 5.7.0
+    hooks:
+    - id: isort
+      args: ['--profile', 'black', '--line-length', '110']

README

@@ -171,3 +171,18 @@ For testing multitenant framework, do in a virtualenv:
    pip install pytest pytest-django python-memcached mock .
 
    cd tests_multitenant ; PYTHONPATH=. DJANGO_SETTINGS_MODULE=settings py.test .
+
+
+Code Style
+----------
+
+black is used to format the code, using thoses parameters:
+
+    black --target-version py37 --skip-string-normalization --line-length 110
+
+isort is used to format the imports, using those parameters:
+
+    isort --profile black --line-length 110
+
+There is .pre-commit-config.yaml to use pre-commit to automatically run black and isort
+before commits. (execute `pre-commit install` to install the git hook.)