Как написать оператор if в .tmux.conf, чтобы установить разные параметры для разных версий tmux?

На основе @ericx answer и Ответ @thiagowfx Я собрал следующее вместе, которое охватывает многие из перечисленных несовместимостей начиная с версии 2.0:

# Version-specific commands [grumble, grumble]
# See: https://github.com/tmux/tmux/blob/master/CHANGES
run-shell 'tmux setenv -g TMUX_VERSION $(tmux -V | \
                           sed -En "s/^tmux[^0-9]*([.0-9]+).*/\1/p")'


if-shell -b '[ "$(echo "$TMUX_VERSION < 2.1" | bc)" = 1 ]' " \
    set -g mouse-select-pane on; set -g mode-mouse on; \
    set -g mouse-resize-pane on; set -g mouse-select-window on; \
    set -g message-fg red; \
    set -g message-bg black; \
    set -g message-attr bright; \
    set -g window-status-bg default; \
    set -g window-status-fg default; \
    set -g window-status-current-attr bold; \
    set -g window-status-current-bg cyan; \
    set -g window-status-current-fg default; \
    set -g window-status-bell-fg red; \
    set -g window-status-bell-bg black; \
    set -g window-status-activity-fg white; \
    set -g window-status-activity-bg black"

# In version 2.1 "mouse" replaced the previous 4 mouse options
if-shell -b '[ "$(echo "$TMUX_VERSION >= 2.1" | bc)" = 1 ]' \
  "set -g mouse on"

# UTF8 is autodetected in 2.2 onwards, but errors if explicitly set
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.2" | bc)" = 1 ]' \
  "set -g utf8 on; set -g status-utf8 on; set -g mouse-utf8 on"

# bind-key syntax changed in 2.4 -- selection / copy / paste
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.4" | bc)" = 1 ]' " \
   bind-key -t vi-copy v   begin-selection; \
   bind-key -t vi-copy V   send -X select-line; \
   bind-key -t vi-copy C-v rectangle-toggle; \
   bind-key -t vi-copy y   copy-pipe 'xclip -selection clipboard -in'"

# Newer versions
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.9" | bc)" = 1 ]' " \
   bind-key -T copy-mode-vi v   send -X begin-selection; \
   bind-key -T copy-mode-vi V   send -X select-line; \
   bind-key -T copy-mode-vi C-v send -X rectangle-toggle; \
   bind-key -T copy-mode-vi y   send -X copy-pipe-and-cancel 'xclip -selection clipboard -in'"

if-shell -b '[ "$(echo "$TMUX_VERSION >= 2.9" | bc)" = 1 ]' \
   "set -g message-style fg=red,bg=black; \
    set -g message-style bright; \
    set -g window-status-style          fg=default,bg=default; \
    set -g window-status-current-style  fg=default,bg=cyan,bold; \
    set -g window-status-bell-style     fg=red,bg=black; \
    set -g window-status-activity-style fg=white,bg=black"

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

Я поднял вопрос о поддержке числовых компараторов для %if, который был реализовано в версии 3.0.

if-shell не всегда работает. Вместо этого я использую сценарий оболочки для загрузки правильной версии tmux.conf:

В .tmux.conf:

run-shell "bash ~/.tmux/verify_tmux_version.sh"

В файле verify_tmux_version.sh:

#!/bin/bash

verify_tmux_version () {
    tmux_home=~/.tmux
    tmux_version="$(tmux -V | cut -c 6-)"

    if [[ $(echo "$tmux_version >= 2.1" | bc) -eq 1 ]] ; then
        tmux source-file "$tmux_home/tmux_2.1_up.conf"
        exit
    elif [[ $(echo "$tmux_version >= 1.9" | bc) -eq 1 ]] ; then
        tmux source-file "$tmux_home/tmux_1.9_to_2.1.conf"
        exit
    else
        tmux source-file "$tmux_home/tmux_1.9_down.conf"
        exit
    fi
}

verify_tmux_version

Подробнее: https://gist.github.com/vincenthsu/6847a8f2a94e61735034e65d17ca0d66

Это какая-то суета. Правильный способ сделать это внутри tmux (не полагаясь на внешний сценарий оболочки) сочетает в себе функции ответов Винсента и jdloft.

Команда if-shell в tmux используется как

if-shell [-bF] [-t target-pane] shell-command command [command]
               (alias: if)
    Execute the first command if shell-command returns success or the second command otherwise.  Before
    being executed, shell-command is expanded using the rules specified in the FORMATS section, including
    those relevant to target-pane.  With -b, shell-command is run in the background.

    If -F is given, shell-command is not executed but considered success if neither empty nor zero (after
         formats are expanded).

Обратите внимание, что расширение команды оболочки tmux расширит переменные формы #{pane_current_path}, но в противном случае оставит команду в покое.

Что еще более важно, обратите внимание, что tmux использует /bin/sh -c для выполнения команды оболочки мы уточняем. Таким образом, команда должна быть POSIX-совместимой, поэтому тесты формы [[ не гарантируют быть портативным. Современные системы Ubuntu и Debian, например, используют символическую ссылку /bin/sh на dash.

Мы хотим запустить команду оболочки, совместимую с POSIX, которая проверяет версию tmux и возвращает 0 (true), если нужная версия найдена.

if-shell '[ $(echo "$(tmux -V | cut -d" " -f2) >= 2.1" | bc) -eq 1 ]' \
    'command if true' \
    'command if false'

Пример:

if-shell '[ $(echo "$(tmux -V | cut -d" " -f2) >= 2.1" | bc) -eq 1 ]' \
    'set -g mouse on; set -g mouse-utf8 on' \
    'set -g mode-mouse on; set -g mouse-resize-pane on; set -g mouse-select-pane on; set -g mouse-select-window on' 

Это правильно учитывает тот факт, что мы выполняем арифметику с плавающей запятой, поэтому требуется bc . Кроме того, нет необходимости в конструкции if/then/else/fi, поскольку оператор [ сам создает истинное значение.

Пара заметок

• Строки, продолжающиеся на следующую строку, не могут иметь завершающие комментарии, иначе tmux выдаст сообщение об ошибке «неизвестная команда».
• «Команда, если ложь» может быть опущена.
• Несколько команд для истинного или ложного можно комбинировать с помощью ;
• Команда запускается в базовой оболочке с использованием /bin/sh -c. Работа других подходов, использующих [[ или другой синтаксис, отличный от POSIX, не гарантируется.

EDIT: в предыдущей версии этого ответа использовалось [[, которое не работает в системах, не использующих bash. Замена на [ решает эту проблему.

Я также наткнулся на несоответствие конфигурации в разных версиях tmux. Изучив все решения здесь и в этом связанном вопросе о SuperUser, Я реализовал следующий вариант:

# Version-specific configuration can be placed in ~/.tmux/${TMUX_VERSION}/*.conf
run-shell "for conf in ~/.tmux/$(tmux -V | cut -d' ' -f2)/*.conf; do tmux source-file \"\$conf\"; done"

При этом конфигурация для конкретной версии может быть помещена в (несколько) фрагментов конфигурации для конкретной версии. Это похоже на решение @VincentHsu, но:

• Он не требует внешнего сценария оболочки.
• Он не делится на фиксированные диапазоны версий (... / 1.9 до 2.0 / 2.1 ...). Вместо этого можно использовать (символические) ссылки для совместного использования фрагмента конфигурации несколькими версиями tmux.
• Он не жестко кодирует одно имя файла для версии. Разрешая несколько фрагментов конфигурации для каждой версии, части могут быть общими для разных версий, в то время как другие остаются специфичными для каждой версии. Это должно обеспечить максимальную гибкость.
• В оригинальном ~/.tmux.conf есть только один элемент конфигурации. Другие решения, такие как решение @TomHale, дублируют проверку версии для каждого элемента конфигурации.

На некоторых машинах я получал ложноположительный результат с синтаксисом двойной скобки ('[['). Поэтому я придумал альтернативу, используя awk:

# Enable mouse for different versions of tmux
# (If 'awk' exits with status 0, 'if-shell' evaluates to true)
# tmux < v2.1:
if-shell "tmux -V | awk '{exit !($2 < \"2.1\")}'" \
    "setw -g mode-mouse on ; set -g mouse-select-pane on ; set -g mouse-resize-pane on ; set -g mouse-select-window on ;"
# tmux >= v2.1:
if-shell "tmux -V | awk '{exit !($2 >= \"2.1\")}'" \
    "set -g mouse on ;"

if-shell Tmux можно использовать для проверки версии ZSH.

[[ `tmux -V | cut -d' ' -f2` -lt 2.1 ]]

проверяет, больше ли версия tmux 2.1 или нет. Используя это, мы можем установить ваши команды мыши в зависимости от версии ZSH.

if-shell "[[ `tmux -V | cut -d' ' -f2` -lt 2.1 ]]" \
    'set -g mode-mouse on; set -g mouse-resize-pane on; set -g mouse-select-pane on; set -g mouse-select-window on'

И установите его для более поздних версий tmux:

if-shell "[[ `tmux -V | cut -d' ' -f2` -ge 2.1 ]]" \
    'set -g mouse on; set -g mouse-utf8 on'

Недавно я столкнулся с этой проблемой, и моим решением было написать скрипт tmux-older-than:

#! /bin/bash

TMUX_VERSION="$(tmux -V | cut -d" " -f2)"
test 1 -eq "$( echo "$TMUX_VERSION < $1" | bc)"

Это делает tmux.conf более читабельным:

if-shell 'tmux-older-than 3.0' \
        'bind-key ^P swap-window -t -1' \
        'bind-key ^P swap-window -d -t -1'

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

В моей альтернативе используется sort -V, который гораздо более надежен для обработки сравнений версий.

Изменить: комментатор указывает, что sort -V недоступен в BSD sort, например, в родной OSX. Однако это все еще ответ, который учитывает версии, которые не являются чисто числовыми.

# ver >= 2.3
[ ! "$(printf "%s\n%s" "$TMUX_VERSION" "2.3" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

# ver > 2.3
[ ! "$(printf "%s\n%s" "$TMUX_VERSION" "2.4" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

# ver < 2.3
[ "$(printf "%s\n%s" "$TMUX_VERSION" "2.3" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

Я объединил предложенные решения с рабочим (проверено на tmux 1.8 и 2.7):

run-shell "tmux setenv -g TMUX_VERSION $(tmux -V | cut -c 6-)"

if-shell -b '[[ "$TMUX_VERSION" < "2.6" ]]' \
  "bind w choose-tree -u"

if-shell -b '[[ "$TMUX_VERSION" < "2.2" ]]' \
  "set -g status-utf8 on"

Это не альтернатива, а скорее расширение принятых ответов (ответ Тома Хейла является наиболее надежным и полным).

Чтобы меньше повторяться в вашем .tmux.conf, вы можете хранить свои тестовые строки оболочки в tmux env vars (доступно с версии 0.8 в 2008 г.) и интерполировать их во время выполнения для if-shell:

# Use which sed pattern actually works in the accepted answers
run-shell 'tmux setenv -g TMUX_VERSION $(tmux -V | sed -En "...")'

# Setup condition checks
V33_GTE='[ "$(echo "$TMUX_VERSION >= 3.3" | bc)" = 1 ]' 
V33_LT='[ "$(echo "$TMUX_VERSION < 3.3" | bc)" = 1 ]'

# So on for other versions
# ...

### Example binding
# Toggle mouse
bind m set -g mouse on  \; display 'Mouse: ON'
bind M set -g mouse off \; display 'Mouse: OFF' 

# As of 3.1 you can annotate your keybindings
# As of 3.3 you can attach a note to existing bindings without setting the binding
# If running >= 3.3 , attach a note to the binding for `list-keys -N`

if "$V33_GTE" bind -N "Enable mouse mode" m
if "$V33_GTE" bind -N "Disable mouse mode" M

У меня такая конфигурация уже много лет.

• Поддержка таких версий, как tmux 2.4 tmux 2.4a tmux next-3.3
• Нет команды bc
• Поддержка Cygwin, macOS и Linux

# Tmux version before 2.4
if-shell -b '[ `tmux -V | cut -d" " -f2 | tr -d " |\-|.|[:alpha:]"` -lt 24 ]' \
  'bind-key -t vi-copy v begin-selection; \
    bind-key -t vi-copy Q cancel; \
    bind-key -t vi-copy Enter cancel'

# Tmux version 2.4 onwards
if-shell -b '[ `tmux -V | cut -d" " -f2 | tr -d " |\-|.|[:alpha:]"` -ge 24 ]' \
  'bind-key -T copy-mode-vi C-w   send-keys -X cancel; \
bind-key -T copy-mode-vi C-u   send-keys -X halfpage-up; \
bind-key -T copy-mode-vi C-j   send-keys -X halfpage-down; \
bind-key -T copy-mode-vi C-l   send-keys -X select-line'