#!/bin/bash
#
# cli_printActionPreamble -- This function standardizes action
# preamble messages. Action preamble messages provides a confirmation
# message that illustrate what files will be affected in the action.
#
# Generally, actions are applied to parent directories. Each parent
# directory has parallel directories associated. If one parent
# directory is created/deleted, the parallel directories associated do
# need to be created/deleted too.
#
# Copyright (C) 2009-2011 Alain Reguera Delgado
# 
# 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA.
# 
# ----------------------------------------------------------------------
# $Id$
# ----------------------------------------------------------------------

function cli_printActionPreamble {

    local DIR=''
    local DIRS=''
    local PARENT="$1"
    local ACTION="$2"
    local FORMAT="$3"
    local COUNT_DIRS=0

    # Redefine directories using both parent and parallel directories
    # if PARENT path is only inside trunk/Identity structure.
    # Otherwise do not resolve parallel directories just parent ones.
    # This make possible to reuse cli_printActionPreamble in
    # functionalities that act on non-parent directory structures like
    # documentation (trunk/Manuals). 
    if [[ $PARENT =~ "^$(cli_getRepoTLDir ${PARENT})/Identity/.+$" ]];then
        for DIR in $(echo $PARENT);do
           DIRS="$DIRS $DIR $(cli_getRepoParallelDirs $DIR)"
        done
    else
        for DIR in $(echo $PARENT);do
           DIRS="$DIRS $DIR"
        done
    fi

    # Redefine total number of directories.
    COUNT_DIRS=$(echo "$DIRS" | sed -r "s! +!\n!g" | wc -l)

    # Redefine preamble messages based on action.
    case $ACTION in
        'doCreate' )
            ACTION="`ngettext "The following entry will be created" \
            "The following entries will be created" $COUNT_DIRS`:"
            ;;

        'doDelete' )
            ACTION="`ngettext "The following entry will be deleted" \
            "The following entries will be deleted" $COUNT_DIRS`:"
            ;;

        'doLocale' )
            ACTION="`ngettext "Translatable strings will be retrived from the following entry:" \
            "Translatable strings will be retrived from the following entries" $COUNT_DIRS`:"
            ;;

        * )
            cli_printMessage "cli_printActionPreamble: `gettext "The second argument is not valid."`" 'AsErrorLine'
            cli_printMessage "$(caller)" 'AsToKnowMoreLine'
            ;;
    esac

    # Print preamble message.
    cli_printMessage "$ACTION"
    for DIR in $(echo $DIRS);do
        cli_printMessage "$DIR" "$FORMAT"
    done
    cli_printMessage "`gettext "Do you want to continue"`" 'AsYesOrNoRequestLine'

}