- Add stacktrace standard library

Author: DannyBen

lib/bashly/libraries/libraries.yml

@@ -102,6 +102,19 @@ settings:
     - source: "settings/settings.yml"
       target: "settings.yml"
 
+stacktrace:
+  help: Add a function that shows stacktrace on error.
+  files:
+    - source: "stacktrace/stacktrace.sh"
+      target: "%{user_lib_dir}/stacktrace.%{user_ext}"
+  post_install_message: |
+    The stacktrace function is designed to be called automatically on error.
+
+    To enable this functionality, add these lines to your `initialize.sh`:
+    
+      g`trap 'stacktrace' ERR`
+      g`set -o errtrace`
+
 strings:
   help: Copy an additional configuration file to your project, allowing you to customize all the tips and error strings.
   files:

lib/bashly/libraries/stacktrace/stacktrace.sh

@@ -0,0 +1,28 @@
+## Stack trace functions [@bashly-upgrade stacktrace]
+## This file is a part of Bashly standard library
+##
+## Usage:
+## This function is designed to be called on error.
+## 
+## To enable this functionality, add these lines to your `src/initialize.sh`
+## file (Run `bashly add hooks` to add this file):
+##
+##   trap 'stacktrace' ERR
+##   set -o errtrace
+##
+## Note that this functionality also requires `set -e`, which is enabled by
+## default in bashly generated scripts.
+##
+stacktrace() {
+  local i=0
+  local caller_output line func file
+
+  echo "${BASH_SOURCE[0]}:${BASH_LINENO[0]} in \`${FUNCNAME[1]}\`: $BASH_COMMAND"
+  echo "Stack trace:"
+  while caller_output="$(caller $i)"; do
+    read -r line func file <<< "$caller_output"
+    echo -e "\tfrom ${file}:${line} in \`$func\`"
+    i=$((i + 1))
+  done
+  exit 1
+} >&2