chore: add pre-commit hooks

README.md

@@ -31,6 +31,17 @@ documentation][visualization docs].
 
 See [docs/contributing.rst](docs/contributing.rst).
 
+
+### Pre-commit Hooks
+
+The tracer library uses formatting/linting tools including black, flake8, and mypy.
+While these are run in each CI pipeline for pull requests, they are automated to run
+when you call `git commit` as pre-commit hooks to catch any formatting errors before 
+you commit. To initialize the pre-commit hook script to run in your development 
+branch, run the following command:
+
+    $ hooks/scripts/autohook.sh install
+
 ### Testing
 
 

hooks/autohook.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+
+# Autohook
+# A very, very small Git hook manager with focus on automation
+# Contributors:   https://github.com/Autohook/Autohook/graphs/contributors
+# Version:        2.3.0
+# Website:        https://github.com/Autohook/Autohook
+
+
+echo() {
+    builtin echo "[Autohook] $@";
+}
+
+
+install() {
+    hook_types=(
+        "pre-commit"
+    )
+
+    repo_root=$(git rev-parse --show-toplevel)
+    hooks_dir="$repo_root/.git/hooks"
+    autohook_linktarget="../../hooks/autohook.sh"
+    for hook_type in "${hook_types[@]}"
+    do
+        hook_symlink="$hooks_dir/$hook_type"
+        ln -sf $autohook_linktarget $hook_symlink
+    done
+}
+
+
+main() {
+    calling_file=$(basename $0)
+
+    if [[ $calling_file == "autohook.sh" ]]
+    then
+        command=$1
+        if [[ $command == "install" ]]
+        then
+            install
+        fi
+    else
+        repo_root=$(git rev-parse --show-toplevel)
+        hook_type=$calling_file
+        symlinks_dir="$repo_root/hooks/$hook_type"
+        files=("$symlinks_dir"/*)
+        number_of_symlinks="${#files[@]}"
+        if [[ $number_of_symlinks == 1 ]]
+        then
+            if [[ "$(basename ${files[0]})" == "*" ]]
+            then
+                number_of_symlinks=0
+            fi
+        fi
+        echo "Looking for $hook_type scripts to run...found $number_of_symlinks!"
+        if [[ $number_of_symlinks -gt 0 ]]
+        then
+            hook_exit_code=0
+            for file in "${files[@]}"
+            do
+                scriptname=$(basename $file)
+                echo "BEGIN $scriptname"
+                eval "\"$file\""
+                script_exit_code="$?"
+                if [[ "$script_exit_code" != 0 ]]
+                then
+                  hook_exit_code=$script_exit_code
+                fi
+                echo "FINISH $scriptname"
+            done
+            if [[ $hook_exit_code != 0 ]]
+            then
+              echo "A $hook_type script yielded negative exit code $hook_exit_code"
+              exit $hook_exit_code
+            fi
+        fi
+    fi
+}
+
+
+main "$@"

hooks/pre-commit/01-run-black

@@ -0,0 +1 @@
+../scripts/run-black.sh

hooks/pre-commit/02-run-mypy

@@ -0,0 +1 @@
+../scripts/run-mypy.sh

hooks/pre-commit/03-run-flake8

@@ -0,0 +1 @@
+../scripts/run-flake8.sh

hooks/scripts/run-black.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+riot -v run -s black .

hooks/scripts/run-flake8.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+riot -v run -s flake8

hooks/scripts/run-mypy.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+riot -v run -s mypy