fax api improved

added options -help and -handle

README.md

@@ -3,6 +3,7 @@ This is a small hack to send faxes via the sipgate REST API from the command lin
 
 ## Deployment
 Add your login credentials to `login_credentials_muster.sh` and rename the file to `.env`
+If you use Letterheads Address database, uncomment the last line of that file and add `your/path/to/Letterhead` 
 
 ## Usage
 `./fax.sh <letter.pdf> <recipient>`

fax.sh

@@ -1,19 +1,60 @@
 #! /bin/bash
 
-#Check if I have enough parameters:
+function usage {
-if [ -z "$2" ]
-then
 	echo "Usage: 
 	$ ./fax.sh <letter.pdf> <recipient> 
-	where <recipient> has to be a german faxline number"
+	where <recipient> has to be a german faxline number
-	exit 1	
+	$ ./fax.sh <letter.pdf> -handle <handle>
-fi
+	Asks Letterhead's address database for <handle>'s fax number.
+	$ ./fax.sh -help
+	Print this Message and exit"
+	exit 1 
+}
+function abort {
+	echo "Letterhead API not available" 
+	exit 1
+}
 BASEPATH=$(dirname $(realpath $0))
+. $BASEPATH/.env
+
+#Parsing Parameters:
+unset $GETOPT_COMPATIBLE
+ARGV=$(getopt -n "$0" -a -o "" -l "help,handle:" -- "$@")
+if [ $? -ne 0 ]
+then
+	usage
+fi
+eval set -- "$ARGV"
+REC0=
+#Now we have $@ clean and tidy and begin parsing
+while :
+do
+	case "$1" in
+		"--help") usage ;;
+		"--handle") 
+			$LETTERHEAD_PATH/Adressen/address.sh -l > /dev/null || abort
+			REC0=$($LETTERHEAD_PATH/Adressen/address.sh -f $2 2>\dev\null | sed 's: ::g')
+			shift 
+			shift ;;
+		"--")
+			shift
+			break ;;
+	esac
+done
+#Check if you have enough parameters
+if [ -z $REC0 ]
+then
+	REC0=$2
+fi
+if [[ -z $REC0 || -z $1 ]]
+then
+	usage
+fi
 . $BASEPATH/authorization.sh
 #Prepare fax credentials:
 FILE=$1
 echo -n "Sending file ${FILE} "
-REC=$(echo "$2" | sed -e 's:[^+0-9]::g' -e 's:^0\([1-9]\):+49\1:')
+REC=$(echo "$REC0" | sed -e 's:[^+0-9]::g' -e 's:^0\([1-9]\):+49\1:')
 echo "to $REC"
 #Checking for file size:
 SIZE=$(ls -l $FILE | cut -d " " -f5)

login_credentials_muster.sh

@@ -1,3 +1,5 @@
 #Add your sipgate username and password here:
 SIPUSER=
 SIPPWD=
+#uncomment if you use Letterheads Address database
+#LETTERHEAD_PATH=