util.sh

# vim: set ft=bash sw=3 ts=3 expandtab:
# General utility functions for use by the run script

# This is the set of basic tasks that must always exist
BASIC_TASKS="install update outdated format checks build test suite clean"
BASIC_TASKS_REGEX="^install$|^update$|^outdated$|^format$|^checks$|^build$|^test$|^suite$|^clean$"

# Run a command
run_command() {
   local COMMAND

   COMMAND="$1"
   shift 1

   if [ -f "$DOTRUN_DIR/commands/$COMMAND.sh" ]; then
      source "$DOTRUN_DIR/commands/$COMMAND.sh"
      if [ $? != 0 ]; then
         echo "Unable to source command: $COMMAND"
         exit 1
      fi

      command_$COMMAND "$@"
      if [ $? != 0 ]; then
         echo "Command failed: $COMMAND"
         exit 1
      fi
   else
      echo "Unknown command: $COMMAND"
      exit 1
   fi
} 

# Get a list of basic tasks
basic_tasks() {
   echo "$BASIC_TASKS"
}

# Get a list of additional tasks that have help, excluding basic tasks
additional_tasks() {
   local TASK
   cd "$DOTRUN_DIR/tasks" 
   for TASK in $(ls *.sh | sed 's/\.sh$//' | sort | egrep -v "$BASIC_TASKS_REGEX"); do
      if task_has_help "$TASK"; then
         echo "$TASK"
      fi
   done
   cd - >/dev/null
}

# Check whether a task exists
task_exists() {
   [ -f "$DOTRUN_DIR/tasks/$1.sh" ]
}

# Check whether has a help string
task_has_help() {
   [ ! -z "$(task_help "$1")" ]
}

# Run a task
run_task() {
   local TASK

   TASK="$1"
   shift 1

   source "$DOTRUN_DIR/tasks/$TASK.sh"
   if [ $? != 0 ]; then
      echo "Unable to source task: $TASK"
      exit 1
   fi

   task_$TASK "$@"
   if [ $? != 0 ]; then
      echo "Task failed: $TASK"
      exit 1
   fi
}

# Get the help output for a task
task_help() {
   local TASK
   TASK="$1"
   source "$DOTRUN_DIR/tasks/$TASK.sh"
   if [ $? == 0 ]; then
      help_$TASK
   fi
}

# Setup the runtime environment
setup_environment() {
   local EARLIEST_YEAR LATEST_YEAR

   DOTRUN_DIR="$REPO_DIR/.run"

   WORKING_DIR=$(mktemp -d)
   trap "rm -rf '$WORKING_DIR'" EXIT SIGINT SIGTERM
}

# Add addendum information to the end of the help output
add_addendum() {
   echo "The Python interpreter version is controlled by the .python-version file.  To"
   echo "test with a different version of Python temporarily, set \$UV_PYTHON in your"
   echo "shell, and execute 'run install'.  Make sure to unset and reinstall when done."
   echo ""
   if [ -f "$REPO_DIR/.run/addendum.sh" ]; then
      bash "$REPO_DIR/.run/addendum.sh"
      echo ""
   fi 
}

# Whether the current platform is Windows
is_windows() {
   case "$OSTYPE" in
      msys*|cygwin*) true;;
      *) false;;
   esac
}