style(gswitch): add fzf header

Author: Bhavi Dhingra

cmd/gswitch

@@ -14,7 +14,7 @@ main () {
 
     __assertgitrepo
 
-    local branchName="$(__select_local_branch)"
+    local branchName="$(__select_local_branch "gswitch" "select local branch to switch to" "exit")"
     __exit_if_empty_str "${branchName}" ${SUCCESS}
 
     clear

util/__select_local_branch

@@ -1,10 +1,23 @@
 #!/bin/bash
 
-#shellcheck disable=SC2155	#	Declare and assign separately to avoid masking return values.
+#shellcheck disable=SC2155  # Declare and assign separately to avoid masking return values.
+#shellcheck disable=SC1091  # Not following: ./fzf_headers/__select_local_branch_header was not specified as input (see shellcheck -x)
 
+source "${__CUSTOM_GIT_UTIL}"/fzf_headers/__select_local_branch_header
+
+# Usage: __select_local_branch "gswitch" "select local branch to switch to" "exit"
 function __select_local_branch() {
 
-    local branchName=$(git branch --sort=-committerdate | fzf | sed 's/^. //g')
+    local cmd="${1}"
+    local cmdMsg="${2}"
+    local escAction="${3}"
+    local HEADER="$(__select_local_branch_header "${cmd}" "${cmdMsg}" "${escAction}")"
+    local branchName="$(git branch --sort=-committerdate |\
+                        fzf --height=50%\
+                            --header "${HEADER}" |\
+                        sed 's/^. //g')"
+
     local rawBranchNameFile="$(getrawstr "${branchName}")"
-    echo "${rawBranchNameFile}" | xargs -I "{}" echo {}     # xargs used to handle "invalid reference" error in git switch command
+    echo "${rawBranchNameFile}" | xargs -I "{}" echo {}     # xargs used to handle "invalid reference" for special characters
+                                                            # like ', '#' in branch names
 }

util/fzf_headers/__select_local_branch_header

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+#shellcheck disable=SC1091
+#shellcheck disable=SC2155
+#shellcheck disable=SC2001
+
+source "${__CUSTOM_CONSOLE_UTIL}"/__common	# for colors
+
+# Usage: __select_local_branch_header "gswitch" "select local branch" "exit"
+function __select_local_branch_header() {
+
+	local cmd="${1}"
+	local cmdMsg="${2}"
+	local escAction="${3}"
+	local colorMsg="${MAGENTA}${UNDERLINE}${cmd}${RESET} | ${cmdMsg}\n\n"
+	colorMsg="${colorMsg}${BLUE}esc:${RESET} ${escAction} "
+
+	local x="${cmd} | ${cmdMsg}"
+	local edge="$(echo "${x}" | sed "s/./-/g")"
+	local HEADER="${edge}\n${colorMsg}\n${edge}\n "
+
+	echo -e "${HEADER}"
+}