blob: a951e0c9b73777c64b6203cf14749ab340a5df9f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
# Basic bash configuration for scripts.
# Copyright 2020-2024 Einhard Leichtfuß
###################################
## Error and termination handling
# See `/docs/error-handling.md` on limitations and annoyances.
## What to consider as an error.
# Accessing unset variables is an error.
set -o nounset
# No `pipefail` (default).
# - Enabling this might, in particular, cause unexpected issues in `if`
# statements.
# - Enable in a subshell whereever necessary.
## How to act on error.
function basic::print_stacktrace()
{
local -ri offset="$1"
local -i i
local -a args=()
for (( i = offset + 1; i < ${#BASH_SOURCE[@]} - 1; i++ ))
do
# See also the `caller` bash builtin.
args+=( "${BASH_SOURCE[i]} ${BASH_LINENO[i-1]} ${FUNCNAME[i]}" )
done
args+=( "${BASH_SOURCE[i]} ${BASH_LINENO[i-1]} <main>" )
basic::stacktrace_prettyprint "$BASH_SUBSHELL" "${args[@]}"
return 0
}
# Default function to pretty-print stack trace.
# - To be redefined if desired.
function basic::stacktrace_prettyprint()
{
local -ri subshell_id="$1"
shift
local -i i=$#
local msg
for msg
do
printf 'FAILED (%d, %d): %s\n' $subshell_id $((--i)) "$msg" >&2
done
return 0
}
# On ERR, print stack trace and exit non-zero.
trap 'basic::print_stacktrace 0; exit 1' ERR
# Inherit traps on ERR.
set -o errtrace
# If we didn't trap ERR (and exit on ERR), we'd likely want the below.
# - Note: `inherit_errexit` is similar to `errtrace`.
#set -o errexit
#shopt -s inherit_errexit
## How to act on exit.
# Default on_exit() function.
# - To be redefined if desired.
function basic::on_exit()
{
return 0
}
trap 'basic::on_exit' EXIT
########################
## Other shell options
# Disable globbing; set good defaults for when temporarily enabled.
# - `extglob` has an effect regardless.
set -o noglob
shopt -s nullglob dotglob globasciiranges globstar extglob globskipdots
# Print an error message upon `shift`-ing "too far" (causes ERR regardless).
shopt -s shift_verbose
# Expand associative array subscripts only once.
shopt -s assoc_expand_once
# Do not let `source' use PATH.
shopt -u sourcepath
##################
## Other options
# Explicitly set the expected default umask.
umask 022
# vi: ft=bash ts=2 sw=0 et
|
