207 lines
9.9 KiB
Bash
207 lines
9.9 KiB
Bash
# ============================================================================
|
||
# Shared Utility Functions for Zsh Dotfiles
|
||
# ============================================================================
|
||
# Common helper functions used across multiple function files
|
||
# Note: colors.zsh provides: DF_* color variables and df_print_func_name
|
||
#
|
||
# Source this file in function files:
|
||
# source "${0:A:h}/../lib/utils.zsh"
|
||
# ============================================================================
|
||
|
||
# Ensure colors are loaded first (provides DF_* vars and df_print_func_name)
|
||
source "${0:A:h}/colors.zsh" 2>/dev/null || \
|
||
source "$HOME/.dotfiles/zsh/lib/colors.zsh" 2>/dev/null
|
||
|
||
# ============================================================================
|
||
# Common Print Functions
|
||
# ============================================================================
|
||
|
||
# Print a step/section header
|
||
df_print_step() {
|
||
echo -e "${DF_GREEN}==>${DF_NC} $1"
|
||
}
|
||
|
||
# Print success message
|
||
df_print_success() {
|
||
echo -e "${DF_GREEN}✓${DF_NC} $1"
|
||
}
|
||
|
||
# Print error message (to stderr)
|
||
df_print_error() {
|
||
echo -e "${DF_RED}✗${DF_NC} $1" >&2
|
||
}
|
||
|
||
# Print warning message
|
||
df_print_warning() {
|
||
echo -e "${DF_YELLOW}⚠${DF_NC} $1"
|
||
}
|
||
|
||
# Print info message
|
||
df_print_info() {
|
||
echo -e "${DF_CYAN}ℹ${DF_NC} $1"
|
||
}
|
||
|
||
# Print a section divider
|
||
df_print_section() {
|
||
echo ""
|
||
echo -e "${DF_BLUE}▶${DF_NC} $1"
|
||
echo -e "${DF_CYAN}─────────────────────────────────────────────────────────────${DF_NC}"
|
||
}
|
||
|
||
|
||
# ============================================================================
|
||
# MOTD-Style Header/Function Header
|
||
# ============================================================================
|
||
|
||
# Prints a standardized header box for scripts
|
||
# Usage: df_print_header "script-name"
|
||
# Usage: df_print_func_name "func-name"
|
||
|
||
df_print_func_name() {
|
||
local func_name="${1:-func}"
|
||
local datetime=$(date '+%a %b %d %H:%M')
|
||
local width=66
|
||
|
||
# Build horizontal line
|
||
local hline=""
|
||
for ((i=0; i<width; i++)); do hline+="═"; done
|
||
local inner=$((width - 2))
|
||
|
||
# Header content
|
||
local h_left="${func_name}"
|
||
local h_right="${datetime}"
|
||
local h_pad=$((inner - ${#h_left} - ${#h_right}))
|
||
local h_spaces=""
|
||
for ((i=0; i<h_pad; i++)); do h_spaces+=" "; done
|
||
echo ""
|
||
echo -e "${DF_GREY}╒${hline}╕${DF_NC}"
|
||
echo -e "${DF_GREY}│${DF_NC} ${DF_BOLD}${DF_LIGHT_BLUE}${h_left}${DF_NC}${h_spaces}${DF_NC}${DF_BOLD}${h_right}${DF_NC} ${DF_GREY}│${DF_NC}"
|
||
echo -e "${DF_GREY}╘${hline}╛${DF_NC}"
|
||
echo ""
|
||
}
|
||
|
||
df_print_header() {
|
||
local script_name="${1:-script}"
|
||
local user="${USER:-root}"
|
||
local hostname="${HOST:-${HOSTNAME:-$(hostname -s 2>/dev/null)}}"
|
||
local datetime=$(date '+%a %b %d %H:%M')
|
||
local width=66
|
||
|
||
# Build horizontal line
|
||
local hline=""
|
||
for ((i=0; i<width; i++)); do hline+="═"; done
|
||
local inner=$((width - 2))
|
||
|
||
# Header content
|
||
local h_left="✦ ${user}@${hostname}"
|
||
local h_center="${script_name}"
|
||
local h_right="${datetime}"
|
||
local h_pad=$(((inner - ${#h_left} - ${#h_center} - ${#h_right}) / 2))
|
||
local h_spaces=""
|
||
for ((i=0; i<h_pad; i++)); do h_spaces+=" "; done
|
||
|
||
echo ""
|
||
echo -e "${DF_GREY}╒${hline}╕${DF_NC}"
|
||
echo -e "${DF_GREY}│${DF_NC} ${DF_BOLD}${DF_LIGHT_BLUE}${h_left}${DF_NC}${h_spaces}${DF_LIGHT_GREEN}${h_center}${h_spaces}${DF_NC}${DF_BOLD}${h_right}${DF_NC} ${DF_GREY}│${DF_NC}"
|
||
echo -e "${DF_GREY}╘${hline}╛${DF_NC}"
|
||
echo ""
|
||
}
|
||
|
||
# ============================================================================
|
||
# Output Formatting Functions
|
||
# ============================================================================
|
||
|
||
# Print a step/action indicator (blue arrow)
|
||
df_print_step() { echo -e "${DF_BLUE}==>${DF_NC} $1"; }
|
||
|
||
# Print a success message (green checkmark)
|
||
df_print_success() { echo -e "${DF_GREEN}✓${DF_NC} $1"; }
|
||
|
||
# Print an error message (red X)
|
||
df_print_error() { echo -e "${DF_RED}✗${DF_NC} $1"; }
|
||
|
||
# Print a warning message (yellow warning sign)
|
||
df_print_warning() { echo -e "${DF_YELLOW}⚠${DF_NC} $1"; }
|
||
|
||
# Print an info message (cyan info icon)
|
||
df_print_info() { echo -e "${DF_CYAN}ℹ${DF_NC} $1"; }
|
||
|
||
# Print a section header (cyan label)
|
||
df_print_section() { echo -e "${DF_CYAN}$1:${DF_NC}"; }
|
||
|
||
# Print indented content
|
||
df_print_indent() { echo " $1"; }
|
||
|
||
# ============================================================================
|
||
# Command Dependency Checking
|
||
# ============================================================================
|
||
|
||
# Check if a command exists
|
||
df_cmd_exists() { command -v "$1" &>/dev/null; }
|
||
|
||
# Require a command, show install hint if missing
|
||
df_require_cmd() {
|
||
local cmd="$1"
|
||
local package="${2:-$1}"
|
||
|
||
if ! command -v "$cmd" &>/dev/null; then
|
||
df_print_error "$cmd not installed"
|
||
echo "Install: sudo pacman -S $package"
|
||
return 1
|
||
fi
|
||
return 0
|
||
}
|
||
|
||
# ============================================================================
|
||
# User Confirmation
|
||
# ============================================================================
|
||
|
||
# Ask for yes/no confirmation (defaults to no)
|
||
df_confirm() {
|
||
local prompt="$1"
|
||
read -q "REPLY?$prompt [y/N]: "
|
||
echo
|
||
[[ "$REPLY" =~ ^[Yy]$ ]]
|
||
}
|
||
|
||
# Confirm with warning prefix
|
||
df_confirm_warning() {
|
||
df_print_warning "$1"
|
||
df_confirm "Continue?"
|
||
}
|
||
|
||
# ============================================================================
|
||
# File/Directory Helpers
|
||
# ============================================================================
|
||
|
||
# Check if in a git repo
|
||
df_in_git_repo() { git rev-parse --git-dir &>/dev/null 2>&1; }
|
||
|
||
# Get git root directory
|
||
df_git_root() { git rev-parse --show-toplevel 2>/dev/null; }
|
||
|
||
# Ensure directory exists
|
||
df_ensure_dir() { [[ ! -d "$1" ]] && mkdir -p "$1"; }
|
||
|
||
# Ensure file exists with optional default content
|
||
df_ensure_file() {
|
||
local file="$1" content="${2:-}"
|
||
if [[ ! -f "$file" ]]; then
|
||
df_ensure_dir "$(dirname "$file")"
|
||
[[ -n "$content" ]] && echo "$content" > "$file" || touch "$file"
|
||
fi
|
||
}
|
||
|
||
# ============================================================================
|
||
# Environment Checks
|
||
# ============================================================================
|
||
|
||
df_in_tmux() { [[ -n "$TMUX" ]]; }
|
||
df_is_btrfs() { [[ "$(df -T / 2>/dev/null | awk 'NR==2 {print $2}')" == "btrfs" ]]; }
|
||
|
||
# ============================================================================
|
||
# FZF Helpers
|
||
# ============================================================================
|
||
|
||
df_fzf_opts() { echo "--height=50% --layout=reverse --border=rounded"; }
|