[Перевод] Написание скриптов для tmux
Мне, когда я пользуюсь tmux, часто надо открывать похожие рабочие пространства. Например, мне всегда нужно выводить последние строки пары файлов журналов в панели, или мне нужно открывать и vim, и mysql. Бывает, что мне нужно и что-то другое.
Если вы попробуете найти сведения об открытии рабочих пространств tmux, то почти гарантированно обнаружите советы по использованию программы-обёртки вроде tmuxinator, tmux-resurrect или tmux-continuum. Эти программы, возможно, хороши, но я предпочитаю что-нибудь попроще.
***
Вот небольшая справка по терминологии tmux:
- Панель (pane) — это область, в которой выводится содержимое терминала.
- Окно (window) — это набор, состоящий из одной или большего количества панелей. Окно всегда занимает весь экран.
- Сессия (session) — это набор окон.
Каждая клавиатурная привязка в tmux, за исключением префиксной комбинации new-window, а сочетание next-window.
Сделать то же самое можно, используя эти команды в командной оболочке, или в командном режиме tmux:
$ tmux new-window
:new-window
Многие команды принимают параметры, например, с командой new-window можно использовать ключ -t, позволяющий указать индекс целевого окна. Можно воспользоваться сочетанием клавиш list-keys) для вывода списка стандартных клавиатурных привязок.
Это — мощная концепция, существование которой означает, что всё, что при работе с tmux делается в интерактивном режиме, можно описать в скриптах. Мы, вооружённые этой информацией, можем создать скрипт командной оболочки для открытия нужного рабочего пространства.
Тут я, в качестве примера, рассматриваю скрипт, созданный для открытия рабочего пространства, предназначенного для работы с моим сайтом. Мне для этого надо три окна: в одном открывается командная оболочка, в другом — веб-сервер, а в третьем Jekyll.
Сначала надо начать новую сессию:
$ tmux new-session -d -s site
Флаг -d сообщает tmux о том, что ему не нужно входить в новую сессию, подключаться к ней. В большинстве команд этот флаг играет ту же роль, поэтому многократно описывать его я не буду. Ключ -s позволяет дать сессии имя. Нельзя создать сессию без окна, в результате команда new-session создаёт ещё и окно. Если нужно, имя этому окну можно дать с помощью ключа -n.
Создать новое окно можно так:
$ tmux new-window -d -t '=site' -n server -c _site
$ tmux send-keys -t '=site:=server' 'python -mhttp.server' Enter
Ключ -t позволяет установить целевое окно: в данном случае тут указывается имя сессии, поэтому tmux использует следующий неиспользуемый индекс. Знак = позволяет обеспечить точное совпадение имени. Ключ -n задаёт окну имя, а ключ -c задаёт директорию.
Я не выполняю команду для запуска программы, пользуясь возможностями new-window, так как мне не нужно, чтобы панель закрылась бы в том случае, если я остановлю или перезапущу эту команду. Поэтому я выполняю команду с помощью send-keys.
По той же схеме можно действовать и создавая следующее окно:
$ tmux new-window -d -t '=site' -n jekyll
$ tmux send-keys -t '=site:=jekyll' 'JEKYLL_NO_BUNDLER_REQUIRE=1 jekyll build -w' Enter
И, наконец, войдём в новую сессию:
$ [ -n "${TMUX:-}" ] &&
tmux switch-client -t '=site' ||
tmux attach-session -t '=site'
Эта конструкция позволяет обеспечить работоспособность кода как при его запуске за пределами tmux, так и при запуске из другой сессии tmux.
Соберём всё вместе:
#!/bin/sh
set -euC
cd ~/code/arp242.net
att() {
[ -n "${TMUX:-}" ] &&
tmux switch-client -t '=site' ||
tmux attach-session -t '=site'
}
if tmux has-session -t '=site' 2> /dev/null; then
att
exit 0
fi
tmux new-session -d -s site
tmux new-window -d -t '=site' -n server -c ~/code/arp242.net/_site
tmux send-keys -t '=site:=server' 'python -mhttp.server' Enter
tmux new-window -d -t '=site' -n jekyll
tmux send-keys -t '=site:=jekyll' 'JEKYLL_NO_BUNDLER_REQUIRE=1 jekyll build -w' Enter
att
Обратите внимание на то, что tmux подключится к сессии site в том случае, если она уже существует.
***
Я обнаружил эти команды, воспользовавшись командой tmux list-keys -T prefix. Так я понял, какие команды отправляются tmux, а потом нашёл их в документации tmux (1).
Единственное, что меня несколько раздражает — это то, что tmux поддерживает только короткие имена опций (например — -s), но не длинные (вроде -session-name). Короткие имена хорошо подходят для ввода с клавиатуры в командной строке. Собственно — из-за того, что они короткие. Но опции с длинными именами гораздо удобнее использовать в скриптах, особенно в тех случаях, когда речь идёт об опциях, применяемых редко. Сравните:
$ tmux new-session -d -s site -n server
$ tmux new-session -detached -session-name site -window-name server
Вторая строчка включает в себя самодокументирующиеся свойства, а вот в первой их нет. Полагаю, что это — одна из важных причин существования скриптов-обёрток для tmux, в которых используются конфигурационные YAML-файлы или нечто подобное.
Пользуетесь ли вы tmux?
