#!/bin/bash

#

# cli_checkRepoDirSource.sh -- This function provides input validation

# to repository entries considered as source locations.

#

# Copyright (C) 2009, 2010, 2011 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.

#

# ----------------------------------------------------------------------

# $Id$

# ----------------------------------------------------------------------

function cli_checkRepoDirSource {

    # Define location in order to make this function reusable not just

    # for action value variable but whatever value passed as first

    # positional argument.

    local LOCATION=$1

    # Verify location. Assuming no location is passed as first

    # positional parameter to this function, print an error message

    # and stop script execution.

    if [[ "$LOCATION" == '' ]];then

        cli_printMessage "`gettext "The first positional parameter is required."`" --as-error-line

    fi

    # Check action value to be sure strange characters are kept far

    # away from path provided.

    cli_checkPathComponent $LOCATION

    # Redefine source value to build repository absolute path from

    # repository top level on. As we are removing

    # /home/centos/artwork/ from all centos-art.sh output (in order to

    # save horizontal output space), we need to be sure that all

    # strings begining with trunk/..., branches/..., and tags/... use

    # the correct absolute path. That is, you can refer trunk's

    # entries using both /home/centos/artwork/trunk/... or just

    # trunk/..., the /home/centos/artwork/ part is automatically added

    # here. 

    if [[ $LOCATION =~ '^(trunk|branches|tags)' ]];then

        LOCATION=${CLI_WRKCOPY}/$LOCATION 

    fi

    # Re-define source value to build repository absolute path from

    # repository relative paths. This let us to pass repository

    # relative paths as source value.  Passing relative paths as

    # source value may save us some typing; specially if we are stood

    # a few levels up from the location we want to refer to as source

    # value.  There is no need to pass the absolute path to it, just

    # refere it relatively.

    if [[ -d ${LOCATION} ]];then

        # Add directory to the top of the directory stack.

        pushd "$LOCATION" > /dev/null

        # Check directory existence inside the repository.

        if [[ $(pwd) =~ "^${CLI_WRKCOPY}" ]];then

            # Re-define source value using absolute path.

            LOCATION=$(pwd)

        else

            cli_printMessage "`eval_gettext "The location \\\"\\\$LOCATION\\\" is not valid."`" --as-error-line

        fi

        # Remove directory from the directory stack.

        popd > /dev/null

    elif [[ -f ${LOCATION} ]];then

        # Add directory to the top of the directory stack.

        pushd "$(dirname "$LOCATION")" > /dev/null

        # Check directory existence inside the repository.

        if [[ $(pwd) =~ "^${CLI_WRKCOPY}" ]];then

            # Re-define source value using absolute path.

            LOCATION=$(pwd)/$(basename "$LOCATION")

        else

            cli_printMessage "`eval_gettext "The location \\\"\\\$LOCATION\\\" is not valid."`" --as-error-line

        fi

        # Remove directory from the directory stack.

        popd > /dev/null

    fi

    # Output sanitated location.

    echo $LOCATION

}