xcodebump.sh

#!/usr/bin/env bash
#
# STEmacsModelines:
# -*- Shell-Unix-Generic -*-
#
# This script does the following:
# 1. Update the Xcode marketing version string (CFBundleShortVersionString) to
#   the releaseVersion supplied.
# 2. Increment the Xcode build number (CFBundleVersion) to the bundleVersion
#   supplied or increment an existing number.
# 3. Commit changes to git.
# 4. Generate a tag to identify the commit the release/build and tag the commit.
#
# Dependencies:
# - Gnu Grep is required to support PCRE regex. On OSX you will have to install
#   this version of grep. Use homebrew. See instructions below.
#
# - Gnu Sed is required to support case insensitive match/replace. On OSX you
#   will have to install this version sed. Use homebrew. See instructions below.
#
# Installation:
# - Copy this script and the xcodebump-example.cfg file into a directory at
#   the root of your home folder:
#   >mkdir ~/.xcodebump
#   >cp xcodebump.sh ~/.xcodebump/xcodebump.sh
#   >chmod 755 ~/.xcodebump/xcodebump.sh
#   >cp xcodebump-example.cfg ~/.xcodebump/xcodebump-example.cfg
#   >chmod 644 ~/.xcodebump/xcodebump-example.cfg
#   >ln -s ~/.xcodebump/xcodebump.sh ~/bin/xcodebump
#

# Copyright (c) 2014-2016 Mark Eissler

# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:

# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

PATH_GIT="/usr/bin/git"
PATH_CUT="/usr/bin/cut"
PATH_HEAD="/usr/bin/head"
PATH_FIND="/usr/bin/find"
PATH_CP="/bin/cp"
PATH_RM="/bin/rm"
PATH_TOUCH="/usr/bin/touch"
PATH_BASENAME="/usr/bin/basename"

# Install gnu grep via homebrew... (this will not symlink for you)
#
# >brew tap homebrew/dupes
# >brew install homebrew/dupes/grep
#
# This will install the new grep as "ggrep" to avoid any conflicts with the BSD
# version of grep native to OSX.
#
PATH_GREP="/usr/local/bin/ggrep"

# Install gnu sed via homebrew... (this will not symlink for you)
#
# >brew tap homebrew/dupes
# >brew install gnu-sed
#
# This will install the new sed as "gsed" to avoid any conflicts with the BSD
# version of sed native to OSX.
#
PATH_SED="/usr/local/bin/gsed"


###### NO SERVICABLE PARTS BELOW ######
VERSION=1.2.2
PROGNAME=`basename $0`

# Where are we?
#
PATH_SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# standard config file location
PATH_CONFIG=".xcodebump.cfg"
PATH_CONFIG_EXAMPLE="${PATH_SCRIPT}/xcodebump-example.cfg"
PATH_PLIST_BUDDY="/usr/libexec/PlistBuddy"

# reset internal vars (do not touch these here)
DEBUG=0
ADDCONFIG=0
FORCEEXEC=0
FETCHINFO=0
GETOPT_OLD=0
TARGETNAME=""
TAG_PREFIX="build"
EMPTYPREFIX=0
MAKERELEASE=0
BUILDNUM=-1
BUILDNUM_START=1
BUILDVER=-1
BUILDVER_START="1.0.0"
PATH_PLIST=""

# standard BSD sed is called by cleanString(); we will find this
PATH_STD_SED=""

# podspec support
PATH_PODSPEC=""
PODSPEC_URL=""
PODSPEC_BRANCH_REL="master"
PODSPEC_BRANCH_DEV="develop"
UPDATEPODSPEC=0

#
# FUNCTIONS
#
function usage {
  if [ ${GETOPT_OLD} -eq 1 ]; then
    usage_old
  else
    usage_new
  fi
}

function usage_new {
cat << EOF
usage: ${PROGNAME} [options] releaseVersion

Update the marketing and build numbers for the xcode project. This script will
grab the info from the command line or configuration file.

OPTIONS:
   -a, --add-config             Adds config example to current directory
   -b, --build buildNumber      Sets build to buildNumber specified
   -d, --debug                  Turn debugging on (increases verbosity)
   -c, --path-config cFilePath  Path to config file (overrides default)
   -l, --path-plist iFilePath   Path to target Info.plist file (disables search)
   -p, --prefix tagPrefix       String to prepend to generated commit tag
   -e, --empty-prefix           Sets tagPrefix to an empty string
   -r, --release                Create a final release
   -t, --target targetName      Sets target to work on
   -s, --path-podspec sFilePath Path to podspec file (disables search)
   -u, --update-podspec         Update podspec file (for Cocoapod libraries)
   -w, --url-podspec podspecUrl Podspec file source url
   -i, --info                   Show keys/values from Info.plist and podspec
   -f, --force                  Execute updates without user prompt
   -h, --help                   Show this message
   -v, --version                Output version of this script

NOTE: If Podspec file source url does not end with a ".git" file extension, the
"targetName.git" string will be appended to the url.

EOF
}

# support for old getopt (non-enhanced, only supports short param names)
#
function usage_old {
cat << EOF
usage: ${PROGNAME} [options] releaseVersion

Update the marketing and build numbers for the xcode project. This script will
grab the info from the command line or configuration file.

OPTIONS:
   -a                           Adds config example to current directory
   -b buildNumber               Sets build to buildNumber specified
   -d                           Turn debugging on (increases verbosity)
   -c cFilePath                 Path to config file (overrides default)
   -l iFilePath                 Path to target Info.plist file (disables search)
   -p tagPrefix                 String to prepend to generated commit tag
   -e                           Sets tagPrefix to an empty string
   -r                           Create a final release
   -t targetName                Sets target to work on
   -s sFilePath                 Path to podspec file (disables search)
   -u                           Update podspec file (for Cocoapod libraries)
   -w podspecUrl                Podspec file source url
   -f                           Execute updates without user prompt
   -i                           Show keys/values from Info.plist and podspec
   -h                           Show this message
   -v                           Output version of this script

NOTE: If Podspec file source url does not end with a ".git" file extension, the
"targetName.git" string will be appended to the url.

EOF
}

function version {
  echo ${PROGNAME} ${VERSION};
}

# cleanString
#
# Pass a variable name and this function will determine its current value, clean
# up the value, and then assign it back to the variable. This is tricky because
# we will dereference the var in order to access its value.
#
# Given a variable ${example} - or - $example, you will want to access this
# function like this:
#
#   cleanString example
#
# Not:
#
#   cleanString ${example} - or - cleanString $example
#
# Because the latter two will past the value and not the name of the variable.
# Which means we wouldn't be able to dereference it and assign a new value.
#
function cleanString {
  # remove quotes (leading or trailing, single or double)
  local t
  eval t=\$${1}
  if [ -n "${t}" ]; then
    # fetch name of variable passed in arg1
    _argVarName=\$${1}
    # get the current value of the variable
    _argVarValue=`eval "expr \"${_argVarName}\""`
    # clean up the value (1) - remove leading/trailing quotes (single or double)
    _argVarValue_Clean=$(echo ${_argVarValue} | ${PATH_STD_SED} "s/^[\'\"]//" |  ${PATH_STD_SED} "s/[\'\"]$//" );
    # clean up the value (2) - convert encoded values to unencoded
    _argVarValue_Clean=$(echo ${_argVarValue_Clean} |  ${PATH_STD_SED} 's@%3D@=@g' |  ${PATH_STD_SED} 's@%3A@:@g' | ${PATH_STD_SED} 's@%2F@\\/@g' );

    # assign the cleaned up value to the variable passed in arg1
    eval "${1}=\${_argVarValue_Clean}"
  fi
}

# Support for urlEncode and urlDecode string manipulation.
#
export LANG=C

# urlEncode()
#
# Encode a string to html encoded.
#
# See: http://blogs.gnome.org/shaunm/2009/12/05/urlencode-and-urldecode-in-sh/
#
urlencode() {
  local arg
  arg="$1"
  while [[ "$arg" =~ ^([0-9a-zA-Z/:_\.\-]*)([^0-9a-zA-Z/:_\.\-])(.*) ]] ; do
    echo -n "${BASH_REMATCH[1]}"
    printf "%%%X" "'${BASH_REMATCH[2]}'"
    arg="${BASH_REMATCH[3]}"
  done
  # the remaining part
  echo -n "$arg"
}

# urlDecode()
#
# Decode an html encoded string.
#
# See: http://blogs.gnome.org/shaunm/2009/12/05/urlencode-and-urldecode-in-sh/
#
function urlDecode() {
  arg="$1"
  i="0"
  while [ "$i" -lt ${#arg} ]; do
    c0=${arg:$i:1}
    if [ "x$c0" = "x%" ]; then
      c1=${arg:$((i+1)):1}
      c2=${arg:$((i+2)):1}
      printf "\x$c1$c2"
      i=$((i+3))
    else
      echo -n "$c0"
      i=$((i+1))
    fi
  done
}

# isNumber()
#
function isNumber() {
  if [[ ${1} =~ ^[+-]?[0-9]+\.?[0-9]*$ ]]; then
    echo 1; return 0
  else
    echo 0; return 1
  fi
}

# semverToArray()
#
# Split a SemVer format version string (e.g. "1.0.0") into an array. We will
# write back the array to the variable that is passed to us.
#
# Call like this:
#
#   BUILDSTRING="1.2.3"
#   semverToArray BUILDSTRING
#   for e in "${BUILDSTRING[@]}"
#   do
#     echo $e
#   done
#
function semverToArray() {
  if [ -n "${1}" ]; then
    # fetch name of variable passed in arg1
    _argVarName=\$${1}
    # get the current value of the variable
    _argVarValue=`eval "expr ${_argVarName}"`
    # clean up the value (1) - remove leading/trailing quotes (single or double)
    _argVarValue_Clean=$(echo ${_argVarValue} | ${PATH_SED} "s/^[\'\"]//" |  ${PATH_SED} "s/[\'\"]$//" );

    # split into array, parse on dot character
    array=(${_argVarValue_Clean//./ })
    # if [[ ${DEBUG} -ne 0 ]]; then
    #   for i in "${array[@]}"
    #   do
    #     echo $i
    #   done
    # fi

    # assign the array to the variable passed in arg1
    eval "${1}=(\${array[@]})"
  fi
}

# isSemver()
#
# Check if string arg is in SemVer (1.0.0) format.
#
# NOTE: The return pattern here is structured so that all of the following tests
# will work because we echo a value and set the return status...
#
# Using return value (function exit status captured in $?):
#  STAT=$(isSemver "${BUILDVER}")
#  STAC=$?
#  if [[ ${STAC} -eq 0 ]]; then
#
# - or -
# Using echo value (captured in output from function):
#  if [[ $(isSemver "${BUILDVER}") -eq 1 ]]; then
#
# - or -
# Using echo value (captured in output from function):
#  if [ $(isSemver "${BUILDVER}") -eq 1 ]; then
#
function isSemver() {
  if [[ -z "${1}" ]]; then
    echo 0; return 1;
  fi

  isSemverArgArray=${1}
  semverToArray isSemverArgArray
  if [[ ${#isSemverArgArray[@]} -ne 3 ]]; then
    echo 0; return 1;
  fi

  # check each element to make sure it is a number
  for elem in "${isSemverArgArray[@]}"
  do
    isSemverArgArrayElement=${elem}
    if [[ $(isNumber "${isSemverArgArrayElement}") -eq 0 ]] || [[ ${isSemverArgArrayElement} -lt 0 ]]; then
      echo 0; return 1;
    fi
  done

  # got this far, we must have a valid SemVer string!
  echo 1; return 0;
}

# isGnuGrep()
#
# Checks for GNU Grep which supports PCRE (perl-type regex).
#
function isGnuGrep() {
  if [[ -z "${1}" ]]; then
    echo 0; return 1;
  fi

  RESP=$({ ${1} --version | ${PATH_HEAD} -n 1; } 2>&1 )
  RSLT=$?
  if [[ ! $RESP =~ "${1} (GNU grep)" ]]; then
    echo 0; return 1;
  fi

  echo 1; return 0;
}

# isGnuSed()
#
# Checks for GNU Sed which supports case insensitive match and replace.
#
function isGnuSed() {
  if [[ -z "${1}" ]]; then
    echo 0; return 1;
  fi

  RESP=$({ ${1} --version | ${PATH_HEAD} -n 1; } 2>&1 )
  RSLT=$?
  if [[ ! $RESP =~ "${1} (GNU sed)" ]]; then
    echo 0; return 1;
  fi

  echo 1; return 0;
}

# isPathWriteable()
#
# Checks if a given path (file or directory) is writeable by the current user.
#
function isPathWriteable() {
  if [ -z "${1}" ]; then
    echo 0; return 1
  fi

  # path is a directory...
  if [[ -d "${1}" ]]; then
    local path="${1%/}/.test"
    local resp rslt
    resp=$({ ${PATH_TOUCH} "${path}"; } 2>&1)
    rslt=$?
    if [[ ${rslt} -ne 0 ]]; then
      # not writeable directory
      echo 0; return 1
    else
      # writeable directory
      ${PATH_RM} "${path}"
      echo 1; return 0
    fi
  fi

  # path is a file...
  if [ -w "${1}" ]; then
    # writeable file
    echo 1; return 0
  else
    # not writeable file
    echo 0; return 1
  fi

  # and if we fall through...
  echo 0; return 128
}

# addConfig()
#
# Copy config example file to directory specified.
#
function addConfig() {
  if [[ -z "${1}" ]]; then
    echo 0; return 1;
  fi

  local _directory="${1}"

  if [[ -d "${_directory}" && $(isPathWriteable "${_directory}") -ne 1 ]] \
    || [[ ! -d "${_directory}" ]]; then
    exit 1
    echo 0; return 1;
  fi

  local _configFile="$(${PATH_BASENAME} "${PATH_CONFIG_EXAMPLE}")"
  RESP=$({ ${PATH_CP} "${PATH_CONFIG_EXAMPLE}" "${_directory}/.${_configFile}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo 0; return 1;
  fi

  echo 1; return 0;
}

# findInfoPlist()
#
# Search the current directory for a TARGET/Info.plist file, if not found try
# looking for a TARGET-Info.plist file.
#
function findInfoPlist() {
  _plistPath=$({ $PATH_FIND "./${TARGETNAME}" -type f -name "Info.plist" -print0; } 2>&1 )
  if [[ -z ${_plistPath} || $? -ne 0 ]]; then
    # try looking for a TARGET-Info.plist file...
    _plistPath=$({ $PATH_FIND . -type f -name "${TARGETNAME}-Info.plist" -print0; } 2>&1 )
    if [[ -z ${_plistPath} || $? -ne 0 ]]; then
      echo ""; return 1;
    fi
  fi

  echo ${_plistPath}; return 0
}

# findPodspec()
#
# Search the current directory for a TARGET.podspec file.
#
function findPodspec() {
  _podspecPath=$({ $PATH_FIND . -type f -name "${TARGETNAME}.podspec" -print0; } 2>&1 )
  if [[ -z ${_podspecPath} || $? -ne 0 ]]; then
    echo ""; return 1;
  fi

  echo ${_podspecPath}; return 0
}

# readInfoPlist()
#
# Read keys/values from the Info.plist passed by string in arg1, and write back
# as a new string-coded hash in the variable referenced by arg2.
#
# Call like this:
#
#   readInfoPlist plistPathStr, plistArray
#
# The resulting array is string-coded like this:
#
#   array=( \
#     "cfBundleShortVersionString=>'value'" \
#     "cfBundleVersion=>'value'" \
#   ")
#
function readInfoPlist() {
  local _cfBundleShortVersionString
  local _cfBundleVersion
  local _array=()
  local _length

  if [[ -z "${1}" ]] || [[ ! -r "${1}" ]]; then
    _array=( "error=>'Not found'" )
  elif [[ -n "${2}" ]]; then
    # fetch name of variable passed in arg1
    _argVarName=\$${2}

    _cfBundleShortVersionString=$({ $PATH_PLIST_BUDDY -c "Print CFBundleShortVersionString" "${1}"; } 2>&1 )
    if [[ $? -ne 0 ]]; then
      _cfBundleShortVersionString="";
    fi
    _cfBundleVersion=$({ $PATH_PLIST_BUDDY -c "Print CFBundleVersion" "${1}"; } 2>&1 )
    if [[ $? -ne 0 ]]; then
      _cfBundleVersion="";
    fi

    _array=( \
      "cfBundleShortVersionString=>'${_cfBundleShortVersionString}'" \
      "cfBundleVersion=>${_cfBundleVersion}" \
    )
  fi

  length=${#_array[*]}
  for ((i=0; i<=$(($length -1)); i++))
  do
    eval "${2}[$i]=\"${_array[$i]}\""
  done
}

# showInfoPlist()
#
# Show keys/values from the Info.plist passed by string in arg1.
#
# Call like this:
#
#   showInfoPlist plistPathStr
#
function showInfoPlist() {
  local _cfBundleShortVersionString
  local _cfBundleVersion
  _plistInfo=()
  readInfoPlist "${1}" _plistInfo

  if [[ ${#_plistInfo[@]} -gt 0 ]]; then

    # declare -a hash=("${_plistInfo[@]}")
    # for elem in "${hash[@]}"
    for elem in "${_plistInfo[@]}"
    do
      if [ "${DEBUG}" -ne 0 ]; then
        echo "Key: ${elem%%=>*}"
        echo "Value: ${elem#*=>}"
      fi

      local key=${elem%%=>*}
      local val=${elem#*=>}

      case "${key}" in
        cfBundleShortVersionString)     _cfBundleShortVersionString="${val}";;
        cfBundleVersion)                _cfBundleVersion="${val}";;
        error)                          # format errors
                                        local _val=${val};
                                        cleanString _val;
                                        echo "Plist Error: ${_val}";
                                        ;;
        *)                              ;;
      esac
    done
  fi

  if [[ -n ${_cfBundleShortVersionString} ]]; then
    cleanString _cfBundleShortVersionString
    echo "Plist CFBundleShortVersionString: ${_cfBundleShortVersionString}"
  fi

  if [[ -n ${_cfBundleVersion} ]]; then
    cleanString _cfBundleVersion
    echo "Plist CFBundleVersion:            ${_cfBundleVersion}"
  fi
}

# readPodspec()
#
# Read keys/values from the Target.podspec passed by string in arg1, and write
# back as a new string-coded hash in the variable referenced by arg2.
#
# Call like this:
#
#   readPodspec podspecPathStr, podspecArray
#
# The resulting array is string-coded like this:
#
#   array=( \
#     "version=>'value'" \
#     "source=>'value'" \
#   ")
#
function readPodspec() {
  local _podspecVersion
  local _podspecSource
  local _array=()
  local _length

  if [[ -z "${1}" ]] || [[ ! -r "${1}" ]]; then
    _array=( "error=>'Not found'" )
  elif [[ -n "${2}" ]]; then
    # fetch name of variable passed in arg1
    _argVarName=\$${2}

    _podspecVersion=$({ ${PATH_SED} -n -r "s|.*version\s*=\s*[\'\"]([0-9a-z\.\-]*)[\'\"]$|\1|gIp" ${1}; } 2>&1)
    if [[ $? -ne 0 ]]; then
      _podspecVersion="";
    fi
    _podspecSource=$({ ${PATH_SED} -n -r "s|.*source\s*=\s*(\{(.*)\})$|\1|gIp" ${1}; } 2>&1)
    if [[ $? -ne 0 ]]; then
      _podspecSource="";
    fi

    _array=( \
      "version=>'${_podspecVersion}'" \
      "source=>${_podspecSource}" \
    )
  fi

  length=${#_array[*]}
  for ((i=0; i<=$(($length -1)); i++))
  do
    eval "${2}[$i]=\"${_array[$i]}\""
  done
}

# showPodspec()
#
# Show keys/values from the Target.podspec passed by string in arg1.
#
# Call like this:
#
#   showPodspec podspecPathStr
#
function showPodspec() {
  local _podspecVersion
  local _podspecSource
  _podInfo=()
  readPodspec "${1}" _podInfo

  if [[ ${#_podInfo[@]} -gt 0 ]]; then

    # declare -a hash=("${_podInfo[@]}")
    # for elem in "${hash[@]}"
    for elem in "${_podInfo[@]}"
    do
      if [ "${DEBUG}" -ne 0 ]; then
        echo "Key: ${elem%%=>*}"
        echo "Value: ${elem#*=>}"
      fi

      local key=${elem%%=>*}
      local val=${elem#*=>}

      case "${key}" in
        version)                        _podspecVersion="${val}";;
        source)                         _podspecSource="${val}";;
        error)                          # format errors
                                        local _val=${val};
                                        cleanString _val;
                                        echo "Podspec Error: ${_val}";
                                        ;;
        *)                              ;;
      esac
    done
  fi

  if [[ -n ${_podspecVersion} ]]; then
    cleanString _podspecVersion
    echo "Podspec Version:                  ${_podspecVersion}"
  fi

  if [[ -n ${_podspecSource} ]]; then
    echo "Podspec Source:                   ${_podspecSource}"
  fi
}

# promptConfirm()
#
# Confirm a user action. Input case insensitive.
#
# Returns "yes" or "no" (default).
#
function promptConfirm() {
  read -p "$1 ([y]es or [N]o): "
  case $(echo $REPLY | tr '[A-Z]' '[a-z]') in
    y|yes) echo "yes" ;;
    *)     echo "no" ;;
  esac
}

# parse cli parameters
#
# Our options:
#   --add-config, a
#   --build, b
#   --path-config, c
#   --path-plist, l
#   --prefix, p
#   --empty-prefix, e
#   --release, r
#   --target, t
#   --path-podspec, s
#   --update-podspec, u
#   --url-podspec, w
#   --debug, d
#   --force, f
#   --info, i
#   --help, h
#   --version, v
#
params=""
getopt -T > /dev/null
if [ $? -eq 4 ]; then
  # GNU enhanced getopt is available
  PROGNAME=`basename $0`
  params="$(getopt --name "$PROGNAME" --long add-config,build:,path-config:,path-plist:,prefix:,empty-prefix,release,target:,path-podspec:,update-podspec,url-podspec:,force,info,help,version,debug --options ab:c:l:p:ert:s:uw:fihvd -- "$@")"
else
  # Original getopt is available
  GETOPT_OLD=1
  PROGNAME=`basename $0`
  params="$(getopt ab:c:l:p:ert:s:uw:fihvd "$@")"
fi

# check for invalid params passed; bail out if error is set.
if [ $? -ne 0 ]
then
  usage; exit 1;
fi

eval set -- "$params"
unset params

while [ $# -gt 0 ]; do
  case "$1" in
    -a | --add)             cli_ADDCONFIG=1; ADDCONFIG=${cli_ADDCONFIG};;
    -b | --build)           cli_BUILDNUM="$2"; shift;;
    -c | --path-config)     cli_CONFIGPATH="$2"; shift;;
    -l | --path-plist)      cli_PLISTPATH="$2"; shift;;
    -p | --prefix)          cli_TAG_PREFIX="$2"; shift;;
    -e | --empty-prefix)    cli_EMPTYPREFIX=1; EMPTYPREFIX=${cli_EMPTYPREFIX};;
    -r | --release)         cli_MAKERELEASE=1; MAKERELEASE=${cli_MAKERELEASE};;
    -t | --target)          cli_TARGETNAME="$2"; shift;;
    -s | --path-podspec)    cli_PODSPECPATH="$2"; shift;;
    -u | --update-podspec)  cli_UPDATEPODSPEC=1; UPDATEPODSPEC=${cli_UPDATEPODSPEC};;
    -w | --url-podspec)     cli_PODSPECURL="$2"; shift;;
    -d | --debug)           cli_DEBUG=1; DEBUG=${cli_DEBUG};;
    -f | --force)           cli_FORCEEXEC=1;;
    -i | --info)            cli_FETCHINFO=1; FETCHINFO=${cli_FETCHINFO};;
    -v | --version)         version; exit;;
    -h | --help)            usage; exit;;
    --)                     shift; break;;
  esac
  shift
done

# Copy config example file and quit
#
if [ "${ADDCONFIG}" -eq 1 ]; then
  echo
  printf "Copying example config file to current directory... "
  if [[ $(addConfig "${PWD}") -eq 0 ]]; then
    printf "!!"
    echo
    echo "ABORTING. Unable to access Xcodebump output directory: ${PWD}"
    echo "Must be a write permissions error."
    echo
    exit 1
  fi
  echo "Copied config file."
  echo "Make sure you edit the file and rename it to \".xcodebump.cfg\"."
  echo
  exit 0
fi

if [ "${FETCHINFO}" -eq 0 ]; then
  # Grab final argument (the release version aka BUILDVER)
  shift $((OPTIND-1))
  if [ -z "${1}" ]; then
    echo "ABORTING. You must specify a releaseVersion string."
    echo
    usage
    exit 1
  else
    cli_BUILDVER="${1}"
  fi
fi

# Configure std sed
#
if [[ -n "${PATH_SED}" ]] && [[ -x "${PATH_SED}" ]]; then
  PATH_STD_SED="${PATH_SED}"
elif [[ -x "/usr/bin/sed" ]]; then
  PATH_STD_SED="/usr/bin/sed"
else
  echo
  echo "FATAL. Something is wrong with this system. Unable to find standard sed."
  echo
  exit 1
fi

# Grab our config file path from the cli if provided
#
if [ -n "${cli_CONFIGPATH}" ]; then
  cleanString cli_CONFIGPATH;
  PATH_CONFIG=${cli_CONFIGPATH};
fi

# load config
echo
printf "Checking for a config file... "
if [ -s "${PATH_CONFIG}" ] && [ -r "${PATH_CONFIG}" ]; then
  source "${PATH_CONFIG}" &> /dev/null
else
  printf "!!"
  echo
  echo "ABORTING. The xcodebump config file ("${PATH_CONFIG}") is missing or empty!"
  echo
  _configDir=$(${PATH_DIRNAME} "${PATH_CONFIG}")
  _configExample="${_configDir}/.xcodebump-example.cfg"
  if [ -f "${_configExample}" ]; then
    echo "It looks like the example config file exists in the same location: "
    echo
    echo "     ${_configExample}"
    echo
    echo "Did you remember to customize and appropriately rename a copy of the example?"
    echo
  fi
  unset _configDir
  unset _configExample
  exit 1
fi
echo "Found: ${PATH_CONFIG}"
echo

# Verify grep version
printf "Checking for a compatible version of grep... "
if [[ $(isGnuGrep "${PATH_GREP}") -eq 0 ]]; then
  printf "!!"
  echo
  echo "ABORTING. Couldn't find a compatible version of grep. GNU grep is required."
  echo
  exit 1
fi
echo "Found: ${PATH_GREP}"
echo

# Verify sed version
printf "Checking for a compatible version of sed... "
if [[ $(isGnuSed "${PATH_SED}") -eq 0 ]]; then
  printf "!!"
  echo
  echo "ABORTING. Couldn't find a compatible version of sed. GNU sed is required."
  echo
  exit 1
fi
echo "Found: ${PATH_SED}"
echo
# Update standard sed to configured value (maybe have been overriden in cfg)
PATH_STD_SED="${PATH_SED}"

##
## SAFE TO CALL GNU GREP AND GNU SED FROM HERE ON IN!
##

# Clean up config file parameters
#
cleanString TARGETNAME
cleanString TAG_PREFIX
cleanString BUILDVER
cleanString BUILDVER_START
cleanString BUILDNUM
cleanString BUILDNUM_START
cleanString PATH_PLIST
cleanString PATH_PODSPEC
cleanString PODSPEC_URL
cleanString PODSPEC_BRANCH_DEV
cleanString PODSPEC_BRANCH_REL

# Rangle our vars (EARLY)
#
# We need TARGETNAME, and possibly PLISTPATH and PODSPECPATH before we run
# FETCHINFO calls.
#
if [ -n "${cli_TARGETNAME}" ]; then
  cleanString cli_TARGETNAME;
  TARGETNAME=${cli_TARGETNAME};
fi

if [ -n "${cli_PLISTPATH}" ]; then
  cleanString cli_PLISTPATH;
  PATH_PLIST=${cli_PLISTPATH};
fi

if [ -n "${cli_PODSPECPATH}" ]; then
  cleanString cli_PODSPECPATH;
  PATH_PODSPEC=${cli_PODSPECPATH};
fi

##
## IF FETCHINFO IS ON, SHOW INFO AND QUIT!
##
if [ "${FETCHINFO}" -eq 1 ]; then
  echo "Showing current values..."
  if [ -n "${TARGETNAME}" ]; then
    if [ -z "${PATH_PLIST}" ]; then
      PATH_PLIST=$(findInfoPlist)
    fi
    if [ -z "${PATH_PODSPEC}" ]; then
      PATH_PODSPEC=$(findPodspec)
    fi
  fi
  showInfoPlist "${PATH_PLIST}"
  if [ -r "${PATH_PODSPEC}" ]; then
    showPodspec "${PATH_PODSPEC}"
  fi
  exit 0
fi


# Rangle our vars (LATER)
#
# The cli_VARS will override config file vars!!
#
if [ -n "${cli_FORCEEXEC}" ]; then
  FORCEEXEC=${cli_FORCEEXEC};
fi

if [ -n "${cli_BUILDVER}" ]; then
  # check that the BUILDVER provided is in semVer format
  cleanString cli_BUILDVER
  BUILDVER=${cli_BUILDVER}

  if [[ $(isSemver "${BUILDVER}") -eq 0 ]]; then
    echo "ABORTING. You have specified a non-conforming releaseVersion. The"
    echo "release version string must conform to SemVer (Semantic Versioning)"
    echo "format."
    exit 1
  fi

  if [ "${DEBUG}" -ne 0 ]; then
    echo "BUILDVER set from cli: ${BUILDVER}"
  fi
fi

if [ -n "${BUILDVER_START}" ]; then
  if [[ $(isSemver "${BUILDVER_START}") -eq 0 ]]; then
    echo "ABORTING. You have specified a non-conforming BUILDVER_START. The"
    echo "BUILDVER_START string must conform to SemVer (Semantic Versioning)"
    echo "format."
    exit 1
  fi
else
  # use BUILDVER for BUILDVER_START
  BUILDVER_START=${BUILDVER};
fi

if [ -n "${cli_BUILDNUM}" ]; then
  cleanString cli_BUILDNUM;
  BUILDNUM=${cli_BUILDNUM};

  # if a number, buildnum must not be negative
  if [[ $(isNumber "${BUILDNUM}") -eq 1 ]] && [[ ${BUILDNUM} -lt 0 ]]; then
    echo "ABORTING. You have specified a buildNumber with a negative value!"
    exit 1
  fi
  # if a string, warn the user!
  if [[ $(isNumber "${BUILDNUM}") -eq 0 ]] && [[ ! -z ${BUILDNUM} ]]; then
    echo "WARNING. You have specificed a buildNumber that is a string."
    ##
    ## @TODO: Remove prompt for incorrect BUILDNUM
    ##
    # prompt user for confirmation
    if [[ "no" == $(promptConfirm "Update CFBundleVersion key with a string?") || \
      "no" == $(promptConfirm "Are you *really* sure?") ]]
    then
      echo "Aborting."
      exit 1
    fi
    ##
    ##
  fi
fi

if [ -n "${BUILDNUM_START}" ]; then
  # if a number, buildnum must not be negative
    if [[ $(isNumber "${BUILDNUM_START}") -eq 1 ]] && [[ ${BUILDNUM_START} -lt 0 ]]; then
      echo "ABORTING. You have specified a Buildnum with a negative value!"
      exit 1
    fi
    # if a string, warn the user!
    if [[ $(isNumber "${BUILDNUM_START}") -eq 0 ]] && [[ ! -z ${BUILDNUM_START} ]]; then
      echo "WARNING. You have specificed a BUILDNUM_START that is a string."
      ##
      ## @TODO: Remove prompt for incorrect BUILDNUM_START
      ##
      # prompt user for confirmation
      if [[ "no" == $(promptConfirm "Update CFBundleVersion key with a string?") || \
        "no" == $(promptConfirm "Are you *really* sure?") ]]
      then
        echo "Aborting."
        exit 1
      fi
      ##
      ##
    fi
else
  # use BUIILDNUM for BUILDNUM_START
  BUILDNUM_START=${BUILDNUM};
fi

# if release flag is on then buildnum must be specified as well!
if [ "${MAKERELEASE}" -eq 1 ] && [ -z "${cli_BUILDNUM}" ]; then
  if [ ${GETOPT_OLD} -eq 1 ]; then
    echo "ABORTING. To promote a build to release using the -r option, you must also"
    echo "identify a buildNumber with the -b option."
  else
    echo "ABORTING. To promote a build to release using the -r (release) option, you"
    echo "must identify a buildNumber with the -b (build) option."
  fi
  echo; usage;
  exit 1;
fi

# are both empty-prefix and prefix defined? bail out!
if [ -n "${cli_TAG_PREFIX}" ] && [ "${EMPTYPREFIX}" -eq 1 ]; then
  if [ ${GETOPT_OLD} -eq 1 ]; then
    echo "ABORTING. The -p and -e options cannot be combined."
  else
    echo "ABORTING. The -p (prefix) and -e (empty-prefix) options cannot be combined."
  fi
  echo; usage;
  exit 1;
elif [ -n "${cli_TAG_PREFIX}" ]; then
  cleanString cli_TAG_PREFIX;
  TAG_PREFIX=${cli_TAG_PREFIX};
elif [ "${EMPTYPREFIX}" -eq 1 ]; then
  TAG_PREFIX=""
fi

if [ -n "${cli_PODSPECURL}" ]; then
  cleanString cli_PODSPECURL;
  PODSPEC_URL=${cli_PODSPECURL};
  # if it doesn't end in .git, assume it is a base url
  if [[ ! ${PODSPEC_URL} =~ .git$ ]]; then
    PODSPEC_URL=$(echo "${PODSPEC_URL}" | ${PATH_SED} -r "s|\/$||");
    PODSPEC_URL="${PODSPEC_URL}/${TARGETNAME}.git";
  fi
fi

# bail out if minimum config isn't available
if [ -z "${TARGETNAME}" ] || [ -z "${BUILDNUM}" ] || [ -z "${BUILDVER}" ]; then
  echo; usage;
  exit 1
fi

# bail out if invalid BUILDNUM_START found
if [ -z "${BUILDNUM_START}" ]; then
  echo "ABORTING. Invalid or missing value for BUILDNUM_START in config file."
  exit 1
fi

#
# Let's GO!
#

# Find plist
printf "Checking for TARGET-Info.plist file... "
if [[ -z ${PATH_PLIST} ]]; then
  # try to find plist if not specified explicitly
  PATH_PLIST=$(findInfoPlist)
fi

if [[ -z ${PATH_PLIST} ]] || [[ ! -w ${PATH_PLIST} ]]; then
  echo
  echo "ABORTING. Unable to open plist file: ${PATH_PLIST}"
  echo
  exit 1
fi
echo "Found: ${PATH_PLIST}"
echo

#
# UPDATE CFBundleShortVersionString
#
RESP=$({ $PATH_PLIST_BUDDY -c "Print CFBundleShortVersionString" "${PATH_PLIST}"; } 2>&1 )
RSLT=$?
if [[ "${MAKERELEASE}" -eq 1 ]] && [[ "${RESP}" != "${BUILDVER}" ]]; then
  # release flag is on but specified BUILDVER and found BUILDVER differ
  if [[ $RESP =~ "Print: Entry, \"CFBundleShortVersionString\", Does Not Exist" || ${RSLT} -ne 0 ]]; then
    echo "CFBundleShortVersionString key not found in plist file."
  else
    echo "CFBundleShortVersionString key found in plist file: ${RESP}"
  fi
  echo
  echo "ABORTING. To promote a build to a release, the specified releaseVersion"
  echo "and the existing CFBundleShortVersionString must be the same value. You"
  echo "should run ${PROGNAME} first without the release option."
  echo
  echo "Showing current values..."
  showInfoPlist "${PATH_PLIST}"
  exit 1
fi

if [[ $RESP =~ "Print: Entry, \"CFBundleShortVersionString\", Does Not Exist" || ${RSLT} -ne 0 ]]; then
  #
  # Need to add a CFBundleShortVersionString key to plist
  #
  echo "CFBundleShortVersionString key not found in plist file."
  echo
  if [ "${FORCEEXEC}" -eq 0 ]; then
    echo "Ready to add a CFBundleShortVersionString key with start value of: ${BUILDVER_START}"
    # prompt user for confirmation
    if [[ "no" == $(promptConfirm "Add CFBundleShortVersionString key?") || \
      "no" == $(promptConfirm "Are you *really* sure?") ]]
    then
      echo "Aborting."
      exit 1
    fi
  fi

  echo "Adding CFBundleShortVersionString key with start value of: ${BUILDVER_START}"

  RESP=$({ $PATH_PLIST_BUDDY -c "Set CFBundleShortVersionString ${BUILDVER_START}" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to add CFBundleShortVersionString key to plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi

elif [[ $(isSemver "${RESP}") -eq 0 ]]; then
  #
  # CFBundleShortVersionString exists, but it's not SemVer format!
  #
  echo "CFBundleShortVersionString key found in plist file: ${RESP}"
  echo
  echo "ABORTING. Found a CFBundleShortVersionString in the plist file, but it"
  echo "does not conform to SemVer (Semantic Versioning) format. You will have"
  echo "to fix this manually."
  echo
  exit 1
else
  #
  # Update CFBundleShortVersionString key in plist
  #
  # @TODO!!
  #
  # if [[ ${BUILDVER} -eq -1 ]]; then
  #   # increment existing CFBundleShortVersionString
  #   BUILDVER=$(expr ${RESP} + 1)
  # fi

  RESP=$({ $PATH_PLIST_BUDDY -c "Set CFBundleShortVersionString ${BUILDVER}" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to update CFBundleShortVersionString key in plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi

  # verify success by re-reading updated value
  RESP=$({ $PATH_PLIST_BUDDY -c "Print CFBundleShortVersionString" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to verify updated CFBundleShortVersionString key in"
    echo "plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi
  echo "Updated CFBundleShortVersionString key value to: ${RESP}"
fi


#
# UPDATE CFBundleVersion
#
RESP=$({ $PATH_PLIST_BUDDY -c "Print CFBundleVersion" "${PATH_PLIST}"; } 2>&1 )
RSLT=$?
if [[ "${MAKERELEASE}" -eq 1 ]] && [[ "${RESP}" != "${BUILDNUM}" ]]; then
  # release flag is on but specified BUILDNUM and found BUILDNUM differ
  if [[ $RESP =~ "Print: Entry, \"CFBundleVersion\", Does Not Exist" || ${RSLT} -ne 0 ]]; then
    echo "CFBundleVersion key not found in plist file."
  else
    echo "CFBundleVersion key found in plist file: ${RESP}"
  fi
  echo
  echo "ABORTING. To promote a build to a release, the specified buildNumber"
  echo "and the existing CFBundleVersion must be the same value. You should"
  echo "run ${PROGNAME} first without the release option."
  echo
  echo "Showing current values..."
  showInfoPlist "${PATH_PLIST}"
  exit 1
fi

if [[ $RESP =~ "Print: Entry, \"CFBundleVersion\", Does Not Exist" || ${RSLT} -ne 0 ]]; then
  #
  # Need to add a CFBundleVersion key to plist
  #
  echo "CFBundleVersion key not found in plist file."
  echo
  if [ "${FORCEEXEC}" -eq 0 ]; then
    echo "Ready to add a CFBundleVersion key with start value of: ${BUILDNUM_START}"
    # prompt user for confirmation
    if [[ "no" == $(promptConfirm "Add CFBundleVersion key?") || \
      "no" == $(promptConfirm "Are you *really* sure?") ]]
    then
      echo "Aborting."
      exit 1
    fi
  fi

  echo "Adding CFBundleVersion key with start value of: ${BUILDNUM_START}"

  RESP=$({ $PATH_PLIST_BUDDY -c "Set CFBundleVersion ${BUILDNUM_START}" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to add CFBundleVersion key to plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi
elif [[ $(isNumber "${RESP}") -eq 0 ]] && [[ ${BUILDNUM} -eq -1 ]]; then
  #
  # CFBundleVersion exists, but it's not a number!
  #
  echo "CFBundleVersion key found in plist file: ${RESP}"
  echo
  echo "ABORTING. Found a CFBundleVersion in the plist file, but it's not an"
  echo "integer. So I can't increment it. You will have to fix this manually."
  echo
  exit 1
else
  #
  # Update CFBundleVersion key in plist by incrementing it
  #
  if [[ ${BUILDNUM} -eq -1 ]]; then
    # increment existing CFBundleVersion
    BUILDNUM=$(expr ${RESP} + 1)
  fi

  RESP=$({ $PATH_PLIST_BUDDY -c "Set CFBundleVersion ${BUILDNUM}" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to update CFBundleVersion key in plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi

  # verify success by re-reading updated value
  RESP=$({ $PATH_PLIST_BUDDY -c "Print CFBundleVersion" "${PATH_PLIST}"; } 2>&1 )
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to verify updated CFBundleVersion key in plist file."
    echo "Not sure what the problem is."
    echo
    exit 1
  fi
  echo "Updated CFBundleVersion key value to: ${RESP}"
fi

#
# Update podspec (if enabled)
#
if [[ "${UPDATEPODSPEC}" -ne 0 ]]; then
  echo
  printf "Checking for TARGET.podspec file... "
  if [[ -z ${PATH_PODSPEC} ]]; then
    # try to find podspec if not specified explicitly
    PATH_PODSPEC=$(findPodspec)
  fi

  if [[ -z ${PATH_PODSPEC} ]] || [[ ! -w ${PATH_PODSPEC} ]]; then
    echo
    echo "ABORTING. Unable to open podspec file: ${PATH_PODSPEC}"
    echo
    exit 1
  fi
  echo "Found: ${PATH_PODSPEC}"

  #
  # develop:
  #   s.version = "2.7.3-b248"
  #   s.source = { :git => 'https://github.com/markeissler/Reader.git', :branch => “develop", :tag => “2.7.3-b248” }
  #
  # release:
  #   s.version = "2.7.3"
  #   s.source = { :git => 'https://github.com/markeissler/Reader.git', :branch => "master", :tag => “2.7.3-f248” }
  #
  PODSPEC_TAG="${BUILDVER}-b${BUILDNUM}"
  PODSPEC_VER="${PODSPEC_TAG}"
  PODSPEC_SOURCE="{ :git => '${PODSPEC_URL}', :branch => '${PODSPEC_BRANCH_DEV}', :tag => '${PODSPEC_TAG}' }"

  if [[ "${MAKERELEASE}" -ne 0 ]]; then
    PODSPEC_TAG="${BUILDVER}-r${BUILDNUM}"
    PODSPEC_VER="${BUILDVER}"
    PODSPEC_SOURCE="{ :git => '${PODSPEC_URL}', :branch => '${PODSPEC_BRANCH_REL}', :tag => '${PODSPEC_TAG}' }"
  fi

  # make sure both s.version and s.source are present in the podspec file
  RESP=$({ ${PATH_GREP} -ioP "version\s*=\s*[\'\"][0-9a-z\.\-]*[\'\"]$" ${PATH_PODSPEC}; } 2>&1 \
    && { ${PATH_GREP} -ioP "source\s*=\s*{(.*)}$" ${PATH_PODSPEC}; } 2>&1)
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Either the Version line or Source line (or both) are missing from "
    echo "podspec file: ${PATH_PODSPEC}"
    echo
    exit 1
  fi

  # update the s.version line
  RESP=$({ ${PATH_SED} -i -r "s|(version\s*=\s*)[\'\"][0-9a-z\.\-]*[\'\"]$|\1\'${PODSPEC_VER}\'|gI" ${PATH_PODSPEC}; } 2>&1)
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to update the Version line in podspec file: ${PATH_PODSPEC}"
    echo
    exit 1
  fi
  echo "Updated Version key value to: ${PODSPEC_VER}"

  # update the s.source line
  RESP=$({ ${PATH_SED} -i -r "s|(source\s*=\s*)\{(.*)\}$|\1${PODSPEC_SOURCE}|gI" ${PATH_PODSPEC}; } 2>&1)
  RSLT=$?
  if [[ ${RSLT} -ne 0 ]]; then
    echo
    echo "ABORTING. Unable to update the Version line in podspec file: ${PATH_PODSPEC}"
    echo
    exit 1
  fi
  echo "Updated Source key value to: ${PODSPEC_SOURCE}"
fi

#
# Checkin to git
#

# When we commit, we will get a line back that includes the commit hash like so:
#
# $ git commit -m "Refactored the fidgety method."
# [develop 109fd18] Refactored the fidgety method.
# 3 files changed, 6 insertions(+), 6 deletions(-)
# ...
#

# create commit tag from TAG_PREFIX, BUILDVER and BUILDNUM
#
# NOTE: man git-check-ref-format for valid characters
#
GIT_COMMIT_TAG="${BUILDVER}-b${BUILDNUM}"
if [[ "${MAKERELEASE}" -ne 0 ]]; then
  GIT_COMMIT_TAG="${BUILDVER}-r${BUILDNUM}"
fi
if [[ -n "${TAG_PREFIX}" ]]; then
  GIT_COMMIT_TAG="${TAG_PREFIX}-${GIT_COMMIT_TAG}"
fi

RESP=$({ $PATH_GIT check-ref-format "xxx/${GIT_COMMIT_TAG}"; } 2>&1 )
RSLT=$?
if [[ ${RSLT} -ne 0 ]]; then
  #
  # GIT_COMMIT_TAG is an invalid git refname.
  #
  echo
  echo "ABORTING. The generated git commit tag is invalid: ${GIT_COMMIT_TAG}"
  echo "Consider revising the specified releaseVersion and/or buildNumber."
  echo
  echo "Showing current values..."
  showInfoPlist "${PATH_PLIST}"
  if [ -r "${PATH_PODSPEC}" ]; then
    showPodspec "${PATH_PODSPEC}"
  fi
  exit 1
fi

# make sure GIT_COMMIT_TAG doesn't conflict with an existing tag in the repo
RESP=$({ $PATH_GIT rev-parse "${GIT_COMMIT_TAG}"; } 2>&1 )
RSLT=$?
if [[ ${RSLT} -ne 128 ]]; then
  #
  # GIT_COMMIT_TAG already exists
  #
  echo
  echo "ABORTING. The generated git commit tag already exists: ${GIT_COMMIT_TAG}"
  echo "                                               commit: ${RESP}"
  echo
  echo "Consider revising the specified releaseVersion and/or buildNumber."
  echo
  echo "Showing current values..."
  showInfoPlist "${PATH_PLIST}"
  if [ -r "${PATH_PODSPEC}" ]; then
    showPodspec "${PATH_PODSPEC}"
  fi
  exit 1
fi

# determine current branch so we can extract our commit hash after committing
RESP=$({ $PATH_GIT rev-parse --abbrev-ref HEAD; } 2>&1 )
RSLT=$?
if [[ $RESP =~ "fatal: " || ${RSLT} -ne 0 ]]; then
  #
  # Couldn't determine current branch, maybe we're not in the right directory?
  #
  echo
  echo "ABORTING. Couldn't determine current branch or something else went wrong."
  echo "Are you in the correct directory?"
  echo
  exit 1
fi
GIT_CURRENT_BRANCH=${RESP}

# we need to escape GIT_CURRENT_BRANCH to use in a regex
GIT_CURRENT_BRANCH_ESC=$( echo ${GIT_CURRENT_BRANCH} | ${PATH_SED} -e 's/[\/&]/\\&/g' )

# are there files to commit?
RESP=$({ $PATH_GIT status --porcelain --null; } 2>&1 )
RSLT=$?
if [[ "${MAKERELEASE}" -eq 1 ]] && [[ $RESP == "" ]]; then
  if [ "${FORCEEXEC}" -eq 0 ]; then
    # warn that we are about to tag without committing any files
    echo "WARNING. You are about to promote a build to release without changing"
    echo "any additional files."
    ##
    ## @TODO: Remove prompt for incorrect BUILDNUM
    ##
    # prompt user for confirmation
    if [[ "no" == $(promptConfirm "Continue with release promotion?") || \
      "no" == $(promptConfirm "Are you *really* sure?") ]]
    then
      echo "Aborting."
      exit 1
    fi
    ##
    ##
  fi
else
  # add all files and commit
  RESP=$({ $PATH_GIT add .; $PATH_GIT commit -am "Updated build to ${GIT_COMMIT_TAG}"; } 2>&1 )
  RSLT=$?
  if [[ $RESP =~ "fatal: " || ${RSLT} -ne 0 ]]; then
    #
    # Unable to commit?!
    #
    echo
    echo "ABORTING. Unable to commit changes to git repo. Maybe you should try and"
    echo "run git manually with the --dry-run flag to see what's wrong."
    echo
    exit 1
  fi
fi

# Grab our commit hash, we do it this way because we cannot be sure that another
# commit hasn't occurred after ours and we want to tag *our* commit.
GIT_COMMIT_HASH=$( echo "${RESP}" | ${PATH_GREP} -oP "(?<=\[${GIT_CURRENT_BRANCH_ESC} )[a-f0-9]{7}(?=\])" )

# tag the commit
RESP=$({ $PATH_GIT tag -a -m "Added build tag ${GIT_COMMIT_TAG}" "${GIT_COMMIT_TAG}" ${GIT_COMMIT_HASH}; } 2>&1 )
RSLT=$?
if [[ $RESP =~ "fatal: " || ${RSLT} -ne 0 ]]; then
  #
  # Unable to commit?!
  #
  echo
  echo "ABORTING. Unable to apply tag to commit: ${GIT_COMMIT_HASH}"
  echo "Not sure what the problem is."
  echo
  exit 1
fi

echo
echo "All done..."
echo "Release Version (CFBundleShortVersionString) has been set to: ${BUILDVER}"
echo "Build Number (CFBundleVersion) has been set to: ${BUILDNUM}"
echo "Changes have been committed to git branch: ${GIT_CURRENT_BRANCH}"
echo "                               git commit: ${GIT_COMMIT_HASH}"
echo "                               and tagged: ${GIT_COMMIT_TAG}"
echo
echo "WARNING: You still need to push these changes to git remotes."
echo