save progress

devops/scripts/lib/logging.sh

@@ -0,0 +1,181 @@
+#!/usr/bin/env bash
+# Shared Logging Library
+# Sprint: CI/CD Enhancement - Script Consolidation
+#
+# Purpose: Standard logging functions for all CI/CD scripts
+# Usage: source "$(dirname "${BASH_SOURCE[0]}")/lib/logging.sh"
+#
+# Log Levels: DEBUG, INFO, WARN, ERROR
+# Set LOG_LEVEL environment variable to control verbosity (default: INFO)
+
+# Prevent multiple sourcing
+if [[ -n "${__STELLAOPS_LOGGING_LOADED:-}" ]]; then
+    return 0
+fi
+export __STELLAOPS_LOGGING_LOADED=1
+
+# Colors (disable with NO_COLOR=1)
+if [[ -z "${NO_COLOR:-}" ]] && [[ -t 1 ]]; then
+    export LOG_COLOR_RED='\033[0;31m'
+    export LOG_COLOR_GREEN='\033[0;32m'
+    export LOG_COLOR_YELLOW='\033[1;33m'
+    export LOG_COLOR_BLUE='\033[0;34m'
+    export LOG_COLOR_MAGENTA='\033[0;35m'
+    export LOG_COLOR_CYAN='\033[0;36m'
+    export LOG_COLOR_GRAY='\033[0;90m'
+    export LOG_COLOR_RESET='\033[0m'
+else
+    export LOG_COLOR_RED=''
+    export LOG_COLOR_GREEN=''
+    export LOG_COLOR_YELLOW=''
+    export LOG_COLOR_BLUE=''
+    export LOG_COLOR_MAGENTA=''
+    export LOG_COLOR_CYAN=''
+    export LOG_COLOR_GRAY=''
+    export LOG_COLOR_RESET=''
+fi
+
+# Log level configuration
+export LOG_LEVEL="${LOG_LEVEL:-INFO}"
+
+# Convert log level to numeric for comparison
+_log_level_to_num() {
+    case "$1" in
+        DEBUG) echo 0 ;;
+        INFO)  echo 1 ;;
+        WARN)  echo 2 ;;
+        ERROR) echo 3 ;;
+        *)     echo 1 ;;
+    esac
+}
+
+# Check if message should be logged based on level
+_should_log() {
+    local msg_level="$1"
+    local current_level="${LOG_LEVEL:-INFO}"
+
+    local msg_num current_num
+    msg_num=$(_log_level_to_num "$msg_level")
+    current_num=$(_log_level_to_num "$current_level")
+
+    [[ $msg_num -ge $current_num ]]
+}
+
+# Format timestamp
+_log_timestamp() {
+    if [[ "${LOG_TIMESTAMPS:-true}" == "true" ]]; then
+        date -u +"%Y-%m-%dT%H:%M:%SZ"
+    fi
+}
+
+# Core logging function
+_log() {
+    local level="$1"
+    local color="$2"
+    shift 2
+
+    if ! _should_log "$level"; then
+        return 0
+    fi
+
+    local timestamp
+    timestamp=$(_log_timestamp)
+
+    local prefix=""
+    if [[ -n "$timestamp" ]]; then
+        prefix="${LOG_COLOR_GRAY}${timestamp}${LOG_COLOR_RESET} "
+    fi
+
+    echo -e "${prefix}${color}[${level}]${LOG_COLOR_RESET} $*"
+}
+
+# Public logging functions
+log_debug() {
+    _log "DEBUG" "${LOG_COLOR_GRAY}" "$@"
+}
+
+log_info() {
+    _log "INFO" "${LOG_COLOR_GREEN}" "$@"
+}
+
+log_warn() {
+    _log "WARN" "${LOG_COLOR_YELLOW}" "$@"
+}
+
+log_error() {
+    _log "ERROR" "${LOG_COLOR_RED}" "$@" >&2
+}
+
+# Step logging (for workflow stages)
+log_step() {
+    _log "STEP" "${LOG_COLOR_BLUE}" "$@"
+}
+
+# Success message
+log_success() {
+    _log "OK" "${LOG_COLOR_GREEN}" "$@"
+}
+
+# GitHub Actions annotations
+log_gh_notice() {
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::notice::$*"
+    else
+        log_info "$@"
+    fi
+}
+
+log_gh_warning() {
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::warning::$*"
+    else
+        log_warn "$@"
+    fi
+}
+
+log_gh_error() {
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::error::$*"
+    else
+        log_error "$@"
+    fi
+}
+
+# Group logging (for GitHub Actions)
+log_group_start() {
+    local title="$1"
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::group::$title"
+    else
+        log_step "=== $title ==="
+    fi
+}
+
+log_group_end() {
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::endgroup::"
+    fi
+}
+
+# Masked logging (for secrets)
+log_masked() {
+    local value="$1"
+    if [[ -n "${GITHUB_ACTIONS:-}" ]]; then
+        echo "::add-mask::$value"
+    fi
+}
+
+# Die with error message
+die() {
+    log_error "$@"
+    exit 1
+}
+
+# Conditional die
+die_if() {
+    local condition="$1"
+    shift
+    if eval "$condition"; then
+        die "$@"
+    fi
+}