[UX/UI] Add interactive checklist shell script modules for package management

tools/modules/functions/interface_checklist.sh

@@ -0,0 +1,105 @@
+module_options+=(
+	["interface_checklist,author"]="@Tearran"
+	["interface_checklist,maintainer"]="@Tearran"
+	["interface_checklist,feature"]="interface_checklist"
+	["interface_checklist,example"]="interface_checklist <title> <prompt> <options_array>"
+	["interface_checklist,desc"]="Reusable helper function to display a checklist using whiptail, dialog, or read."
+	["interface_checklist,status"]="Active"
+	["interface_checklist,group"]="Helpers"
+	["interface_checklist,arch"]="arm64"
+)
+# Helper function to display a checklist using whiptail/dialog/read
+function interface_checklist() {
+	local title="$1"
+	local prompt="$2"
+	local -n options_array="$3" # Use a nameref to pass the array by reference
+	local dialog_height=20
+	local dialog_width=78
+	local menu_height=10
+
+	# Prepare options for the checklist
+	local checklist_items=()
+	for ((i = 0; i < ${#options_array[@]}; i += 3)); do
+		checklist_items+=("${options_array[i]}" "${options_array[i+1]}" "${options_array[i+2]}")
+	done
+
+	# Display the checklist based on the dialog tool
+	local selected_items=""
+	case $DIALOG in
+		"whiptail")
+			selected_items=$(whiptail --title "$title" --checklist \
+				"$prompt" $dialog_height $dialog_width $menu_height \
+				"${checklist_items[@]}" 3>&1 1>&2 2>&3)
+			;;
+		"dialog")
+			selected_items=$(dialog --title "$title" --checklist \
+				"$prompt" $dialog_height $dialog_width $menu_height \
+				"${checklist_items[@]}" 2>&1 >/dev/tty)
+			;;
+		"read")
+			echo "$title"
+			echo "$prompt"
+			for ((i = 0; i < ${#options_array[@]}; i += 3)); do
+				echo "$((i / 3 + 1)). ${options_array[i]} - ${options_array[i+1]} (Default: ${options_array[i+2]})"
+			done
+			echo "Enter the numbers of the items you want to select, separated by spaces:"
+			read -r selected_indexes
+			selected_items=""
+			for index in $selected_indexes; do
+				selected_items+=" ${options_array[((index - 1) * 3)]}"
+			done
+			;;
+	esac
+
+	# Return the selected items
+	if [[ -z "$selected_items" ]]; then
+		echo "Checklist canceled."
+		return 1
+	fi
+
+	echo "$selected_items"
+}
+
+module_options+=(
+	["process_package_selection,author"]="@Tearran"
+	["process_package_selection,maintainer"]="@Tearran"
+	["process_package_selection,feature"]="process_package_selection"
+	["process_package_selection,example"]="process_package_selection <title> <prompt> <checklist_options_array>"
+	["process_package_selection,desc"]="Reusable helper function to process user-selected packages for installation or removal."
+	["process_package_selection,status"]="Active"
+	["process_package_selection,group"]="Helpers"
+	["process_package_selection,arch"]="x86-64 arm64 armhf"
+)
+#
+function process_package_selection() {
+	local title="$1"
+	local prompt="$2"
+	local -a checklist_options=("${!3}") # Accept checklist array as reference
+
+	# Display checklist to user
+	local selected_packages
+	selected_packages=$(interface_checklist "$title Management" "$prompt" checklist_options)
+
+	# Check if user canceled or made no selection
+	if [[ $? -ne 0 || -z $selected_packages ]]; then
+		echo "No changes made."
+		return 1
+	fi
+
+	# Process user selections
+	echo "Processing selected packages..."
+	for package in ${selected_packages//\"/}; do
+		if dpkg -l | grep -q "^ii.*$package"; then
+			# Package is installed, remove it
+			echo "Removing $package..."
+			pkg_remove "$package"
+		else
+			# Package is not installed, install it
+			echo "Installing $package..."
+			pkg_install "$package"
+		fi
+	done
+
+	echo "Package management complete."
+}
+

tools/modules/software/module_aptwizard.sh

@@ -0,0 +1,199 @@
+module_options+=(
+	["_checklist_proftpd,author"]="@Tearran"
+	["_checklist_proftpd,maintainer"]="@Tearran"
+	["_checklist_proftpd,feature"]="_checklist_proftpd"
+	["_checklist_proftpd,example"]=""
+	["_checklist_proftpd,desc"]="Dynamic ProFTPD package management with install/remove toggle."
+	["_checklist_proftpd,status"]="Active"
+	["_checklist_proftpd,group"]="Internet"
+	["_checklist_proftpd,arch"]="x86-64 arm64 armhf"
+)
+#
+function _checklist_proftpd() {
+	local title="proftpd"
+
+	# Convert the example string to an array
+	local commands
+	IFS=' ' read -r -a commands <<< "${module_options["_checklist_proftpd,example"]}"
+
+	## Dynamically manage ProFTPD packages
+	echo "Fetching $title-related packages..."
+	local package_list
+	# get a list of all packages
+	package_list=$(apt-cache search $title | awk '{print $1}')
+	if [[ -z "$package_list" ]]; then
+		echo "No $title-related packages found."
+		return 1
+	fi
+
+	# Prepare checklist options dynamically
+	local checklist_options=()
+	for package in $package_list; do
+		if dpkg-query -W -f='${Status}' "$package" 2>/dev/null | grep -q "^install ok installed$"; then
+			checklist_options+=("$package" "Installed" "ON")
+		else
+			checklist_options+=("$package" "Not installed" "OFF")
+		fi
+	done
+
+	process_package_selection "$title" "Select $title packages to install/remove:" checklist_options[@]
+}
+
+
+module_options+=(
+	["_checklist_browsers,author"]="@Tearran"
+	["_checklist_browsers,maintainer"]="@Tearran"
+	["_checklist_browsers,feature"]="_checklist_browsers"
+	["_checklist_browsers,example"]=""
+	["_checklist_browsers,desc"]="Browser installation and management (Firefox-ESR and Chromium and more)."
+	["_checklist_browsers,status"]="Active"
+	["_checklist_browsers,group"]="Internet"
+	["_checklist_browsers,arch"]="x86-64 arm64 armhf"
+)
+
+function _checklist_browsers() {
+	local title="Browsers"
+
+	# List of base browser packages to manage
+	#
+	local browser_packages=(
+		"firefox-esr"
+		"chromium"
+		"lynx"
+		"google-chrome"
+	)
+
+	# Manage browser installation/removal
+	echo "Fetching browser package details..."
+
+	# Prepare checklist options dynamically with descriptions
+	local checklist_options=()
+	for base_package in "${browser_packages[@]}"; do
+		# Find the main package and exclude auxiliary or irrelevant ones
+		local main_package
+		main_package=$(apt-cache search "^${base_package}$" | awk -F' - ' '{print $1 " - " $2}')
+
+		# Check if the main package exists and fetch its description
+		if [[ -n "$main_package" ]]; then
+			local package_name package_description
+			package_name=$(echo "$main_package" | awk -F' - ' '{print $1}')
+			package_description=$(echo "$main_package" | awk -F' - ' '{print $2}')
+
+			# Check if the package is installed and set its state
+			if dpkg-query -W -f='${Status}' "$package_name" 2>/dev/null | grep -q "^install ok installed$"; then
+				checklist_options+=("$package_name" "$package_description" "ON")
+			else
+				checklist_options+=("$package_name" "$package_description" "OFF")
+			fi
+		fi
+	done
+	if [[ ${#checklist_options[@]} -eq 0 ]]; then
+		echo "No $title packages found."
+		return 1
+	fi
+
+	process_package_selection "$title" "Select packages to install/remove:" checklist_options[@]
+}
+
+module_options+=(
+	["_checklist_editors,author"]="@Tearran"
+	["_checklist_editors,maintainer"]="@Tearran"
+	["_checklist_editors,feature"]="_checklist_editors"
+	["_checklist_editors,example"]=""
+	["_checklist_editors,desc"]="Editor installation and management (codium notepadqq and more)."
+	["_checklist_editors,status"]="Active"
+	["_checklist_editors,group"]="Internet"
+	["_checklist_editors,arch"]="x86-64 arm64 armhf"
+)
+#
+function _checklist_editors() {
+	local title="Editors"
+
+	# List of base editor packages to manage
+	local _packages=(
+		"nano"
+		"code"
+		"codium"
+		"notepadqq"
+	)
+
+	# Manage editor installation/removal
+	echo "Fetching $title package details..."
+
+	# Prepare checklist options dynamically with descriptions
+	local checklist_options=()
+	for base_package in "${_packages[@]}"; do
+		# Find the main package and exclude auxiliary or irrelevant ones
+		local main_package
+		main_package=$(apt-cache search "^${base_package}$" | awk -F' - ' '{print $1 " - " $2}')
+
+		# Check if the main package exists and fetch its description
+		if [[ -n "$main_package" ]]; then
+			local package_name package_description
+			package_name=$(echo "$main_package" | awk -F' - ' '{print $1}')
+			package_description=$(echo "$main_package" | awk -F' - ' '{print $2}')
+
+			# Check if the package is installed and set its state
+			if dpkg-query -W -f='${Status}' "$package_name" 2>/dev/null | grep -q "^install ok installed$"; then
+				checklist_options+=("$package_name" "$package_description" "ON")
+			else
+				checklist_options+=("$package_name" "$package_description" "OFF")
+			fi
+		fi
+	done
+	if [[ ${#checklist_options[@]} -eq 0 ]]; then
+		echo "No $title packages found."
+		return 1
+	fi
+
+	process_package_selection "$title" "Select packages to install/remove:" checklist_options[@]
+}
+
+module_options+=(
+	["module_aptwizard,author"]="@Tearran"
+	["module_aptwizard,maintainer"]="@Tearran"
+	["module_aptwizard,feature"]="module_aptwizard"
+	["module_aptwizard,example"]="help editor browser proftp"
+	["module_aptwizard,desc"]="Webmin setup and service setting."
+	["module_aptwizard,status"]="Active"
+	["module_aptwizard,doc_link"]="https://webmin.com/docs/"
+	["module_aptwizard,group"]="Management"
+	["module_aptwizard,port"]="10000"
+	["module_aptwizard,arch"]="x86-64 arm64 armhf"
+)
+
+function module_aptwizard() {
+	local title="Packages"
+	local self="${module_options["module_aptwizard,feature"]}"
+	# Convert the example string to an array
+	local commands
+	IFS=' ' read -r -a commands <<< "${module_options["$self,example"]}"
+
+	case "$1" in
+		"${commands[0]}")
+			## help/menu options for the module
+			echo -e "\nUsage: $self <command>"
+			echo -e "Commands: ${module_options["$self,example"]}"
+			echo "Available commands:"
+			# Loop through all commands (starting from index 1)
+			for ((i = 1; i < ${#commands[@]}; i++)); do
+				echo -e "\t${commands[i]}\t-Manage ${commands[i]} $title."
+			done
+			echo
+		;;
+		"${commands[1]}")
+			_checklist_editors
+		;;
+		"${commands[2]}")
+			_checklist_browsers
+		;;
+
+		"${commands[3]}")
+			_checklist_proftpd
+		;;
+		*)
+			echo "Invalid command. Try one of: ${module_options["$self,example"]}"
+
+		;;
+	esac
+}