dev

#!/bin/bash

# SPDX-FileCopyrightText: 2026 German Aerospace Center (DLR)
# SPDX-License-Identifier: Apache-2.0

###############################################################################
# Helper commands #
###################
# This script contains a few little helper commands to make development easier.
###############################################################################
set -e
set -o pipefail

# imports
source "$(dirname "${BASH_SOURCE[0]}")/scripts/utils.sh"

# global variables
PROJECT_ROOT="$(pwd)"
DOC_ROOT="${PROJECT_ROOT}/docs"
SCRIPTS_ROOT="${PROJECT_ROOT}/scripts"

# parse arguments
action=${1,,}; shift
[ "$action" == "--help" ] || [ "$action" == "-h" ] && action=help
while [[ $# -gt 0 ]]; do
  case $1 in
    --help|-h) action=help; shift ;;
    --version) action=version; shift ;;
    --) shift; break ;;
    *)
      # warn "Unknown argument: '$1'; Skip further parsing.";
      break ;;
  esac
done


no_actions="$(compgen -A function)"
###############################################################################
# action functions

function help() {
  actions="$(actions="$(printf '%s,' "${action_map[@]}")"; echo "{${actions%,}}")"
  [ ${#actions} -lt 22 ] && actions=$(printf '%-22s' "$actions") || actions="$actions\n$(printf %24s "")"
  info2 "usage: $0 <action>"
  info2 ""
  info2 "positional arguments:"
  info2 -e "  ${actions}Available sub commands"
  info2 "    help                Show this help message and exit"
  info2 "    start               Start documentation server"
  info2 "    test                Run all tests"
  info2 "    lint                Run all linter"
  info2 "    lint-doc            Run documentation linter"
  info2 "    lint-scripts        Run bash script linter"
  info2 "    doc                 Start documentation server"
  info2 "    doc-build           Build documentation"
  info2 "    licenses            Check licenses"
  info2 "    safety-check        Check dependencies for known security vulnerabilities"
  info2 "    install             Install package"
  info2 "    clean               Clean up local files"
  info2 "    version             Show package version"
  info2 "    versions            Show versions"
}

function version() {
  awk -F "=" '/version/ {print $2}' "${PROJECT_ROOT}/pyproject.toml" | awk -F'"' '{print $2}' | awk NF | head -n 1
}

function versions() {
  info "versions"
  if ! command -v docker > /dev/null 2>&1; then
    warn "uv not found, skipping uv version"
  else
    info "uv version: $(uv --version)"
  fi
  if ! command -v npm > /dev/null 2>&1; then
    warn "npm not found, skipping npm version"
  else
    info "npm version: $(npm --version)"
    info "node version: $(command -v node > /dev/null 2>&1 && node --version || echo "not found")"
  fi
  info -n "package version: "
  version
}

function install() {
  versions
  if ! command -v uv &> /dev/null; then
    if ! command -v curl &> /dev/null; then
      error "uv and curl are not installed. Please install one of them."
      exit 1
    fi
    info "install uv"
    curl -LsSf https://astral.sh/uv/install.sh | sh
  fi
  info "install package"
  uv sync --all-extras
}

function clean() {
  info "remove builds"
  rm -rf "${PROJECT_ROOT}/site"
  info "remove egg-info"
  rm -rf "${PROJECT_ROOT}/*.egg-info"
  info "remove tox"
  rm -rf "${PROJECT_ROOT}/.tox"
}

function start() {
  doc "$@"
}

function test() {
  versions
  info "run all tests"
  lint
}

function lint() {
  versions
  info "linting"
  lint-doc
  lint-scripts
}

function lint-doc() {
  info "lint documentation"
  # use markdownlint from David Anson (based on nodejs)
  # https://github.com/DavidAnson/markdownlint
  npm exec "markdownlint-cli2@0.22.0" -- "${DOC_ROOT}/**/*.md" "${PROJECT_ROOT}/README.md"
}

function lint-scripts() {
  info "lint bash scripts"
  info "shellcheck $(uv run shellcheck --version | head -n 2 | tail -n 1)"
  uv run shellcheck --external-sources --shell bash --source-path "${PROJECT_ROOT}" "${PROJECT_ROOT}/dev"
  uv run shellcheck --external-sources --shell bash --source-path "${SCRIPTS_ROOT}" "${SCRIPTS_ROOT}/"*.sh
}

function doc() {
  versions
  info "zensical version: $(uv run zensical --version)"
  info "start documentation server"
  # create and serve documentation
  uv run zensical serve "$@"
}

function doc-build() {
  versions
  info "zensical version: $(uv run zensical --version)"
  info "build documentation"
  uv run zensical build "$@"
}

function licenses() {
  info "search for license conflicts"
  uv run licensecheck
  info "search for non-compliant files with REUSE"
  uv run reuse lint
}

function safety-check() {
  info "check dependencies for known security vulnerabilities"
  # main only no dev dependencies etc.
  uv run tox --recreate -e safety
}


# create array with all action functions (above)
readarray -t action_map <<< "$(comm -3 <(compgen -A function) <(echo "$no_actions"))"
###############################################################################
# run action

if ! printf '%s\n' "${action_map[@]}" | grep -x -q "$action"; then
  echo "Invalid action : $action"
  echo "Allowed actions: ${action_map[*]}"
  echo "Use --help for more information"
  exit 1
fi

$action "$@"