#!/bin/bash

#

# identity_renderConfigOption.sh -- This function standardizes the way

# action values are retrived from pre-rendition configuration files.

# Use this function whenever you need to retrive action values from

# pre-rendition configuration script.

#

# Usage: VAR=$(identity_renderConfigOption "ACTION" "FIELD")

#

# VAR is the name of the variable where we store the option named

# returned by identity_renderConfigOption. 

#

# ACTION is the string definition set in the pre-rendition

# configuration script that holds the action name and its options

# fields.

#

# FIELD is the field number in the action string we want to retrive

# option from. By default options start from third field on. The first

# field is reserved for the action type (i.e., POST or LAST), and the

# second field is reserved for the action itself (e.g., renderFormats,

# renderSyslinux, renderKsplash, etc.).

#

# 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 identity_renderConfigOption {

    local ACTION="$1"

    local FIELD="$2"

    local VALUE=''

    # Check action value. The action's value must be present in order

    # for this function to work. It provides the string needed to

    # retrive options from.

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

        cli_printMessage "`gettext "There is no action to work with."`"

        cli_printMessage "$(caller)" 'AsToKnowMoreLine'

    fi

    # Check field value. The field's value must match the cut's

    # command specification of its -f option.

    if [[ ! "$FIELD" =~ '^([0-9]+|[0-9]+-|-[0-9]+|[0-9]+-[0-9]+)$' ]];then

        cli_printMessage "`gettext "The field specified is not valid."`"

        cli_printMessage "$(caller)" 'AsToKnowMoreLine'

    fi

    # Get option from pre-rendition configuration action definition.

    VALUE=$(echo -n "$ACTION" | cut -d: -f${FIELD})

    # Sanitate action value passed from pre-rendition configuration

    # action definition.

    VALUE=$(echo -n "${VALUE}" \

        | sed -r 's!^ *!!g' \

        | sed -r 's!( |,|;) *! !g' \

        | sed -r 's! *$!!g')

    # Output action value without trailing newline.

    echo -n "$VALUE"

}