f573fbbb894b0abbddeca577bbd3cc13b332e0ae
2 # Copyright 2018 Ian Kelling
4 # Licensed under the Apache License, Version 2.0 (the "License");
5 # you may not use this file except in compliance with the License.
6 # You may obtain a copy of the License at
8 # http://www.apache.org/licenses/LICENSE-2.0
10 # Unless required by applicable law or agreed to in writing, software
11 # distributed under the License is distributed on an "AS IS" BASIS,
12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 # See the License for the specific language governing permissions and
14 # limitations under the License.
18 # Commentary: Bash stack trace and error handling functions. This file
19 # is meant to be sourced. It loads some functions which you may want to
20 # call manually (see the comments at the start of each one), and then
21 # runs err-catch. See the README file for a slightly longer explanation.
24 # help: turn off exit and stack trace on error. undoes err-catch
25 set +E
+o pipefail
; trap ERR
28 # help: print stack trace
30 # Note: It does not show function args unless you first run:
32 # err-catch runs this for you.
34 local -i argc_index
=0 frame i start
=${1:-1} max_indent
=8 indent
37 if [[ $
(shopt -p extdebug
) == *-s* ]]; then
40 for ((frame
=0; frame
< ${#FUNCNAME[@]}-1; frame
++)); do
41 argc
=${BASH_ARGC[frame]}
43 ((frame
< start
)) && continue
44 if (( ${#BASH_SOURCE[@]} > 1 )); then
45 source="${BASH_SOURCE[frame+1]}:${BASH_LINENO[frame]}:"
47 indent
=$
((frame-start
+1))
48 indent
=$
((indent
< max_indent ? indent
: max_indent
))
49 printf "%${indent}s↳%sin \`%s" '' "$source" "${FUNCNAME[frame]}"
51 for ((i
=argc_index-1
; i
>= argc_index-argc
; i--
)); do
52 printf " %s" "${BASH_ARGV[i]}"
59 # help: print stack trace and exit on error.
61 # Set "${_errcatch_cleanup[@]}" to set a command which will run before exiting.
62 # This function depends on err-bash-trace.
64 set -E; shopt -s extdebug
69 echo "${BASH_SOURCE[1]}:${BASH_LINENO[0]}:in \`$BASH_COMMAND' returned $err"
70 # err trap does not work within an error trap, the following line:
71 err-bash-trace
2; set -e
72 "${_errcatch_cleanup[@]:-}" # note :- is to be compatible with set -u
73 echo "$0: exiting with code $err"
80 # usage: err-exit [EXIT_CODE] [MESSAGE]
81 # help: exit and print stack trace.
83 # Use this instead of the exit command to be more informative. default
84 # EXIT_CODE is 1. If only one of EXIT_CODE and MESSAGE is given,
85 # we consider it to be an exit code if it is a number.
86 # This function depends on err-bash-trace.
91 if [[ ${1/[^0-9]/} == "$1" ]]; then
97 printf '%s\n' "$0: $1"
100 echo "${BASH_SOURCE[1]}:${BASH_LINENO[0]}"
102 echo "$0: exiting with code $code"