feat: Add core.print_die_fn(). Closes #11

Author: hyperupcall

docs/api.md

@@ -15,6 +15,7 @@ Core functions for any Bash program
 * [core.err_exists()](#coreerr_exists)
 * [core.panic()](#corepanic)
 * [core.print_stacktrace()](#coreprint_stacktrace)
+* [core.print_die_fn()](#coreprint_die_fn)
 * [core.print_fatal_fn()](#coreprint_fatal_fn)
 * [core.print_error_fn()](#coreprint_error_fn)
 * [core.print_warn_fn()](#coreprint_warn_fn)
@@ -159,6 +160,15 @@ core.trap_add 'err_handler' ERR
 
 _Function has no arguments._
 
+### core.print_die_fn()
+
+Print a error message to standard error including the function name
+of the callee to standard error and die
+
+#### Arguments
+
+* **$1** (string): message
+
 ### core.print_fatal_fn()
 
 Print a fatal error message including the function name of the callee

pkg/src/public/bash-core.sh

@@ -283,6 +283,15 @@ core.print_stacktrace() {
 	fi
 } >&2
 
+# @description Print a error message to standard error including the function name
+# of the callee to standard error and die
+# @arg $1 string message
+core.print_die_fn() {
+	local msg="$1"
+
+	core.print_die "${FUNCNAME[1]}()${msg:+": "}$msg"
+}
+
 # @description Print a fatal error message including the function name of the callee
 # to standard error
 # @arg $1 string message