[add] Create update script for Armored Turtle Automated Filament Changer (#614)

Introduces an automated update utility script, this script provides a command-line interface for updating the AFC software with safety checks and a menu-driven workflow.

Author: ejsears

update-afc.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# Armored Turtle Automated Filament Changer
+#
+# Copyright (C) 2024-2026 Armored Turtle
+#
+# This file may be distributed under the terms of the GNU GPLv3 license.
+
+set -e
+export LC_ALL=C
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+source "${SCRIPT_DIR}/include/constants.sh"
+
+# Menu functions
+source "${SCRIPT_DIR}/include/menus/main_menu.sh"
+source "${SCRIPT_DIR}/include/menus/install_menu.sh"
+source "${SCRIPT_DIR}/include/menus/update_menu.sh"
+source "${SCRIPT_DIR}/include/menus/utilities_menu.sh"
+source "${SCRIPT_DIR}/include/menus/additional_system_menu.sh"
+source "${SCRIPT_DIR}/include/utils.sh"
+
+# Install / Update functions
+source "${SCRIPT_DIR}/include/buffer_configurations.sh"
+source "${SCRIPT_DIR}/include/check_commands.sh"
+source "${SCRIPT_DIR}/include/colors.sh"
+source "${SCRIPT_DIR}/include/install_functions.sh"
+source "${SCRIPT_DIR}/include/uninstall.sh"
+source "${SCRIPT_DIR}/include/update_commands.sh"
+source "${SCRIPT_DIR}/include/update_functions.sh"
+
+source "${SCRIPT_DIR}/include/unit_functions.sh"
+
+original_args=("$@")
+
+main() {
+  ###################### Main script logic below ######################
+
+  while getopts "a:k:s:m:n:b:p:y:th" arg; do
+    case ${arg} in
+    a) moonraker_address=${OPTARG} ;;
+    k) klipper_dir=${OPTARG} ;;
+    m) moonraker_config_file=${OPTARG} ;;
+    n) moonraker_port=${OPTARG} ;;
+    s) klipper_service=${OPTARG} ;;
+    b) branch=${OPTARG} ;;
+    p) printer_config_dir=${OPTARG} ;;
+    y) klipper_venv=${OPTARG} ;;
+    t) test_mode=True ;;
+    h) show_help
+      exit 0 ;;
+    *) exit 1 ;;
+    esac
+  done
+
+  moonraker="${moonraker_address}:${moonraker_port}"
+
+  afc_config_dir="${printer_config_dir}/AFC"
+  afc_file="${afc_config_dir}/AFC.cfg"
+  moonraker_config_file="${moonraker_config_file:-${printer_config_dir}/moonraker.conf}"
+  afc_path="$HOME/AFC-Klipper-Add-On"
+
+
+  # Perform prerequisite and safety checks, then start the update process
+  echo "Ensuring we are not running as root..."
+  check_root
+  echo "Ensuring no conflicting software is present..."
+  check_for_hh
+  echo "Checking to ensure crudini and jq are present..."
+  check_for_prereqs
+  if [ "$test_mode" == "False" ]; then
+    check_python_version
+    clone_and_maybe_restart
+  fi
+  check_existing_install
+  echo "Starting update process..."
+  sleep 2
+  clear
+  update_menu
+}
+
+main "$@"