b875a1802c
This patch centralises the loading of windowing environments, in order to ensure that by default only a single module is loaded, rather than the current code which can load multiple potentially incompatible modules; and in order to provide the user with more control over the loading of windowing modules. The patch introduces a new str-list option `windowing_modules` which defines an ordered list of windowing modules to attempt to load. Modules are loaded in the order specified in the list until a module loads without error, at which point the process finishes. When loaded each windowing module tests the environment to determine whether it should load (e.g. the tmux module tests to see if it's being run within a tmux session), and if it determines that it should then it completes its loading without error. If it doesn't detect an appropriate environment then it returns an error, and the module loading logic tries the next module. The user can override the default `windowing_modules` list to specify their preferred modules (i.e. they can put kitty ahead of tmux if that's their preference, or they can leave out the x11 modules alltogether). In addition, if the `windowing_modules` option is an empty list this bypasses the environment detection logic completely, and allows the modules to be loaded manually - this allows a user to replace the windowing module loading logic with their own manual set up.
65 lines
2.4 KiB
Plaintext
65 lines
2.4 KiB
Plaintext
# http://tmux.github.io/
|
|
# ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
|
|
|
provide-module tmux %{
|
|
|
|
# ensure we're running under tmux
|
|
evaluate-commands %sh{
|
|
[ -z "${kak_opt_windowing_modules}" ] || [ -n "$TMUX" ] || echo 'fail tmux not detected'
|
|
}
|
|
|
|
define-command -hidden -params 2.. tmux-terminal-impl %{
|
|
evaluate-commands %sh{
|
|
tmux=${kak_client_env_TMUX:-$TMUX}
|
|
if [ -z "$tmux" ]; then
|
|
echo "fail 'This command is only available in a tmux session'"
|
|
exit
|
|
fi
|
|
tmux_args="$1"
|
|
shift
|
|
# ideally we should escape single ';' to stop tmux from interpreting it as a new command
|
|
# but that's probably too rare to care
|
|
TMUX=$tmux tmux $tmux_args env TMPDIR="$TMPDIR" "$@" < /dev/null > /dev/null 2>&1 &
|
|
}
|
|
}
|
|
|
|
define-command tmux-terminal-vertical -params 1.. -shell-completion -docstring '
|
|
tmux-terminal-vertical <program> [<arguments>]: create a new terminal as a tmux pane
|
|
The current pane is split into two, top and bottom
|
|
The program passed as argument will be executed in the new terminal' \
|
|
%{
|
|
tmux-terminal-impl 'split-window -v' %arg{@}
|
|
}
|
|
define-command tmux-terminal-horizontal -params 1.. -shell-completion -docstring '
|
|
tmux-terminal-horizontal <program> [<arguments>]: create a new terminal as a tmux pane
|
|
The current pane is split into two, left and right
|
|
The program passed as argument will be executed in the new terminal' \
|
|
%{
|
|
tmux-terminal-impl 'split-window -h' %arg{@}
|
|
}
|
|
define-command tmux-terminal-window -params 1.. -shell-completion -docstring '
|
|
tmux-terminal-window <program> [<arguments>] [<arguments>]: create a new terminal as a tmux window
|
|
The program passed as argument will be executed in the new terminal' \
|
|
%{
|
|
tmux-terminal-impl 'new-window' %arg{@}
|
|
}
|
|
|
|
define-command tmux-focus -params ..1 -client-completion -docstring '
|
|
tmux-focus [<client>]: focus the given client
|
|
If no client is passed then the current one is used' \
|
|
%{
|
|
evaluate-commands %sh{
|
|
if [ $# -eq 1 ]; then
|
|
printf "evaluate-commands -client '%s' focus" "$1"
|
|
elif [ -n "${kak_client_env_TMUX}" ]; then
|
|
TMUX="${kak_client_env_TMUX}" tmux select-pane -t "${kak_client_env_TMUX_PANE}" > /dev/null
|
|
fi
|
|
}
|
|
}
|
|
|
|
## The default behaviour for the `new` command is to open an horizontal pane in a tmux session
|
|
alias global focus tmux-focus
|
|
alias global terminal tmux-terminal-horizontal
|
|
|
|
}
|