Add hooks to check .sh and .bash headers

.pre-commit-config.yaml

@@ -28,3 +28,17 @@ repos:
       # - id: forbid-crlf
       - id: remove-crlf
         exclude: ".bat$"
+  - repo: local
+    hooks:
+      - id: dot-sh
+        name: Check .sh files against bash-it requirements
+        entry: ./hooks/dot-sh.sh
+        language: system
+        files: "\\.sh$"
+        types: [file]
+      - id: dot-bash
+        name: Check .bash files against bash-it requirements
+        entry: ./hooks/dot-bash.sh
+        language: system
+        files: "\\.bash$"
+        types: [file]

aliases/available/vim.aliases.bash

@@ -1,3 +1,5 @@
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 cite 'about-alias'
 about-alias 'vim abbreviations'
 

completion/available/cargo.completion.bash

@@ -1,5 +1,5 @@
-#!/usr/bin/env bash
-
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 # cargo (Rust package manager) completion
 
 if _binary_exists rustup && _binary_exists cargo; then

completion/available/knife.completion.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 
 # Published originally as public domain code at https://github.com/wk8/knife-bash-autocomplete
 

completion/available/packer.completion.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 cite "about-completion"
 about-completion "packer completion"
 

completion/available/pipx.completion.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 # pipx completion
 
 if _command_exists register-python-argcomplete && _command_exists pipx; then

completion/available/rustup.completion.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 
 # rustup (Rust toolchain installer) completion
 

completion/available/vault.completion.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 cite "about-completion"
 about-completion "vault completion"
 

hooks/dot-bash.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+exit_code=0
+for file in "$@"; do
+	# TODO Confirm file has '.bash' extension
+
+	# Confirm not executable
+	#
+	if [[ -x "${file}" ]]; then
+		echo "Bash include file \`${file}\` should not be executable"
+		exit_code=1
+	fi
+
+	# Confirm expected #! header
+	#
+	LINE1="$(head -n 1 "${file}")"
+	if [[ "${LINE1}" != "#!/usr/bin/env echo run from bash: ." ]]; then
+		echo "Bash include file \`${file}\` has bad/missing #! header"
+		exit_code=1
+	fi
+
+	# Confirm expected schellcheck header
+	#
+	LINE2="$(head -n 2 "${file}" | tail -n 1)"
+	if [[ "${LINE2}" != "# shellcheck shell=bash disable=SC2148,SC2096" ]]; then
+		echo "Bash include file \`${file}\` has bad/missing shellcheck header"
+		exit_code=1
+	fi
+done
+
+exit $exit_code

hooks/dot-sh.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+exit_code=0
+for file in "$@"; do
+	# TODO Confirm file has '.sh' extension
+
+	# Confirm file is executable
+	#
+	if [[ ! -x "${file}" ]]; then
+		echo "Bash file \`${file}\` is not executable"
+		exit_code=1
+	fi
+
+	# Confirm expected #! header
+	#
+	LINE1="$(head -n 1 "${file}")"
+	if [[ "${LINE1}" != "#!/usr/bin/env bash" ]]; then
+		echo "Bash file \`${file}\` has bad/missing #! header"
+		exit_code=1
+	fi
+done
+
+exit $exit_code

plugins/available/basher.plugin.bash

@@ -1,3 +1,5 @@
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 cite about-plugin
 about-plugin 'initializes basher, the shell package manager'
 

themes/90210/90210.theme.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 SCM_THEME_PROMPT_DIRTY=" ${red}✗"
 SCM_THEME_PROMPT_CLEAN=" ${bold_green}✓"
 SCM_THEME_PROMPT_PREFIX=" |"

themes/powerline/powerline.base.bash

@@ -1,3 +1,5 @@
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 # Define this here so it can be used by all of the Powerline themes
 THEME_CHECK_SUDO=${THEME_CHECK_SUDO:=true}
 

themes/powerline/powerline.theme.bash

@@ -1,4 +1,5 @@
-#!/usr/bin/env bash
+#!/usr/bin/env echo run from bash: .
+# shellcheck shell=bash disable=SC2148,SC2096
 
 # shellcheck source=../../themes/powerline/powerline.base.bash
 . "$BASH_IT/themes/powerline/powerline.base.bash"