framework: add schedule_deletion, to delete files as late as possible

Author: tabrisnet

lib/functions/general/schedule_deletion.sh

@@ -0,0 +1,32 @@
+# SPDX-License-Identifier: GPL-2.0
+# Copyright (c) 2025 tabris <[email protected]>
+# This file is a part of the Armbian Build Framework https://github.com/armbian/build/
+
+declare -a schedule_deletion_files_to_delete
+
+function schedule_deletion() {
+	local file="$1"
+	local source="${BASH_SOURCE[1]}"
+	local func="${FUNCNAME[1]}"
+	local line="${BASH_LINENO[0]}"
+
+	schedule_deletion_files_to_delete+=("$file;$source;$func;$line")
+}
+
+function pre_umount_final_image__schedule_deletion_delete_now() {
+	local file source func line message deletion_info
+	for deletion_info in "${schedule_deletion_files_to_delete[@]}"; do
+		IFS=';' read -r file source func line <<< "$deletion_info"
+		message="scheduled from $source $func $line"
+
+		set +e # don't bail out, let us bail out ourselves more verbosely
+		if [[ ! -e "$file" ]]; then
+			exit_with_error "FILE DELETION FAILED (missing): '${file}'; ${message}"
+		elif rm -- "$file"; then
+			display_alert "deleted file '${file}'" "$message" "info"
+		else
+			exit_with_error "FILE DELETION FAILED: '${file}'; ${message}"
+		fi
+		set -e # restore the previous behaviour
+	done
+}

lib/library-functions.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# This file is/was autogenerated by ./lib/tools/gen-library.sh; don't modify manually
+# This file is/was autogenerated by lib/tools/gen-library.sh; don't modify manually
 
 # no errors tolerated. invoked before each sourced file to make sure.
 #set -o pipefail  # trace ERR through pipes - will be enabled "soon"
@@ -748,6 +748,15 @@ set -o errexit  ## set -e : exit the script if any statement returns a non-true
 # shellcheck source=lib/functions/general/retry.sh
 source "${SRC}"/lib/functions/general/retry.sh
 
+# no errors tolerated. invoked before each sourced file to make sure.
+#set -o pipefail  # trace ERR through pipes - will be enabled "soon"
+#set -o nounset   ## set -u : exit the script if you try to use an uninitialised variable - one day will be enabled
+set -o errtrace # trace ERR through - enabled
+set -o errexit  ## set -e : exit the script if any statement returns a non-true return value - enabled
+### lib/functions/general/schedule_deletion.sh
+# shellcheck source=lib/functions/general/schedule_deletion.sh
+source "${SRC}"/lib/functions/general/schedule_deletion.sh
+
 # no errors tolerated. invoked before each sourced file to make sure.
 #set -o pipefail  # trace ERR through pipes - will be enabled "soon"
 #set -o nounset   ## set -u : exit the script if you try to use an uninitialised variable - one day will be enabled
@@ -1176,4 +1185,4 @@ source "${SRC}"/lib/functions/rootfs/trap-rootfs.sh
 #set -o nounset   ## set -u : exit the script if you try to use an uninitialised variable - one day will be enabled
 set -o errtrace # trace ERR through - enabled
 set -o errexit  ## set -e : exit the script if any statement returns a non-true return value - enabled
-# This file is/was autogenerated by ./lib/tools/gen-library.sh; don't modify manually
+# This file is/was autogenerated by lib/tools/gen-library.sh; don't modify manually