#!/bin/bash
######################################################################
#
#   tcar.sh -- The CentOS Artwork Repository automation tool.
#
#   Written by:
#   * Alain Reguera Delgado <al@centos.org.cu>, 2009-2013
#
# Copyright (C) 2009-2013 The CentOS Artwork SIG
#
# 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 2 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, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
######################################################################

######################################################################
# Identity
######################################################################

declare -xr TCAR_SCRIPT_PACKAGE="tcar"
declare -xr TCAR_SCRIPT_VERSION="$(rpm -q --qf "%{VERSION}" ${TCAR_SCRIPT_PACKAGE})"

######################################################################
# Paths
######################################################################

# Base directory where repository files are installed in.
declare -xr TCAR_BASEDIR=/usr/share/tcar

# Base directory where final content is produced in. This value is
# also known as the "workplace" and should be customized later by the
# user, using the prepare module of tcar script.
declare -xr TCAR_WORKDIR=/tmp

# Base directory where automation scripts are installed in.
declare -xr TCAR_SCRIPT_BASEDIR=${TCAR_BASEDIR}/Scripts

# Directory to store temporal files.
declare -xr TCAR_SCRIPT_TEMPDIR=$(mktemp -p /tmp -d ${TCAR_SCRIPT_PACKAGE}-XXXXXX)

# Configuration files in order of reading preference. The last file in
# the list overlaps options set in previous files in the list. Use
# colon character to separate files in the list.
declare -xr TCAR_SCRIPT_CONFIG=${HOME}/.tcar.conf

# Base directory where man pages are searched at.
declare -xr TCAR_SCRIPT_MANUALS=/usr/share/man

# Base directory where automation script modules are installed in.
declare -xr TCAR_SCRIPT_MODULES_BASEDIR=${TCAR_SCRIPT_BASEDIR}/Modules

# Default text editor.
declare -x  TCAR_SCRIPT_EDITOR=/usr/bin/vim

######################################################################
# Internationalization
######################################################################

# Set the script language information using the LC format. This format
# shows both language and country information (e.g., `es_ES').
declare -xr TCAR_SCRIPT_LANG_LC=$(echo ${LANG} | cut -d'.' -f1)

# Set the script language information using the LL format. This format
# shows only the language information (e.g., `es').
declare -xr TCAR_SCRIPT_LANG_LL=$(echo ${TCAR_SCRIPT_LANG_LC} | cut -d'_' -f1)

# Set the script language information using the CC format. This format
# shows only the country information (e.g., `ES').
declare -xr TCAR_SCRIPT_LANG_CC=$(echo ${TCAR_SCRIPT_LANG_LC} | cut -d'_' -f2)

# Set function environments required by GNU gettext system.
. gettext.sh

# Set the script text domain. This information is used by gettext
# system to retrieve translated strings from machine object (MO) files
# with this name. This variable is reset each time a new module is
# loaded, so the correct files can be used.
declare -x TEXTDOMAIN="${TCAR_SCRIPT_PACKAGE}"

# Set the script text domain directory. This information is used by
# gettext system to know where the machine objects are stored in. This
# variable is reset each time a new module is loaded, so the correct
# files can be used.
declare -xr TEXTDOMAINDIR=/usr/share/locale

######################################################################
# Global Flags
######################################################################

# Set filter flag (-f|--filter).  This flag is mainly used to reduce
# the number of files to process and is interpreted as egrep-posix
# regular expression.  By default, when this flag is not provided, all
# paths in the working copy will match, except files inside hidden
# directories like `.svn' and `.git' that will be omitted.
declare -x  TCAR_FLAG_FILTER='[[:alnum:]_/-]+'

# Set verbosity flag (-q|--quiet). This flag controls whether
# tcar.sh script prints messages or not. By default, all
# messages are suppressed except those directed to standard error.
declare -x  TCAR_FLAG_QUIET='false'

# Set affirmative flag (-y|--yes). This flag controls whether
# tcar.sh script does or does not pass confirmation request
# points. By default, it doesn't.
declare -x  TCAR_FLAG_YES='false'

# Set debugger flag (-d|--debug). This flag controls whether
# tcar.sh script does or does not print debugging information.
# The tcar.sh script prints debug information to standard
# output.
declare -x  TCAR_FLAG_DEBUG='false'

######################################################################
# Global Functions
######################################################################

# Export script's environment functions.
for SCRIPT_FILE in $(ls ${TCAR_SCRIPT_BASEDIR}/tcar_*.sh);do
    if [[ -x ${SCRIPT_FILE} ]];then
        . ${SCRIPT_FILE}
        export -f $(grep '^function ' ${SCRIPT_FILE} | cut -d' ' -f2)
    else
        echo "${SCRIPT_FILE} `gettext "has not execution rights."`"
        exit 1
    fi
done

######################################################################
# Signals
######################################################################

# Trap signals in order to terminate the script execution correctly
# (e.g., removing all temporal files before leaving).  Trapping the
# exit signal seems to be enough by now, since it is always present as
# part of the script execution flow. Each time the tcar.sh
# script is executed it will inevitably end with an EXIT signal at
# some point of its execution, even if it is interrupted in the middle
# of its execution (e.g., through `Ctrl+C').
trap tcar_terminateScriptExecution 0

######################################################################
# Parse Command-line Arguments
######################################################################

declare -x TCAR_MODULE_NAME=''
declare -x TCAR_MODULE_ARGUMENT=''
declare -x TCAR_SCRIPT_ARGUMENT=''

# Retrieve module's name using the first argument of tcar.sh
# script as reference.
if [[ ! ${1} =~ '^-' ]];then
    TCAR_MODULE_NAME="${1}"; shift 1
else
    TCAR_MODULE_NAME=""
fi

# Initialize tcar.sh script specific options. The way tcar.sh script
# retrieves its options isn't as sophisticated (e.g., it doesn't
# provide valid-option verifications) as it is provided by getopt
# command. I cannot use getopt here because it is already used when
# loading module-specific options. Using more than one invocation of
# getopt in the same script is not possible (e.g., one of the
# invocations may enter in conflict with the other one when different
# option definitions are expected in the command-line.)
while true; do

    # Store non-option arguments passed to tcar.sh script.
    if [[ ! ${1} =~ '^-' ]];then
        TCAR_SCRIPT_ARGUMENT="${1} ${TCAR_SCRIPT_ARGUMENT}"
        shift 1
        if [[ $# -gt 0 ]];then
            continue
        else
            break
        fi
    fi

    case "${1}" in

        --help* )

            if [[ -z ${TCAR_MODULE_NAME} ]];then
                # Print tcar.sh script's help. Consider that the
                # --help option can receive an argument by using the
                # equal sign (e.g.,
                # --help=tcar_setModuleEnvironment.sh).  However, it
                # is not possible to use spaces instead of equal sign
                # because that would confuse other options from being
                # parsed.
                tcar_printHelp "${1}"
                exit 0
            else
                # Store the argument for further processing inside the
                # module environment that will be executed later.
                TCAR_MODULE_ARGUMENT="-g ${1} ${TCAR_MODULE_ARGUMENT}"
                shift 1
            fi
            ;;

        --version )

            # Print tcar.sh script's version.
            if [[ -z ${TCAR_MODULE_NAME} ]];then
                tcar_printVersion
                exit 0
            else
                TCAR_MODULE_ARGUMENT="-g ${1} ${TCAR_MODULE_ARGUMENT}"
                shift 1
            fi
            ;;

        --quiet )

            TCAR_FLAG_QUIET='true'
            shift 1
            ;;

        --yes )

            TCAR_FLAG_YES='true'
            shift 1
            ;;

        --debug )

            TCAR_FLAG_DEBUG='true'
            shift 1
            ;;

        * ) 

            # Store module-specific option arguments. This is, all
            # arguments not considered part of tcar.sh script
            # itself. The module-specific option arguments are passed,
            # later, to getopt for option processing, inside the
            # module-specific environments.
            TCAR_MODULE_ARGUMENT="-g ${1} ${TCAR_MODULE_ARGUMENT}"
            shift 1
            if [[ $# -gt 0 ]];then
                continue
            else
                break
            fi
            ;;
    esac
done

# Initiate module-specific environment.
tcar_setModuleEnvironment -m "${TCAR_MODULE_NAME}" ${TCAR_MODULE_ARGUMENT} ${TCAR_SCRIPT_ARGUMENT}

# At this point everything has been done without errors. So, exit
# tcar.sh script successfully.
exit 0