feat(new-command): gswitchremote helps to switch to a remote branch

Author: Bhavi Dhingra

cmd/gswitchremote

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+#shellcheck disable=SC1091  # Not following: ./__assertgitrepo was not specified as input
+#shellcheck disable=SC2086  # Double quote to prevent globbing and word splitting
+#shellcheck disable=SC2155  # Declare and assign separately to avoid masking return values
+
+# ensure the command is run in a git repo
+source "${__CUSTOM_GIT_UTIL}"/__assertgitrepo
+source "${__CUSTOM_GIT_UTIL}"/__select_remote_branch
+source "${__CUSTOM_CONSOLE_UTIL}"/__exit_if_empty_str
+source "${__CUSTOM_CONSOLE_UTIL}"/__common
+
+main () {
+
+    __assertgitrepo
+
+    local branchName="$(__select_remote_branch "gswitchremote" "select remote branch to switch to" "exit")"
+    __exit_if_empty_str "${branchName}" ${SUCCESS}
+
+    clear
+    git switch "${branchName}"
+}
+
+if [[ $# -gt 0 ]]; then
+    # branch name is provided in command line arguments
+    git switch "$*"
+    exit ${SUCCESS}
+fi
+
+main

util/__select_remote_branch

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