feat: structured logging, CLI aliases, comprehensive README

- Rewrite colors.sh with proper log levels ([INF], [ OK], [WRN], etc.)
- Add timestamps, --verbose debug mode, --log-file support
- Add begin()/end_ok()/end_fail() progress bar helpers
- Add command aliases (by, sv, st, fw, wl, mn, etc.)
- Rewrite help with categorized command listing
- Write comprehensive README covering every command, layer, scenario
- All syntax verified with bash -n
This commit is contained in:
2026-06-20 12:10:24 -03:00
parent 789985d191
commit 1e35e5e0ef
3 changed files with 675 additions and 197 deletions
+75 -25
View File
@@ -1,4 +1,3 @@
RED='\033[1;31m'
GRN='\033[1;32m'
BLU='\033[1;34m'
@@ -7,50 +6,101 @@ CYAN='\033[1;36m'
MAG='\033[1;35m'
NC='\033[0m'
LOG_FILE=""
VERBOSE=false
log() {
local level="$1"
local msg="$2"
local color=""
local label=""
case "$level" in
ERROR) color="$RED"; label="ERR" ;;
WARN) color="$YEL"; label="WRN" ;;
OK) color="$GRN"; label=" OK" ;;
INFO) color="$BLU"; label="INF" ;;
STEP) color="$CYAN"; label="STP" ;;
DEBUG) color="$MAG"; label="DBG" ;;
*) color="$NC"; label="LOG" ;;
esac
if [ "$level" = "DEBUG" ] && [ "$VERBOSE" = false ]; then
return
fi
local ts
ts=$(date '+%H:%M:%S')
echo -e "${color}[${label}]${NC} ${msg}"
if [ -n "$LOG_FILE" ]; then
echo "[${ts}] [${label}] ${msg}" >> "$LOG_FILE" 2>/dev/null || true
fi
}
error_exit() {
echo -e "${RED}ERROR: $1${NC}" >&2
exit 1
log "ERROR" "$1" >&2
exit 1
}
warn() {
echo -e "${YEL}WARNING: $1${NC}" >&2
log "WARN" "$1"
}
success() {
echo -e "${GRN}\u2713 $1${NC}"
log "OK" "$1"
}
info() {
echo -e "${BLU}\u2139 $1${NC}"
log "INFO" "$1"
}
step() {
echo -e "${CYAN}\u25b8 $1${NC}"
log "STEP" "$1"
}
debug() {
log "DEBUG" "$1"
}
header() {
local title="$1"
echo ""
echo -e "${CYAN}╔═══════════════════════════════════════════════╗${NC}"
echo -e "${CYAN}║ ${title}${NC}"
echo -e "${CYAN}╚═══════════════════════════════════════════════╝${NC}"
echo ""
local title="$1"
local len="${#title}"
local line
line=$(printf '%*s' "$((len + 4))" | tr ' ' '═')
echo ""
echo -e "${CYAN}╔${line}╗${NC}"
echo -e "${CYAN}║ ${title} ║${NC}"
echo -e "${CYAN}╚${line}╝${NC}"
echo ""
}
begin() {
local label="$1"
echo -ne "${CYAN} ${label} ... ${NC}"
}
end_ok() {
echo -e "${GRN}✓${NC}"
}
end_fail() {
echo -e "${RED}✗${NC}"
}
prompt_default() {
local var_name="$1"
local prompt_text="$2"
local default="$3"
local value
read -p "$prompt_text (default '$default'): " value
value="${value:=$default}"
eval "$var_name=\"$value\""
local var_name="$1"
local prompt_text="$2"
local default="$3"
local value
read -p "${CYAN}${prompt_text}${NC} (default '${default}'): " value
value="${value:=$default}"
eval "$var_name=\"$value\""
}
confirm() {
local prompt="$1"
local response
read -p "$prompt (y/N): " response
[[ "$response" =~ ^[Yy]$ ]]
local prompt="$1"
local response
read -p "${prompt} (y/N): " response
[[ "$response" =~ ^[Yy]$ ]]
}