Сделать псевдоним Bash, который принимает параметр?

Я использовал CShell (CSH), который позволяет вам создать псевдоним, который принимает параметр. Запись была что-то вроде

alias junk="mv \\!* ~/.Trash"

В Bash это не похоже на работу. Учитывая, что Bash обладает множеством полезных функций, я предполагаю, что эта функция была реализована, но мне интересно, как это сделать.

Псевдоним Bash напрямую не принимает параметры. Вам нужно будет создать функцию.

aliasне принимает параметры, но функция может быть вызвана как псевдоним. Например:

myfunction() {
    #do things with parameters like $1 such as
    mv "$1" "$1.bak"
    cp "$2" "$1"
}


myfunction old.conf new.conf #calls `myfunction`

Кстати, функции Bash, определенные в вашем .bashrcи других файлах, доступны как команды в вашей оболочке. Так, например, вы можете вызвать более раннюю функцию, как это

$ myfunction original.conf my.conf

Уточняя ответ выше, вы можете получить 1-строчный синтаксис, как и для псевдонимов, что более удобно для специальных определений в оболочке или файлах .bashrc:

bash$ myfunction() { mv "$1" "$1.bak" && cp -i "$2" "$1"; }

bash$ myfunction original.conf my.conf

Не забывайте точку с запятой перед закрывающей правой скобкой. Аналогично, для актуального вопроса:

csh% alias junk="mv \\!* ~/.Trash"

bash$ junk() { mv "$@" ~/.Trash/; }

Или:

bash$ junk() { for item in "$@" ; do echo "Trashing: $item" ; mv "$item" ~/.Trash/; done; }

Вопрос просто задан неправильно. Вы не создаете псевдоним, который принимает параметры, потому что aliasпросто добавляет второе имя для чего-то, что уже существует. Функциональность, которую хочет OP, - это functionкоманда для создания новой функции. Вам не нужно псевдоним функции, так как функция уже имеет имя.

Я думаю, что вы хотите что-то вроде этого:

function trash() { mv "$@" ~/.Trash; }

Это оно! Вы можете использовать параметры $ 1, $ 2, $ 3 и т. Д. Или просто заполнить их все $ @

TL; DR: сделать это вместо

Гораздо проще и удобочитаемее использовать функцию, чем псевдоним, чтобы поместить аргументы в середину команды.

$ wrap_args() { echo "before $@ after"; }
$ wrap_args 1 2 3
before 1 2 3 after

Если вы продолжите читать, вы узнаете то, что вам не нужно знать об обработке аргументов оболочки. Знание опасно. Просто получите желаемый результат, прежде чем темная сторона навсегда контролирует вашу судьбу.

осветление

bashпсевдонимы делать принимать аргументы, но только в конце :

$ alias speak=echo
$ speak hello world
hello world

Ввод аргументов в середину команды via aliasдействительно возможен, но это выглядит ужасно.

Не пытайтесь делать это дома, детки!

Если вам нравится обходить ограничения и делать то, что говорят другие, невозможно, вот рецепт. Только не вини меня, если твои волосы запутались, а твое лицо покрылось сажей в стиле безумного ученого.

Обходной путь должен передать аргументы, которые aliasпринимают только в конце, оболочке, которая вставит их в середину и затем выполнит вашу команду.

Решение 1

Если вы действительно против использования функции как таковой, вы можете использовать:

$ alias wrap_args='f(){ echo before "$@" after;  unset -f f; }; f'
$ wrap_args x y z
before x y z after

Вы можете заменить $@на, $1если вы хотите только первый аргумент.

Объяснение 1

Это создает временную функцию f, которой передаются аргументы (обратите внимание, что она fвызывается в самом конце). unset -fУдаляет определение функции в качестве псевдонима выполняется так что не торчать после этого.

Решение 2

Вы также можете использовать подоболочку:

$ alias wrap_args='sh -c '\''echo before "$@" after'\'' _'

Объяснение 2

Псевдоним создает команду вроде:

sh -c 'echo before "$@" after' _

Комментарии:

• Заполнитель _обязателен, но это может быть что угодно. Он получает значение shs $0и необходим для того, чтобы первый из заданных пользователем аргументов не использовался. Демонстрация:

  sh -c 'echo Consumed: "$0" Printing: "$@"' alcohol drunken babble
  Consumed: alcohol Printing: drunken babble

• Одиночные кавычки внутри одинарных кавычек обязательны. Вот пример того, как он не работает с двойными кавычками:

  $ sh -c "echo Consumed: $0 Printing: $@" alcohol drunken babble
  Consumed: -bash Printing:

  Здесь значения интерактивной оболочки $0и $@заменяются в двойные кавычки, прежде чем он передаетсяsh . Вот доказательство:

  echo "Consumed: $0 Printing: $@"
  Consumed: -bash Printing:

  Одинарные кавычки гарантируют, что эти переменные не интерпретируются интерактивной оболочкой и передаются буквально sh -c .

  Вы можете использовать двойные кавычки и \$@, но лучше всего указывать свои аргументы (так как они могут содержать пробелы), и \"\$@\"выглядит еще страшнее, но может помочь вам выиграть конкурс на запутывание, где запутанные волосы являются обязательным условием для участия.

Альтернативное решение состоит в том, чтобы использовать маркер , инструмент, который я недавно создал, который позволяет вам «закладывать» шаблоны команд и легко размещать курсор на заполнителях команд:

Я обнаружил, что большую часть времени я использую функции оболочки, поэтому мне не нужно снова и снова писать часто используемые команды в командной строке. Проблема использования функций для этого варианта использования заключается в добавлении новых терминов в мой командный словарь и необходимости запоминать, на какие параметры функций ссылаются в реальной команде. Цель маркера - устранить это умственное бремя.

Все, что вам нужно сделать, это сделать функцию внутри псевдонима:

$ alias mkcd='_mkcd(){ mkdir "$1"; cd "$1";}; _mkcd'

Вы должны поместить двойные кавычки вокруг "$ 1", потому что одинарные кавычки не будут работать.

Вот три примера функций, которые у меня есть ~/.bashrc, которые по сути являются псевдонимами, которые принимают параметр:

#Utility required by all below functions.
#/programming/369758/how-to-trim-whitespace-from-bash-variable#comment21953456_3232433
alias trim="sed -e 's/^[[:space:]]*//g' -e 's/[[:space:]]*\$//g'"

,

:<<COMMENT
    Alias function for recursive deletion, with are-you-sure prompt.

    Example:
        srf /home/myusername/django_files/rest_tutorial/rest_venv/

    Parameter is required, and must be at least one non-whitespace character.

    Short description: Stored in SRF_DESC

    With the following setting, this is *not* added to the history:
        export HISTIGNORE="*rm -r*:srf *"
    - https://superuser.com/questions/232885/can-you-share-wisdom-on-using-histignore-in-bash

    See:
    - y/n prompt: https://stackoverflow.com/a/3232082/2736496
    - Alias w/param: https://stackoverflow.com/a/7131683/2736496
COMMENT
#SRF_DESC: For "aliaf" command (with an 'f'). Must end with a newline.
SRF_DESC="srf [path]: Recursive deletion, with y/n prompt\n"
srf()  {
    #Exit if no parameter is provided (if it's the empty string)
        param=$(echo "$1" | trim)
        echo "$param"
        if [ -z "$param" ]  #http://tldp.org/LDP/abs/html/comparison-ops.html
        then
          echo "Required parameter missing. Cancelled"; return
        fi

    #Actual line-breaks required in order to expand the variable.
    #- https://stackoverflow.com/a/4296147/2736496
    read -r -p "About to
    sudo rm -rf \"$param\"
Are you sure? [y/N] " response
    response=${response,,}    # tolower
    if [[ $response =~ ^(yes|y)$ ]]
    then
        sudo rm -rf "$param"
    else
        echo "Cancelled."
    fi
}

,

:<<COMMENT
    Delete item from history based on its line number. No prompt.

    Short description: Stored in HX_DESC

    Examples
        hx 112
        hx 3

    See:
    - https://unix.stackexchange.com/questions/57924/how-to-delete-commands-in-history-matching-a-given-string
COMMENT
#HX_DESC: For "aliaf" command (with an 'f'). Must end with a newline.
HX_DESC="hx [linenum]: Delete history item at line number\n"
hx()  {
    history -d "$1"
}

,

:<<COMMENT
    Deletes all lines from the history that match a search string, with a
    prompt. The history file is then reloaded into memory.

    Short description: Stored in HXF_DESC

    Examples
        hxf "rm -rf"
        hxf ^source

    Parameter is required, and must be at least one non-whitespace character.

    With the following setting, this is *not* added to the history:
        export HISTIGNORE="*hxf *"
    - https://superuser.com/questions/232885/can-you-share-wisdom-on-using-histignore-in-bash

    See:
    - https://unix.stackexchange.com/questions/57924/how-to-delete-commands-in-history-matching-a-given-string
COMMENT
#HXF_DESC: For "aliaf" command (with an 'f'). Must end with a newline.
HXF_DESC="hxf [searchterm]: Delete all history items matching search term, with y/n prompt\n"
hxf()  {
    #Exit if no parameter is provided (if it's the empty string)
        param=$(echo "$1" | trim)
        echo "$param"
        if [ -z "$param" ]  #http://tldp.org/LDP/abs/html/comparison-ops.html
        then
          echo "Required parameter missing. Cancelled"; return
        fi

    read -r -p "About to delete all items from history that match \"$param\". Are you sure? [y/N] " response
    response=${response,,}    # tolower
    if [[ $response =~ ^(yes|y)$ ]]
    then
        #Delete all matched items from the file, and duplicate it to a temp
        #location.
        grep -v "$param" "$HISTFILE" > /tmp/history

        #Clear all items in the current sessions history (in memory). This
        #empties out $HISTFILE.
        history -c

        #Overwrite the actual history file with the temp one.
        mv /tmp/history "$HISTFILE"

        #Now reload it.
        history -r "$HISTFILE"     #Alternative: exec bash
    else
        echo "Cancelled."
    fi
}

Ссылки:

• Обрезка пробелов из строк: Как обрезать пробелы из переменной Bash?
• Фактические разрывы строк: https://stackoverflow.com/a/4296147/2736496
• Псевдоним с параметром: https://stackoverflow.com/a/7131683/2736496 (еще один ответ на этот вопрос)
• ИСТОРИЧЕСКИЙ: /superuser/232885/can-you-share-wisdom-on-using-histignore-in-bash
• Да / нет: https://stackoverflow.com/a/3232082/2736496
• Удалить все соответствующие элементы из истории: /unix/57924/how-to-delete-commands-in-history-matching-a-given-string
• Нулевая / пустая строка: http://tldp.org/LDP/abs/html/comparison-ops.html

Bash псевдоним абсолютно принимает параметры. Я просто добавил псевдоним, чтобы создать новое приложение реагирования, которое принимает имя приложения в качестве параметра. Вот мой процесс:

Откройте bash_profile для редактирования в нано

nano /.bash_profile

Добавьте ваши псевдонимы, по одному в строке:

alias gita='git add .'
alias gitc='git commit -m "$@"'
alias gitpom='git push origin master'
alias creact='npx create-react-app "$@"'

примечание: «$ @» принимает параметры, переданные как «creact my-new-app»

Сохраните и выйдите из нано-редактора

Ctrl + O, чтобы написать (нажмите Enter); Ctrl + X для выхода

Скажите терминалу использовать новые псевдонимы в .bash_profile

source /.bash_profile

Это оно! Теперь вы можете использовать ваши новые псевдонимы

NB: В случае, если идея не очевидна, плохая идея - использовать псевдонимы для чего угодно, кроме псевдонимов, первый из которых - «функция в псевдониме», а второй - «трудно читаемый редирект / источник». Кроме того, есть недостатки (которые, я думал , будут очевидны, но на случай, если вы запутаетесь: я не имею в виду, что они действительно будут использоваться ... где угодно!)

.................................................. .................................................. ............................................

Я отвечал на это раньше, и так было всегда в прошлом:

alias foo='__foo() { unset -f $0; echo "arg1 for foo=$1"; }; __foo()'

что хорошо и хорошо, если только вы не избегаете использования функций вместе. в этом случае вы можете воспользоваться огромной способностью bash перенаправлять текст:

alias bar='cat <<< '\''echo arg1 for bar=$1'\'' | source /dev/stdin'

Они оба примерно одинаковой длины дают или принимают несколько символов.

Реальная брыкунья разница во время, вершина является «методом функции» , а нижняя является методом «перенаправления-источник». Чтобы доказать эту теорию, время говорит само за себя:

arg1 for foo=FOOVALUE
 real 0m0.011s user 0m0.004s sys 0m0.008s  # <--time spent in foo
 real 0m0.000s user 0m0.000s sys 0m0.000s  # <--time spent in bar
arg1 for bar=BARVALUE
ubuntu@localhost /usr/bin# time foo FOOVALUE; time bar BARVALUE
arg1 for foo=FOOVALUE
 real 0m0.010s user 0m0.004s sys 0m0.004s
 real 0m0.000s user 0m0.000s sys 0m0.000s
arg1 for bar=BARVALUE
ubuntu@localhost /usr/bin# time foo FOOVALUE; time bar BARVALUE
arg1 for foo=FOOVALUE
 real 0m0.011s user 0m0.000s sys 0m0.012s
 real 0m0.000s user 0m0.000s sys 0m0.000s
arg1 for bar=BARVALUE
ubuntu@localhost /usr/bin# time foo FOOVALUE; time bar BARVALUE
arg1 for foo=FOOVALUE
 real 0m0.012s user 0m0.004s sys 0m0.004s
 real 0m0.000s user 0m0.000s sys 0m0.000s
arg1 for bar=BARVALUE
ubuntu@localhost /usr/bin# time foo FOOVALUE; time bar BARVALUE
arg1 for foo=FOOVALUE
 real 0m0.010s user 0m0.008s sys 0m0.004s
 real 0m0.000s user 0m0.000s sys 0m0.000s
arg1 for bar=BARVALUE

Это нижняя часть около 200 результатов, сделанных через случайные интервалы. Кажется, что создание / уничтожение функции занимает больше времени, чем перенаправление. Надеюсь, это поможет будущим посетителям в этом вопросе (не хотел оставлять его при себе).

Если вы ищете общий способ применения всех параметров к функции, а не просто один, два или несколько других жестко заданных значений, вы можете сделать это следующим образом:

#!/usr/bin/env bash

# you would want to `source` this file, maybe in your .bash_profile?
function runjar_fn(){
    java -jar myjar.jar "$@";
}

alias runjar=runjar_fn;

Таким образом, в приведенном выше примере я передаю все параметры с момента запуска runjarпсевдонима.

Например, если бы я runjar hi thereэто сделал, это бы в конечном итоге запустить java -jar myjar.jar hi there. Если бы я runjar one two threeэто сделал, он бы побежал java -jar myjar.jar one two three.

Мне нравится это $@решение на основе, потому что оно работает с любым количеством параметров.

С уважением ко всем, кто говорит, что вы не можете вставить параметр в середину псевдонима, я только что проверил его и обнаружил, что он работает.

alias mycommand = "python3" $ 1 "script.py --folderoutput RESULTS /"

когда я тогда запустил mycommand foobar, он работал точно так же, как если бы я набрал команду от руки.

Есть законные технические причины, чтобы хотеть обобщенного решения проблемы псевдонима bash, не имеющего механизма для принятия произвольных аргументов. Одна из причин заключается в том, что на команду, которую вы хотите выполнить, негативно повлияют изменения в среде, возникшие в результате выполнения функции. Во всех остальных случаях следует использовать функции.

Что недавно заставило меня попытаться решить эту проблему, так это то, что я хотел создать несколько сокращенных команд для печати определений переменных и функций. Поэтому я написал несколько функций для этой цели. Однако существуют определенные переменные, которые (или могут быть) изменены самим вызовом функции. Среди них:

FUNCNAME BASH_SOURCE BASH_LINENO BASH_ARGC BASH_ARGV

Основная команда, которую я использовал (в функции) для печати переменных defns. в форме вывода командой set было:

sv () { set | grep --color=never -- "^$1=.*"; }

Например:

> V=voodoo
sv V
V=voodoo

Проблема: Это не выведет определения переменных, упомянутых выше, как они есть в текущем контексте , например, если в приглашении интерактивной оболочки (или не в каких-либо вызовах функций), FUNCNAME не определено. Но моя функция говорит мне неверную информацию:

> sv FUNCNAME
FUNCNAME=([0]="sv")

Одно решение, которое я придумал, было упомянуто другими в других сообщениях на эту тему. Для этой конкретной команды для печати переменных defns., Которая требует только один аргумент, я сделал это:

alias asv='(grep -- "^$(cat -)=.*" <(set)) <<<'

Что дает правильный вывод (нет) и статус результата (ложь):

> asv FUNCNAME
> echo $?
1

Тем не менее, я все еще чувствовал необходимость найти решение, которое работает для произвольного числа аргументов.

Общее решение для передачи произвольных аргументов команде с псевдонимом Bash:

# (I put this code in a file "alias-arg.sh"):

# cmd [arg1 ...] – an experimental command that optionally takes args,
# which are printed as "cmd(arg1 ...)"
#
# Also sets global variable "CMD_DONE" to "true".
#
cmd () { echo "cmd($@)"; declare -g CMD_DONE=true; }

# Now set up an alias "ac2" that passes to cmd two arguments placed
# after the alias, but passes them to cmd with their order reversed:
#
# ac2 cmd_arg2 cmd_arg1 – calls "cmd" as: "cmd cmd_arg1 cmd_arg2"
#
alias ac2='
    # Set up cmd to be execed after f() finishes:
    #
    trap '\''cmd "${CMD_ARGV[1]}" "${CMD_ARGV[0]}"'\'' SIGUSR1;
    #        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    #       (^This is the actually execed command^)
    #
    # f [arg0 arg1 ...] – acquires args and sets up trap to run cmd:
    f () {
        declare -ag CMD_ARGV=("$@");  # array to give args to cmd
        kill -SIGUSR1 $$;             # this causes cmd to be run
        trap SIGUSR1;                 # unset the trap for SIGUSR1
        unset CMD_ARGV;               # clean up env...
        unset f;                      # incl. this function!
    };
    f'  # Finally, exec f, which will receive the args following "ac2".

Например:

> . alias-arg.sh
> ac2 one two
cmd(two one)
>
> # Check to see that command run via trap affects this environment:
> asv CMD_DONE
CMD_DONE=true

Хорошая вещь в этом решении состоит в том, что все специальные приемы, используемые для обработки позиционных параметров (аргументов) для команд, будут работать при составлении захваченной команды. Разница лишь в том, что должен использоваться синтаксис массива.

Например,

Если вы хотите "$ @", используйте "$ {CMD_ARGV [@]}".

Если вы хотите "$ #", используйте "$ {# CMD_ARGV [@]}".

И т.п.

Однажды я сделал забавный проект и все еще использую его. Он показывает некоторую анимацию, пока я копирую файлы с помощью cpкоманды, потому что cpничего не отображается, и это немного расстраивает. Итак, я сделал этот псевдоним

alias cp="~/SCR/spiner cp"

И это сценарий вращения

#!/bin/bash

#Set timer
T=$(date +%s)

#Add some color
. ~/SCR/color

#Animation sprites
sprite=( "(* )  ( *)" " (* )( *) " " ( *)(* ) " "( *)  (* )" "(* )  ( *)" )

#Print empty line and hide cursor
printf "\n${COF}"

#Exit function
function bye { printf "${CON}"; [ -e /proc/$pid ] && kill -9 $pid; exit; }; trap bye INT

#Run our command and get its pid
"$@" & pid=$!

#Waiting animation
i=0; while [ -e /proc/$pid ]; do sleep 0.1

    printf "\r${GRN}Please wait... ${YLW}${sprite[$i]}${DEF}"
    ((i++)); [[ $i = ${#sprite[@]} ]] && i=0

done

#Print time and exit
T=$(($(date +%s)-$T))
printf "\n\nTime taken: $(date -u -d @${T} +'%T')\n"

bye

Это выглядит так

Цикличная анимация)

Для получения параметров вы должны использовать функции!

Однако $ @ интерпретируется при создании псевдонима, а не во время выполнения псевдонима, и экранирование $ также не работает. Как мне решить эту проблему?

Вам нужно использовать функцию оболочки вместо псевдонима, чтобы избавиться от этой проблемы. Вы можете определить foo следующим образом:

function foo() { /path/to/command "$@" ;}

ИЛИ

foo() { /path/to/command "$@" ;}

Наконец, вызовите вашу функцию foo (), используя следующий синтаксис:

foo arg1 arg2 argN

Убедитесь, что вы добавили свой foo () в ~/.bash_profileили ~/.zshrcфайл.

В вашем случае это будет работать

function trash() { mv $@ ~/.Trash; }

На самом деле, функции почти всегда являются ответом, который уже достаточно подробно описан в цитате из справочной страницы: «Практически для любых целей псевдонимы заменяются функциями оболочки».

Для полноты и потому, что это может быть полезно (немного более легкий синтаксис), можно отметить, что когда параметр (и) следует псевдониму, они все равно могут использоваться (хотя это не будет соответствовать требованию OP). Это, вероятно, проще всего продемонстрировать на примере:

alias ssh_disc='ssh -O stop'

позволяет мне набрать что-то вроде ssh_disc myhost, которое расширяется, как ожидалось, как:ssh -O stop myhost

Это может быть полезно для команд, которые принимают сложные аргументы (моя память больше не используется)

И функции, и псевдонимы могут использовать параметры, как показано здесь другими. Кроме того, я хотел бы указать на несколько других аспектов:

1. функция работает в своей собственной области, псевдоним разделяет область

Может быть полезно знать эту разницу в случаях, когда вам нужно что-то скрыть или разоблачить. Это также предполагает, что функция - лучший выбор для инкапсуляции.

function tfunc(){
    GlobalFromFunc="Global From Func" # Function set global variable by default
    local FromFunc="onetwothree from func" # Set a local variable

}

alias talias='local LocalFromAlias="Local from Alias";  GlobalFromAlias="Global From Alias" # Cant hide a variable with local here '
# Test variables set by tfunc
tfunc # call tfunc
echo $GlobalFromFunc # This is visible
echo $LocalFromFunc # This is not visible
# Test variables set by talias
# call talias
talias
echo $GlobalFromAlias # This is invisible
echo $LocalFromAlias # This variable is unset and unusable 

Вывод:

bash-3.2$     # Test variables set by tfunc
bash-3.2$     tfunc # call tfunc
bash-3.2$     echo $GlobalFromFunc # This is visible
Global From Func
bash-3.2$     echo $LocalFromFunc # This is not visible

bash-3.2$     # Test variables set by talias
bash-3.2$     # call talias
bash-3.2$     talias
bash: local: can only be used in a function
bash-3.2$     echo $GlobalFromAlias # This is invisible
Global From Alias
bash-3.2$ echo $LocalFromAlias # This variable is unset and unusable

2. скрипт-обёртка - лучший выбор

Несколько раз со мной случалось, что псевдоним или функция не могут быть найдены при входе в систему черезssh или при переключении имен пользователей или в многопользовательской среде. Есть подсказки и приемы с файлами исходных точек, или этот интересный с псевдонимом: alias sd='sudo 'позволяет этому последующему псевдониму alias install='sd apt-get install'работать должным образом (обратите внимание на дополнительный пробел в ), тогда функция больше не видна. Таким образом, когда вы сомневаетесь, скрипт-обертка всегда является наиболее надежным и переносимым решением.sd='sudo ' ). Однако в таких случаях скрипт-обертка работает лучше, чем функция или псевдоним. Основное преимущество скрипта-обертки заключается в том, что он видимый / исполняемый для заданного пути (т. Е. / Usr / loca / bin /), где в качестве функции / псевдонима необходимо найти источник перед использованием. Например, вы помещаете функцию в ~ / .bash_profile или ~ / .bashrc для bash, но позже переключаетесь на другую оболочку (т.е.zsh

Вот пример:

alias gcommit='function _f() { git add -A; git commit -m "$1"; } ; _f'

Очень важно:

1. Есть место после {и до }.
2. Существует ;после каждой команды в последовательности. Если вы забудете об этом после последней команды, >вместо этого вы увидите приглашение!
3. Аргумент заключен в кавычки как "$1"

Как уже указывалось другими, использование функции должно рассматриваться как лучшая практика.

Тем не менее, вот еще один подход, используя xargs:

alias junk="xargs -I "{}" -- mv "{}" "~/.Trash" <<< "

Обратите внимание, что это имеет побочные эффекты в отношении перенаправления потоков.

Вам не нужно ничего делать, псевдоним делает это автоматически.

Например, если я хочу, чтобы параметр git pull origin master был параметризован, я могу просто создать псевдоним следующим образом:

alias gpull = 'git pull origin '

и при фактическом вызове вы можете передать 'master' (имя ветви) в качестве параметра, например так:

gpull master
//or any other branch
gpull mybranch