Update common.sh

scripts/lib/common.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env sh
+
+# ============================================================================
+# Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
+#
+# This file is part of a Moko Consulting project.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program (./LICENSE.md).
+# ============================================================================
+
+# ============================================================================
+# FILE INFORMATION
+# ============================================================================
+# DEFGROUP: Script.Library
+# INGROUP: Common
+# REPO: https://github.com/mokoconsulting-tech
+# PATH: /scripts/lib/common.sh
+# VERSION: 01.00.00
+# BRIEF: Unified shared shell utilities for all CI and local scripts
+# NOTE:
+# ============================================================================
+
+set -eu
+
+# ----------------------------------------------------------------------------
+# Environment normalization
+# ----------------------------------------------------------------------------
+
+export LC_ALL=C
+export LANG=C
+
+is_ci() {
+	[ "${CI:-}" = "true" ]
+}
+
+require_cmd() {
+	command -v "$1" >/dev/null 2>&1 || {
+		printf '%s\n' "ERROR: Required command not found: $1" >&2
+		exit 1
+	}
+}
+
+# ----------------------------------------------------------------------------
+# Logging
+# ----------------------------------------------------------------------------
+
+log_info() {
+	printf '%s\n' "INFO: $*"
+}
+
+log_warn() {
+	printf '%s\n' "WARN: $*" >&2
+}
+
+log_error() {
+	printf '%s\n' "ERROR: $*" >&2
+}
+
+die() {
+	log_error "$*"
+	exit 1
+}
+
+# ----------------------------------------------------------------------------
+# Validation helpers
+# ----------------------------------------------------------------------------
+
+assert_file_exists() {
+	[ -f "$1" ] || die "Required file missing: $1"
+}
+
+assert_dir_exists() {
+	[ -d "$1" ] || die "Required directory missing: $1"
+}
+
+assert_non_empty() {
+	[ -n "${1:-}" ] || die "Expected non empty value"
+}
+
+# ----------------------------------------------------------------------------
+# Path helpers
+# ----------------------------------------------------------------------------
+
+script_root() {
+	cd "$(dirname "$0")/.." && pwd
+}
+
+normalize_path() {
+	printf '%s\n' "$1" | sed 's|\\|/|g'
+}
+
+# ----------------------------------------------------------------------------
+# Guardrails
+# ----------------------------------------------------------------------------
+
+fail_if_root() {
+	[ "$(id -u)" -eq 0 ] && die "Script must not run as root"
+}