auto-toolkit 0.1.0b1__py3-none-any.whl

auto_toolkit-0.1.0b1.data/data/share/auto-toolkit/libs/args.sh

@@ -0,0 +1,366 @@
+#!/usr/bin/env bash
+# Declarative argument parsing and usage generator for automation scripts.
+#
+# Example Usage:
+#   source "$LIB_DIR/common.sh"
+#   source "$LIB_DIR/args.sh"
+#
+#   cli_init "auto install auto-toolkit [OPTIONS]" \
+#       "Install and symlink auto CLI binary into your PATH."
+#
+#   cli_opt  "--path"       "-p" "Specify target installation directory" TARGET_DIR "$HOME/.local/bin"
+#   cli_flag "--dry-run"    "-d" "Simulate installation steps" DRY_RUN
+#   cli_flag "--force"      "-f" "Force overwrite of existing files" FORCE
+#
+#   cli_example "auto install auto-toolkit"
+#   cli_example "auto install auto-toolkit --dry-run"
+#
+#   cli_parse "$@"
+
+# Global CLI definitions
+CLI_USAGE=""
+CLI_DESCRIPTION=""
+CLI_OPTS=()
+CLI_EXAMPLES=()
+CLI_POSITIONAL=()
+
+# Initialize CLI metadata
+cli_init() {
+    CLI_USAGE="$1"
+    CLI_DESCRIPTION="${2:-}"
+    CLI_OPTS=()
+    CLI_EXAMPLES=()
+    CLI_POSITIONAL=()
+
+    # Automatically add built-in help flag
+    cli_flag "--help" "-h" "Show this help message and exit" CLI_SHOW_HELP false
+}
+
+# Register a boolean flag
+# Syntax: cli_flag <long> <short> <description> <var_name> [default_val=false]
+cli_flag() {
+    local long="${1#--}"
+    local short="${2#-}"
+    local desc="$3"
+    local var_name="$4"
+    local default_val="${5:-false}"
+
+    # Set default value in caller's environment
+    printf -v "$var_name" "%s" "$default_val"
+
+    CLI_OPTS+=("flag|${long}|${short}|${var_name}|${default_val}|${desc}")
+}
+
+# Register an option taking a value
+# Syntax: cli_opt <long> <short> <description> <var_name> [default_val=""] [required=false]
+cli_opt() {
+    local long="${1#--}"
+    local short="${2#-}"
+    local desc="$3"
+    local var_name="$4"
+    local default_val="${5:-}"
+    local required="${6:-false}"
+
+    # Set default value in caller's environment
+    printf -v "$var_name" "%s" "$default_val"
+
+    CLI_OPTS+=("val|${long}|${short}|${var_name}|${default_val}|${desc}|${required}")
+}
+
+# Add a usage example
+cli_example() {
+    CLI_EXAMPLES+=("$1")
+}
+
+# Print formatted help text
+cli_help() {
+    local c_bold="${COLOR_BOLD:-\033[1m}"
+    local c_cyan="${COLOR_CYAN:-\033[36m}"
+    local c_dim="${COLOR_DIM:-\033[90m}"
+    local c_reset="${COLOR_RESET:-\033[0m}"
+
+    echo -e "${c_bold}Usage:${c_reset} ${CLI_USAGE}"
+
+    if [[ -n "$CLI_DESCRIPTION" ]]; then
+        echo ""
+        echo -e "  ${CLI_DESCRIPTION}"
+    fi
+
+    if [[ ${#CLI_OPTS[@]} -gt 0 ]]; then
+        echo ""
+        echo -e "${c_bold}Options:${c_reset}"
+
+        # Calculate max flag width for clean alignment
+        local max_flag_len=0
+        local entry
+
+        for entry in "${CLI_OPTS[@]}"; do
+            IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+            local flag_display=""
+
+            if [[ -n "$opt_short" ]]; then
+                flag_display="-${opt_short}, --${opt_long}"
+            else
+                flag_display="    --${opt_long}"
+            fi
+
+            if [[ "$opt_type" == "val" ]]; then
+                flag_display="${flag_display} <val>"
+            fi
+
+            if [[ ${#flag_display} -gt $max_flag_len ]]; then
+                max_flag_len=${#flag_display}
+            fi
+        done
+
+        local col_width=$((max_flag_len + 4))
+
+        for entry in "${CLI_OPTS[@]}"; do
+            IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+            local flag_display=""
+
+            if [[ -n "$opt_short" ]]; then
+                flag_display="-${opt_short}, --${opt_long}"
+            else
+                flag_display="    --${opt_long}"
+            fi
+
+            if [[ "$opt_type" == "val" ]]; then
+                flag_display="${flag_display} <val>"
+            fi
+
+            local default_info=""
+
+            if [[ -n "$opt_default" && "$opt_default" != "false" ]]; then
+                default_info=" ${c_dim}(default: ${opt_default})${c_reset}"
+            fi
+
+            if [[ "$opt_req" == "true" ]]; then
+                default_info=" ${c_cyan}(required)${c_reset}"
+            fi
+
+            printf "  %-*s %s%b\n" "$col_width" "$flag_display" "$opt_desc" "$default_info"
+        done
+    fi
+
+    if [[ ${#CLI_EXAMPLES[@]} -gt 0 ]]; then
+        echo ""
+        echo -e "${c_bold}Examples:${c_reset}"
+
+        local ex
+
+        for ex in "${CLI_EXAMPLES[@]}"; do
+            echo -e "  $ex"
+        done
+    fi
+
+    echo ""
+}
+
+# Parse command-line arguments according to registered options
+cli_parse() {
+    local args=("$@")
+    CLI_POSITIONAL=()
+
+    while [[ ${#args[@]} -gt 0 ]]; do
+        local key="${args[0]}"
+
+        case "$key" in
+            -h|--help)
+                cli_help
+                exit 0
+                ;;
+
+            --)
+                shift
+                CLI_POSITIONAL+=("${args[@]}")
+                break
+                ;;
+
+            --*=*)
+                # Handle --option=value syntax
+                local opt_name="${key%%=*}"
+                opt_name="${opt_name#--}"
+                local opt_val="${key#*=}"
+                local matched=false
+                local entry
+
+                for entry in "${CLI_OPTS[@]}"; do
+                    IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+
+                    if [[ "$opt_long" == "$opt_name" && "$opt_type" == "val" ]]; then
+                        printf -v "$opt_var" "%s" "$opt_val"
+                        matched=true
+                        break
+                    fi
+                done
+
+                if [[ "$matched" == false ]]; then
+                    if command -v log_error &>/dev/null; then
+                        log_error "Unknown option: $key"
+                    else
+                        echo -e "Error: Unknown option: $key" >&2
+                    fi
+                    cli_help >&2
+                    exit 1
+                fi
+
+                args=("${args[@]:1}")
+                ;;
+
+            --*)
+                local opt_name="${key#--}"
+                local matched=false
+                local entry
+
+                for entry in "${CLI_OPTS[@]}"; do
+                    IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+
+                    if [[ "$opt_long" == "$opt_name" ]]; then
+                        if [[ "$opt_type" == "flag" ]]; then
+                            printf -v "$opt_var" "%s" "true"
+                            matched=true
+                            args=("${args[@]:1}")
+                            break
+                        elif [[ "$opt_type" == "val" ]]; then
+                            if [[ ${#args[@]} -lt 2 || "${args[1]}" =~ ^- ]]; then
+                                if command -v log_error &>/dev/null; then
+                                    log_error "Option '--$opt_long' requires a value."
+                                else
+                                    echo -e "Error: Option '--$opt_long' requires a value." >&2
+                                fi
+                                cli_help >&2
+                                exit 1
+                            fi
+
+                            printf -v "$opt_var" "%s" "${args[1]}"
+                            matched=true
+                            args=("${args[@]:2}")
+                            break
+                        fi
+                    fi
+                done
+
+                if [[ "$matched" == false ]]; then
+                    if command -v log_error &>/dev/null; then
+                        log_error "Unknown option: $key"
+                    else
+                        echo -e "Error: Unknown option: $key" >&2
+                    fi
+                    cli_help >&2
+                    exit 1
+                fi
+                ;;
+
+            -[a-zA-Z0-9]*)
+                local opt_name="${key#-}"
+                local matched=false
+
+                # 1. Check for combined single-character short flags (e.g. -fd, -xzf)
+                if [[ ${#opt_name} -gt 1 ]]; then
+                    local all_flags=true
+                    local matched_vars=()
+                    local i
+
+                    for (( i=0; i<${#opt_name}; i++ )); do
+                        local ch="${opt_name:i:1}"
+                        local ch_found=false
+                        local entry
+
+                        for entry in "${CLI_OPTS[@]}"; do
+                            IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+
+                            if [[ "$opt_short" == "$ch" && "$opt_type" == "flag" ]]; then
+                                matched_vars+=("$opt_var")
+                                ch_found=true
+                                break
+                            fi
+                        done
+
+                        if [[ "$ch_found" == false ]]; then
+                            all_flags=false
+                            break
+                        fi
+                    done
+
+                    if [[ "$all_flags" == true && ${#matched_vars[@]} -gt 0 ]]; then
+                        for v in "${matched_vars[@]}"; do
+                            printf -v "$v" "%s" "true"
+                        done
+
+                        args=("${args[@]:1}")
+                        continue
+                    fi
+                fi
+
+                # 2. Check if it matches a registered short option or flag
+                local entry
+
+                for entry in "${CLI_OPTS[@]}"; do
+                    IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+
+                    if [[ "$opt_short" == "$opt_name" ]]; then
+                        if [[ "$opt_type" == "flag" ]]; then
+                            printf -v "$opt_var" "%s" "true"
+                            matched=true
+                            args=("${args[@]:1}")
+                            break
+                        elif [[ "$opt_type" == "val" ]]; then
+                            if [[ ${#args[@]} -lt 2 || "${args[1]}" =~ ^- ]]; then
+                                if command -v log_error &>/dev/null; then
+                                    log_error "Option '-$opt_short' requires a value."
+                                else
+                                    echo -e "Error: Option '-$opt_short' requires a value." >&2
+                                fi
+                                cli_help >&2
+                                exit 1
+                            fi
+
+                            printf -v "$opt_var" "%s" "${args[1]}"
+                            matched=true
+                            args=("${args[@]:2}")
+                            break
+                        fi
+                    fi
+                done
+
+                if [[ "$matched" == false ]]; then
+                    if command -v log_error &>/dev/null; then
+                        log_error "Unknown option: $key"
+                    else
+                        echo -e "Error: Unknown option: $key" >&2
+                    fi
+                    cli_help >&2
+                    exit 1
+                fi
+                ;;
+
+            *)
+                CLI_POSITIONAL+=("$key")
+                args=("${args[@]:1}")
+                ;;
+        esac
+    done
+
+    # Validate required options
+    local entry
+
+    for entry in "${CLI_OPTS[@]}"; do
+        IFS='|' read -r opt_type opt_long opt_short opt_var opt_default opt_desc opt_req <<< "$entry"
+
+        if [[ "$opt_req" == "true" ]]; then
+            local current_val="${!opt_var}"
+
+            if [[ -z "$current_val" ]]; then
+                if command -v log_error &>/dev/null; then
+                    log_error "Missing required option: --${opt_long}"
+                else
+                    echo -e "Error: Missing required option: --${opt_long}" >&2
+                fi
+
+                cli_help >&2
+                exit 1
+            fi
+        fi
+    done
+}

auto_toolkit-0.1.0b1.data/data/share/auto-toolkit/libs/common.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# Common helper functions for logging, terminal colors, and temporary directory lifecycle
+
+# Color initialization (respects NO_COLOR, non-interactive terminals, and dumb terminal)
+init_colors() {
+    if [[ -z "${NO_COLOR:-}" && -t 1 && "${TERM:-}" != "dumb" ]]; then
+        COLOR_RESET="\033[0m"
+        COLOR_BOLD="\033[1m"
+        COLOR_RED="\033[31m"
+        COLOR_GREEN="\033[32m"
+        COLOR_YELLOW="\033[33m"
+        COLOR_BLUE="\033[34m"
+        COLOR_MAGENTA="\033[35m"
+        COLOR_CYAN="\033[36m"
+        COLOR_DIM="\033[90m"
+    else
+        COLOR_RESET=""
+        COLOR_BOLD=""
+        COLOR_RED=""
+        COLOR_GREEN=""
+        COLOR_YELLOW=""
+        COLOR_BLUE=""
+        COLOR_MAGENTA=""
+        COLOR_CYAN=""
+        COLOR_DIM=""
+    fi
+}
+
+init_colors
+
+log_info() {
+    echo -e "${COLOR_CYAN}==>${COLOR_RESET} ${COLOR_BOLD}$*${COLOR_RESET}"
+}
+
+log_step() {
+    echo -e "  ${COLOR_BLUE}->${COLOR_RESET} $*"
+}
+
+log_success() {
+    echo -e "  ${COLOR_GREEN}[✓]${COLOR_RESET} $*"
+}
+
+log_warn() {
+    echo -e "  ${COLOR_YELLOW}[!] Warning:${COLOR_RESET} $*" >&2
+}
+
+log_error() {
+    echo -e "  ${COLOR_RED}[✗] Error:${COLOR_RESET} $*" >&2
+}
+
+# Temporary directory tracking & cleanup
+declare -a _AUTO_TEMP_DIRS=()
+
+_cleanup_temp_dirs() {
+    local dir
+
+    for dir in "${_AUTO_TEMP_DIRS[@]}"; do
+        if [[ -d "$dir" ]]; then
+            rm -rf "$dir" 2>/dev/null || true
+        fi
+    done
+}
+
+trap '_cleanup_temp_dirs' EXIT INT TERM
+
+create_temp_dir() {
+    local prefix="${1:-auto-toolkit}"
+    local tmp_dir
+
+    tmp_dir="$(mktemp -d "/tmp/${prefix}.XXXXXX")"
+    _AUTO_TEMP_DIRS+=("$tmp_dir")
+
+    echo "$tmp_dir"
+}
+
+setup_temp_dir() {
+    local prefix="${1:-auto-toolkit}"
+
+    create_temp_dir "$prefix"
+}
+
+# Verify required binaries exist on host PATH
+require_commands() {
+    local missing=()
+    local cmd
+
+    for cmd in "$@"; do
+        if ! command -v "$cmd" &>/dev/null; then
+            missing+=("$cmd")
+        fi
+    done
+
+    if [[ ${#missing[@]} -gt 0 ]]; then
+        log_error "Missing required commands: ${missing[*]}"
+        log_error "Please install the missing tools and try again."
+        exit 1
+    fi
+
+    return 0
+}
+
+# Interactive confirmation prompt with default handling
+confirm_action() {
+    local prompt="${1:-Are you sure?}"
+    local default_ans="${2:-N}"
+
+    if [[ "${FORCE:-false}" == "true" ]]; then
+        return 0
+    fi
+
+    if [[ ! -t 0 ]]; then
+        [[ "${default_ans^^}" == "Y" ]] && return 0 || return 1
+    fi
+
+    local prompt_suffix="[y/N]"
+    [[ "${default_ans^^}" == "Y" ]] && prompt_suffix="[Y/n]"
+
+    read -r -p "$prompt $prompt_suffix " answer
+    answer="${answer:-$default_ans}"
+
+    [[ "${answer,,}" =~ ^y(es)?$ ]]
+}

auto_toolkit-0.1.0b1.data/data/share/auto-toolkit/libs/download.sh

@@ -0,0 +1,102 @@
+#!/usr/bin/env bash
+# Robust downloading utilities with retry logic, timeout, and progress feedback
+
+# Download a file from URL to output destination using curl or wget
+# Arguments:
+#   $1: Source URL (http://, https://, file://)
+#   $2: Destination file path
+#   $3: Retry attempts (default: 3)
+#   $4: Connection timeout in seconds (default: 15)
+fetch_file() {
+    local url="$1"
+    local dest="$2"
+    local retries="${3:-3}"
+    local timeout="${4:-15}"
+
+    if [[ -z "$url" || -z "$dest" ]]; then
+        echo "Usage: fetch_file <url> <dest> [retries] [timeout]" >&2
+        return 1
+    fi
+
+    local dest_dir
+    dest_dir="$(dirname "$dest")"
+    mkdir -p "$dest_dir"
+
+    # Handle local file:// protocol
+    if [[ "$url" =~ ^file:// ]]; then
+        local local_path="${url#file://}"
+
+        if [[ -f "$local_path" ]]; then
+            cp -f "$local_path" "$dest"
+            return 0
+        else
+            echo "Error: Local source file not found: $local_path" >&2
+            return 1
+        fi
+    fi
+
+    if command -v curl &>/dev/null; then
+        curl --fail \
+             --location \
+             --connect-timeout "$timeout" \
+             --retry "$retries" \
+             --retry-connrefused \
+             --silent \
+             --show-error \
+             -o "$dest" \
+             "$url"
+    elif command -v wget &>/dev/null; then
+        wget --tries="$retries" \
+             --timeout="$timeout" \
+             --quiet \
+             --show-progress \
+             -O "$dest" \
+             "$url"
+    else
+        echo "Error: Neither 'curl' nor 'wget' is available on this system." >&2
+        return 1
+    fi
+}
+
+# Fetch text content (e.g. version file, signature, key) to standard output
+# Arguments:
+#   $1: Source URL
+#   $2: Connection timeout in seconds (default: 10)
+fetch_text() {
+    local url="$1"
+    local timeout="${2:-10}"
+
+    if [[ -z "$url" ]]; then
+        echo "Usage: fetch_text <url> [timeout]" >&2
+        return 1
+    fi
+
+    # Handle local file:// protocol
+    if [[ "$url" =~ ^file:// ]]; then
+        local local_path="${url#file://}"
+
+        if [[ -f "$local_path" ]]; then
+            cat "$local_path"
+            return 0
+        else
+            echo "Error: Local source file not found: $local_path" >&2
+            return 1
+        fi
+    fi
+
+    if command -v curl &>/dev/null; then
+        curl --fail \
+             --location \
+             --connect-timeout "$timeout" \
+             --silent \
+             "$url"
+    elif command -v wget &>/dev/null; then
+        wget --timeout="$timeout" \
+             --quiet \
+             -O - \
+             "$url"
+    else
+        echo "Error: Neither 'curl' nor 'wget' is available on this system." >&2
+        return 1
+    fi
+}