Scripts/Validation Update

scripts/validate/language_structure.sh

@@ -0,0 +1,114 @@
+# ============================================================================
+# 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. If not, see <https://www.gnu.org/licenses/>.
+#
+# FILE INFORMATION
+# DEFGROUP: Scripts.Validate
+# INGROUP: MokoStandards.Release
+# REPO: https://github.com/mokoconsulting-tech/MokoStandards
+# PATH: /scripts/validate/language_structure.sh
+# VERSION: 01.00.00
+# BRIEF: Validates Joomla language structure under src/language and enforces folder and INI naming conventions.
+# NOTE:
+# ============================================================================
+
+set -euo pipefail
+
+SRC_DIR="${SRC_DIR:-src}"
+LANG_ROOT="${LANG_ROOT:-${SRC_DIR}/language}"
+
+json_escape() {
+  python3 -c 'import json,sys; print(json.dumps(sys.argv[1]))' "$1"
+}
+
+[ -d "${SRC_DIR}" ] || {
+  printf '{"status":"fail","error":%s}
+' "$(json_escape "src directory missing")"
+  exit 1
+}
+
+python3 - <<'PY' "${LANG_ROOT}"
+import json
+import sys
+import re
+from pathlib import Path
+
+lang_root = Path(sys.argv[1])
+
+# Language directory is optional for some extension types
+if not lang_root.exists():
+  print(json.dumps({"status":"ok","lang_root":str(lang_root),"languages":[],"warnings":["language_root_missing"]}, ensure_ascii=False))
+  sys.exit(0)
+
+if not lang_root.is_dir():
+  print(json.dumps({"status":"fail","error":"language_root_not_directory","lang_root":str(lang_root)}, ensure_ascii=False))
+  sys.exit(1)
+
+lang_dirs = sorted([p for p in lang_root.iterdir() if p.is_dir()])
+
+# Joomla language tags: en-GB, fr-FR, etc.
+pattern = re.compile(r'^[a-z]{2}-[A-Z]{2}$')
+invalid = [p.name for p in lang_dirs if not pattern.match(p.name)]
+
+warnings = []
+
+# Soft expectation: en-GB exists if any language directories exist
+if lang_dirs and not (lang_root / 'en-GB').exists():
+  warnings.append('en-GB_missing')
+
+# Validate INI naming
+missing_ini = []
+nonmatching_ini = []
+
+for d in lang_dirs:
+  ini_files = [p for p in d.glob('*.ini') if p.is_file()]
+  if not ini_files:
+    missing_ini.append(d.name)
+    continue
+  for ini in ini_files:
+    if not (ini.name.startswith(d.name + '.') or ini.name == f"{d.name}.ini"):
+      nonmatching_ini.append(str(ini))
+
+result = {
+  "status": "ok",
+  "lang_root": str(lang_root),
+  "languages": [d.name for d in lang_dirs],
+  "warnings": warnings,
+}
+
+# Hard failures
+if invalid:
+  result.update({"status":"fail","error":"invalid_language_tag_dir","invalid":invalid})
+  print(json.dumps(result, ensure_ascii=False))
+  sys.exit(1)
+
+if nonmatching_ini:
+  result.update({"status":"fail","error":"ini_name_mismatch","nonmatching_ini":nonmatching_ini[:50]})
+  print(json.dumps(result, ensure_ascii=False))
+  sys.exit(1)
+
+if missing_ini:
+  result.update({"status":"fail","error":"missing_ini_files","missing_ini":missing_ini})
+  print(json.dumps(result, ensure_ascii=False))
+  sys.exit(1)
+
+print(json.dumps(result, ensure_ascii=False))
+PY
+
+echo "language_structure: ok"