mirror of
https://github.com/hydroxycarbamide/dotfiles.git
synced 2025-05-07 05:19:07 -04:00
tmux: move plugins to config
This commit is contained in:
parent
36249eb571
commit
3b5aebcd93
122 changed files with 4210 additions and 2 deletions
21
dot_config/tmux/plugins/tmux-tilish/LICENSE
Normal file
21
dot_config/tmux/plugins/tmux-tilish/LICENSE
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2020 Jabir Ali Ouassou
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
327
dot_config/tmux/plugins/tmux-tilish/README.md
Normal file
327
dot_config/tmux/plugins/tmux-tilish/README.md
Normal file
|
|
@ -0,0 +1,327 @@
|
|||
# Tmux Tilish
|
||||
|
||||
This is a plugin that makes [`tmux`][6] behave more like a typical
|
||||
[dynamic window manager][7]. It is heavily inspired by [`i3wm`][8], and
|
||||
most keybindings are taken [directly from there][1]. However, I have made
|
||||
some adjustments to make these keybindings more consistent with `vim`:
|
||||
using <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd> instead of
|
||||
<kbd>j</kbd><kbd>k</kbd><kbd>l</kbd><kbd>;</kbd> for directions, and
|
||||
using `vim`'s definitions of "split" and "vsplit". There is also an
|
||||
"easy mode" available for non-`vim` users, which uses arrow keys
|
||||
instead of <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd>.
|
||||
|
||||
The plugin has been verified to work on `tmux` v1.9, v2.6, v2.7, v2.9, and v3.0.
|
||||
Some features are only available on newer versions of `tmux` (currently v2.7+),
|
||||
but I hope to provide at least basic support for most `tmux` versions in active use.
|
||||
If you encounter any problems, please file an issue and I'll try to look into it.
|
||||
|
||||
[1]: https://i3wm.org/docs/refcard.html
|
||||
[6]: https://github.com/tmux/tmux/wiki/Getting-Started
|
||||
[7]: https://en.wikipedia.org/wiki/Dynamic_window_manager
|
||||
[8]: https://i3wm.org/docs/
|
||||
|
||||
## Why?
|
||||
|
||||
Okay, so who is this plugin for anyway? You may be interested in this if:
|
||||
|
||||
- You're using or interested in using `tmux`, but find the default keybindings
|
||||
a bit clunky. This lets you try out an alternative keybinding paradigm,
|
||||
which uses a modifier key (<kbd>Alt</kbd>) instead of a prefix key
|
||||
(<kbd>Ctrl</kbd> + <kbd>b</kbd>). The plugin also makes it easier to do
|
||||
automatic tiling via `tmux` layouts, as opposed to splitting panes manually.
|
||||
- You use `i3wm`, but also do remote work over `ssh` + `tmux`. This lets
|
||||
you use similar keybindings in both contexts.
|
||||
- You also use other platforms like Gnome, Mac, or WSL. You want to take
|
||||
your `i3wm` muscle memory with you via `tmux`.
|
||||
- You're not really using `i3wm` anymore, but you did like how it handled
|
||||
terminals and workspaces. You'd like to keep working that way in terminals,
|
||||
without using `i3wm` or `sway` for your whole desktop.
|
||||
- You use a window manager that is similar to `i3wm`, e.g. [`dwm`][9],
|
||||
and want to have that workflow in `tmux` too.
|
||||
|
||||
[9]: https://dwm.suckless.org/tutorial/
|
||||
|
||||
## Quickstart
|
||||
|
||||
The easiest way to install this plugin is via the [Tmux Plugin Manager][2].
|
||||
Just add the following to `~/.tmux.conf`, then press <kbd>Ctrl</kbd> + <kbd>b</kbd>
|
||||
followed by <kbd>Shift</kbd> + <kbd>i</kbd> to install it (assuming default prefix key):
|
||||
|
||||
set -g @plugin 'jabirali/tmux-tilish'
|
||||
|
||||
For `tmux` v2.7+, you can customize which layout is used as default for new workspaces.
|
||||
To do so, add this to `~/.tmux.conf`:
|
||||
|
||||
set -g @tilish-default 'main-vertical'
|
||||
|
||||
Just replace `main-vertical` with one of the layouts from the `tmux` `man` page:
|
||||
|
||||
| Description | Name |
|
||||
| ----------------- | ----------------- |
|
||||
| split then vsplit | `main-horizontal` |
|
||||
| only split | `even-vertical` |
|
||||
| vsplit then split | `main-vertical` |
|
||||
| only vsplit | `even-horizontal` |
|
||||
| fully tiled | `tiled` |
|
||||
|
||||
The words "split" and "vsplit" refer to the layouts you get in `vim` when
|
||||
running `:split` and `:vsplit`, respectively. (Unfortunately, what is called
|
||||
a "vertical" and "horizontal" split varies between programs.)
|
||||
If you do not set this option, `tilish` will not autoselect any layout; you
|
||||
can still choose layouts manually using the keybindings listed below.
|
||||
|
||||
After performing the steps above, you should read the [list of keybindings](#keybindings).
|
||||
For further configuration options:
|
||||
|
||||
- If you use `nvim` or `vim`, consider [integrating it with `tilish`](#integration-with-vim).
|
||||
- If you do not use `vim` or `kak`, consider activating [easy mode](#easy-mode).
|
||||
- If you use `kak` or `emacs`, consider activating [prefix mode](#prefix-mode).
|
||||
- If you use `tmux` within `i3wm` or `sway`, see [this section](#usage-inside-i3wm).
|
||||
- If you like `dmenu`, check out the [application launcher](#application-launcher).
|
||||
- If it doesn't work, check your [terminal settings](#terminal-compatibility).
|
||||
|
||||
It is also recommended that you add the following to the top of your `.tmux.conf`:
|
||||
|
||||
set -s escape-time 0
|
||||
set -g base-index 1
|
||||
|
||||
The first line prevents e.g. <kbd>Esc</kbd> + <kbd>h</kbd> from triggering the
|
||||
<kbd>Alt</kbd> + <kbd>h</kbd> keybinding, preventing common misbehavior when
|
||||
using `vim` in `tmux`. This option is automatically set by [tmux-sensible][4], if
|
||||
you use that. The second line makes workspace numbers go from 1-10 instead of 0-9,
|
||||
which makes more sense on a keyboard where the number row starts at 1. However,
|
||||
`tilish` explicitly checks this setting when mapping keys, and works fine without it.
|
||||
|
||||
[2]: https://github.com/tmux-plugins/tpm
|
||||
[4]: https://github.com/tmux-plugins/tmux-sensible
|
||||
|
||||
## Keybindings
|
||||
|
||||
Finally, here is a list of the actual keybindings. Most are [taken from `i3wm`][1].
|
||||
Below, a "workspace" is what `tmux` would call a "window" and `vim` would call a "tab",
|
||||
while a "pane" is what `i3wm` would call a "window" and `vim` would call a "split".
|
||||
|
||||
| Keybinding | Description |
|
||||
| ---------- | ----------- |
|
||||
| <kbd>Alt</kbd> + <kbd>0</kbd>-<kbd>9</kbd> | Switch to workspace number 0-9 |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>0</kbd>-<kbd>9</kbd> | Move pane to workspace 0-9 |
|
||||
| <kbd>Alt</kbd> + <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd> | Move focus left/down/up/right |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd> | Move pane left/down/up/right |
|
||||
| <kbd>Alt</kbd> + <kbd>o</kbd> | Move focus to next pane |
|
||||
| <kbd>Alt</kbd> + <kbd>Enter</kbd> | Create a new pane at "the end" of the current layout |
|
||||
| <kbd>Alt</kbd> + <kbd>s</kbd> | Switch to layout: split then vsplit |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>s</kbd> | Switch to layout: only split |
|
||||
| <kbd>Alt</kbd> + <kbd>v</kbd> | Switch to layout: vsplit then split |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>v</kbd> | Switch to layout: only vsplit |
|
||||
| <kbd>Alt</kbd> + <kbd>t</kbd> | Switch to layout: fully tiled |
|
||||
| <kbd>Alt</kbd> + <kbd>z</kbd> | Switch to layout: zoom (fullscreen) |
|
||||
| <kbd>Alt</kbd> + <kbd>r</kbd> | Refresh current layout |
|
||||
| <kbd>Alt</kbd> + <kbd>n</kbd> | Name current workspace |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>q</kbd> | Quit (close) pane |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>e</kbd> | Exit (detach) `tmux` |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>c</kbd> | Reload config |
|
||||
|
||||
The <kbd>Alt</kbd> + <kbd>0</kbd> and <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>0</kbd>
|
||||
bindings are "smart": depending on `base-index`, they either act on workspace 0 or 10.
|
||||
|
||||
The keybindings that move panes between workspaces assume a US keyboard layout.
|
||||
However, you can configure `tilish` for international keyboards by providing a string
|
||||
`@tilish-shiftnum` prepared by pressing <kbd>Shift</kbd> +
|
||||
<kbd>1</kbd><kbd>2</kbd><kbd>3</kbd><kbd>4</kbd><kbd>5</kbd><kbd>6</kbd><kbd>7</kbd><kbd>8</kbd><kbd>9</kbd><kbd>0</kbd>.
|
||||
For instance, for a UK keyboard, you would configure it as follows:
|
||||
|
||||
set -g @tilish-shiftnum '!"£$%^&*()'
|
||||
|
||||
Your terminal must support sending keycodes like `M-£` for the above to work.
|
||||
For instance, a UK keyboard layout works fine on `urxvt`, but does not work
|
||||
by default on `kitty` or `alacritty`, which may require additional configuration.
|
||||
|
||||
## Easy mode
|
||||
|
||||
To make the plugin more accessible for people who do not use `vim` as well,
|
||||
there is also an "easy mode" available, which uses arrow keys instead of
|
||||
the `vim`-style <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd> keys.
|
||||
This mode can be activated by putting this in your `.tmux.conf`:
|
||||
|
||||
set -g @tilish-easymode 'on'
|
||||
|
||||
The revised keybindings for the pane focus and movement then become:
|
||||
|
||||
| Keybinding | Description |
|
||||
| ---------- | ----------- |
|
||||
| <kbd>Alt</kbd> + <kbd>←</kbd><kbd>↓</kbd><kbd>↑</kbd><kbd>→</kbd> | Move focus left/down/up/right |
|
||||
| <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>←</kbd><kbd>↓</kbd><kbd>↑</kbd><kbd>→</kbd> | Move pane left/down/up/right |
|
||||
|
||||
## Prefix mode
|
||||
Note that this feature is currently only available in `tmux` v2.4+.
|
||||
The "prefix mode" uses a prefix key instead of <kbd>Alt</kbd>, and
|
||||
may be particularly interesting for users of editors like `kak` and
|
||||
`emacs` that use <kbd>Alt</kbd> key a lot. To activate this mode, you
|
||||
define a prefix keybinding in your `tmux.conf`. For instance, to use
|
||||
<kbd>Alt</kbd> + <kbd>Space</kbd> as your `tilish` prefix, add:
|
||||
|
||||
set -g @tilish-prefix 'M-space'
|
||||
|
||||
Actions that would usually be done by <kbd>Alt</kbd> + <kbd>key</kbd>
|
||||
are now accomplished by pressing the prefix and then <kbd>key</kbd>.
|
||||
For example, opening a split is usually <kbd>Alt</kbd> + <kbd>Enter</kbd>,
|
||||
but with the above prefix this becomes <kbd>Alt</kbd> + <kbd>Space</kbd>
|
||||
then <kbd>Enter</kbd>. Note that the `tilish` prefix is different from
|
||||
the `tmux` prefix, and should generally be bound to a different key.
|
||||
For the prefix key, you can choose basically any keybinding that `tmux`
|
||||
supports, e.g. `F12` or `C-s` or anything else you may prefer.
|
||||
|
||||
All these keybindings are `repeat`'able, so you do not have to press the
|
||||
prefix key again if you type multiple commands fast enough. Thus, pressing
|
||||
<kbd>Alt</kbd> + <kbd>Space</kbd> followed by <kbd>h</kbd><kbd>j</kbd> would
|
||||
move to the left and then down, without requiring another prefix activation.
|
||||
The `tmux` option `repeat-time` can be used to customize this timeout.
|
||||
Personally, I find the default 500ms timeout somewhat short, and would
|
||||
recommend that you increase this to at least a second if you use `tilish`:
|
||||
|
||||
set -g repeat-time 1000
|
||||
|
||||
## Application launcher
|
||||
|
||||
In `i3wm`, the keybinding <kbd>Alt</kbd>+<kbd>d</kbd> is by default mapped to
|
||||
the application launcher `dmenu`, which can be practical to quickly open apps.
|
||||
If you have [`fzf`][5] available on your system, `tilish` can offer a similar
|
||||
application launcher using the same keyboard shortcut. To enable this
|
||||
functionality, add the following to your `~/.tmux.conf`:
|
||||
|
||||
set -g @tilish-dmenu 'on'
|
||||
|
||||
Basically, pressing <kbd>Alt</kbd>+<kbd>d</kbd> will then pop up a split
|
||||
that lets you fuzzy-search through all executables in your system `$PATH`.
|
||||
Selecting an executable runs the command in that split. When you want
|
||||
to start an interactive process, this can be more convenient than
|
||||
using <kbd>Alt</kbd>+<kbd>Enter</kbd> and typing the command name.
|
||||
This is currently only available in `tmux` v2.7+.
|
||||
|
||||
[5]: https://github.com/junegunn/fzf
|
||||
|
||||
## Terminal compatibility
|
||||
|
||||
Not all terminals support all keybindings. The plugin has been verified
|
||||
to work well with: `iTerm2` and `Terminal.app` on macOS; `alacritty`, `kitty`,
|
||||
`terminator`, `gnome-terminal`, and `urxvt` on Linux; `wsltty` and `alacritty`
|
||||
on Windows. Some of these terminals bind <kbd>Alt</kbd>+<kbd>Enter</kbd> to
|
||||
fullscreen, so you have to disable that for the `tilish` "new pane" binding to
|
||||
work. Moreover, `gnome-terminal` steals the "switch workspace" keybindings
|
||||
<kbd>Alt</kbd>+<kbd>0</kbd>-<kbd>9</kbd> *if* you open multiple tabs. If you
|
||||
use macOS, you likely want to configure the `Option` key to send either `Esc+`
|
||||
(`iTerm2`) or `Meta` (`Terminal.app`) under the keyboard settings of the app.
|
||||
|
||||
It is also worth noting that `iTerm2` allows you to swap the `Cmd` and `Option`
|
||||
keys in the terminal app. I recommend giving this a try if you're on macOS,
|
||||
since the `Cmd` is more ergonomic than the `Option` key for extended use.
|
||||
|
||||
If you use `xterm`, almost none of the <kbd>Alt</kbd> keys work by default.
|
||||
That can be fixed by adding this to `~/.Xresources`:
|
||||
|
||||
XTerm*eightBitControl: false
|
||||
XTerm*eightBitInput: false
|
||||
XTerm.omitTranslation: fullscreen
|
||||
XTerm*fullscreen: never
|
||||
|
||||
The same issue affects Alacritty on macOS; see
|
||||
[this issue](https://github.com/alacritty/alacritty/issues/93#issuecomment-353489475)
|
||||
for a proposed solution.
|
||||
|
||||
## Usage inside i3wm
|
||||
|
||||
If you use `tilish` inside `i3wm` or `sway`, keybindings like
|
||||
<kbd>Alt</kbd>+<kbd>Enter</kbd> may spawn a new terminal in your window manager
|
||||
instead of a new terminal pane inside `tmux`. The window manager always takes
|
||||
priority — so if both `i3wm` and `tilish` define the same keybinding,
|
||||
`i3wm` will intercept the keybinding before `tmux` sees it.
|
||||
|
||||
The best way to solve this is perhaps to change your window manager modifier key
|
||||
to <kbd>Super</kbd>, also known as the "Windows key". As described
|
||||
[in the `i3wm` user guide](https://i3wm.org/docs/userguide.html#_using_i3), this can
|
||||
be done by changing `$mod` to `Mod4` in your `i3wm` config. That way, pressing e.g.
|
||||
<kbd>Alt</kbd>+<kbd>Enter</kbd> opens a new terminal pane inside `tmux`, while
|
||||
<kbd>Super</kbd>+<kbd>Enter</kbd> opens a new terminal in `i3wm`.
|
||||
|
||||
Alternatively, `tilish` also supports a [Prefix mode](#prefix-mode). This is in my opinion
|
||||
less ergonomic than the default `tilish` keybindings. However, it does not require the use
|
||||
of <kbd>Alt</kbd>, and is therefore compatible with the default `i3wm` keybindings.
|
||||
|
||||
## Integration with vim
|
||||
|
||||
There are two great plugins [tmux-navigate][10] and [vim-tmux-navigator][3],
|
||||
which both allow seamless navigation between `vim` splits and `tmux` splits.
|
||||
The former has an advantage that it also works over `ssh` connections, and that
|
||||
it plays better with zooming (<kbd>Alt</kbd>+<kbd>z</kbd>). If you use either
|
||||
plugin, you can tell `tilish` to make it setup the keybindings for you. (If you
|
||||
don't, `tilish` will use fallback keybindings that don't integrate with `vim`.)
|
||||
|
||||
### Navigate
|
||||
|
||||
It is perhaps easiest to setup `tmux-navigate`. Just load `navigate` *after* `tilish`
|
||||
in your `tmux.conf`, and set the option `@tilish-navigate` to `on` to integrate them.
|
||||
Thus a full working minimal example of a `tpm`-based `tmux.conf` would be:
|
||||
|
||||
# List of plugins.
|
||||
set -g @plugin 'tmux-plugins/tpm'
|
||||
set -g @plugin 'tmux-plugins/tmux-sensible'
|
||||
set -g @plugin 'jabirali/tmux-tilish'
|
||||
set -g @plugin 'sunaku/tmux-navigate'
|
||||
|
||||
# Plugin options.
|
||||
set -g @tilish-navigate 'on'
|
||||
|
||||
# Install `tpm` if needed.
|
||||
if "test ! -d ~/.tmux/plugins/tpm" \
|
||||
"run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm && ~/.tmux/plugins/tpm/bin/install_plugins'"
|
||||
|
||||
# Activate the plugins.
|
||||
run -b "~/.tmux/plugins/tpm/tpm"
|
||||
|
||||
|
||||
No further setup is required; `tilish` sets up the keybindings, and `navigate`
|
||||
handles seamless navigation of `vim`/`nvim` splits. However, if you also want
|
||||
this seamless navigation over `ssh` connections, you should install
|
||||
the accompanying `vim` plugin; see [their website for more information][10].
|
||||
|
||||
### Navigator
|
||||
|
||||
To install `vim-tmux-navigator`, you should first install the plugin for `vim`
|
||||
or `nvim`, as described on [their website][3]. Then place this in your
|
||||
`~/.config/nvim/init.vim` (`nvim`) or `~/.vimrc` (`vim`):
|
||||
|
||||
noremap <silent> <m-h> :TmuxNavigateLeft<cr>
|
||||
noremap <silent> <m-j> :TmuxNavigateDown<cr>
|
||||
noremap <silent> <m-k> :TmuxNavigateUp<cr>
|
||||
noremap <silent> <m-l> :TmuxNavigateRight<cr>
|
||||
|
||||
You then just have to tell `tilish` that you want the integration:
|
||||
|
||||
set -g @tilish-navigator 'on'
|
||||
|
||||
A minimal working example of a `~/.tmux.conf` with `tpm` would then be:
|
||||
|
||||
# List of plugins.
|
||||
set -g @plugin 'tmux-plugins/tpm'
|
||||
set -g @plugin 'tmux-plugins/tmux-sensible'
|
||||
set -g @plugin 'jabirali/tmux-tilish'
|
||||
|
||||
# Plugin options.
|
||||
set -g @tilish-navigator 'on'
|
||||
|
||||
# Install `tpm` if needed.
|
||||
if "test ! -d ~/.tmux/plugins/tpm" \
|
||||
"run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm && ~/.tmux/plugins/tpm/bin/install_plugins'"
|
||||
|
||||
# Activate the plugins.
|
||||
run -b "~/.tmux/plugins/tpm/tpm"
|
||||
|
||||
[3]: https://github.com/christoomey/vim-tmux-navigator
|
||||
[10]: https://github.com/sunaku/tmux-navigate
|
||||
|
||||
# Related projects
|
||||
|
||||
- [3mux](https://github.com/aaronjanse/3mux)
|
||||
- [tmux-navigate](https://github.com/sunaku/tmux-navigate)
|
||||
- [vim-tmux-navigator](https://github.com/christoomey/vim-tmux-navigator)
|
||||
- [vim-i3wm-tmux-navigator](https://github.com/fogine/vim-i3wm-tmux-navigator)
|
||||
1
dot_config/tmux/plugins/tmux-tilish/dot_git/HEAD
Normal file
1
dot_config/tmux/plugins/tmux-tilish/dot_git/HEAD
Normal file
|
|
@ -0,0 +1 @@
|
|||
ref: refs/heads/master
|
||||
13
dot_config/tmux/plugins/tmux-tilish/dot_git/config
Normal file
13
dot_config/tmux/plugins/tmux-tilish/dot_git/config
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
[core]
|
||||
repositoryformatversion = 0
|
||||
filemode = true
|
||||
bare = false
|
||||
logallrefupdates = true
|
||||
[submodule]
|
||||
active = .
|
||||
[remote "origin"]
|
||||
url = https://git::@github.com/jabirali/tmux-tilish
|
||||
fetch = +refs/heads/master:refs/remotes/origin/master
|
||||
[branch "master"]
|
||||
remote = origin
|
||||
merge = refs/heads/master
|
||||
1
dot_config/tmux/plugins/tmux-tilish/dot_git/description
Normal file
1
dot_config/tmux/plugins/tmux-tilish/dot_git/description
Normal file
|
|
@ -0,0 +1 @@
|
|||
Unnamed repository; edit this file 'description' to name the repository.
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to check the commit log message taken by
|
||||
# applypatch from an e-mail message.
|
||||
#
|
||||
# The hook should exit with non-zero status after issuing an
|
||||
# appropriate message if it wants to stop the commit. The hook is
|
||||
# allowed to edit the commit message file.
|
||||
#
|
||||
# To enable this hook, rename this file to "applypatch-msg".
|
||||
|
||||
. git-sh-setup
|
||||
commitmsg="$(git rev-parse --git-path hooks/commit-msg)"
|
||||
test -x "$commitmsg" && exec "$commitmsg" ${1+"$@"}
|
||||
:
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to check the commit log message.
|
||||
# Called by "git commit" with one argument, the name of the file
|
||||
# that has the commit message. The hook should exit with non-zero
|
||||
# status after issuing an appropriate message if it wants to stop the
|
||||
# commit. The hook is allowed to edit the commit message file.
|
||||
#
|
||||
# To enable this hook, rename this file to "commit-msg".
|
||||
|
||||
# Uncomment the below to add a Signed-off-by line to the message.
|
||||
# Doing this in a hook is a bad idea in general, but the prepare-commit-msg
|
||||
# hook is more suited to it.
|
||||
#
|
||||
# SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
|
||||
# grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
|
||||
|
||||
# This example catches duplicate Signed-off-by lines.
|
||||
|
||||
test "" = "$(grep '^Signed-off-by: ' "$1" |
|
||||
sort | uniq -c | sed -e '/^[ ]*1[ ]/d')" || {
|
||||
echo >&2 Duplicate Signed-off-by lines.
|
||||
exit 1
|
||||
}
|
||||
|
|
@ -0,0 +1,174 @@
|
|||
#!/usr/bin/perl
|
||||
|
||||
use strict;
|
||||
use warnings;
|
||||
use IPC::Open2;
|
||||
|
||||
# An example hook script to integrate Watchman
|
||||
# (https://facebook.github.io/watchman/) with git to speed up detecting
|
||||
# new and modified files.
|
||||
#
|
||||
# The hook is passed a version (currently 2) and last update token
|
||||
# formatted as a string and outputs to stdout a new update token and
|
||||
# all files that have been modified since the update token. Paths must
|
||||
# be relative to the root of the working tree and separated by a single NUL.
|
||||
#
|
||||
# To enable this hook, rename this file to "query-watchman" and set
|
||||
# 'git config core.fsmonitor .git/hooks/query-watchman'
|
||||
#
|
||||
my ($version, $last_update_token) = @ARGV;
|
||||
|
||||
# Uncomment for debugging
|
||||
# print STDERR "$0 $version $last_update_token\n";
|
||||
|
||||
# Check the hook interface version
|
||||
if ($version ne 2) {
|
||||
die "Unsupported query-fsmonitor hook version '$version'.\n" .
|
||||
"Falling back to scanning...\n";
|
||||
}
|
||||
|
||||
my $git_work_tree = get_working_dir();
|
||||
|
||||
my $retry = 1;
|
||||
|
||||
my $json_pkg;
|
||||
eval {
|
||||
require JSON::XS;
|
||||
$json_pkg = "JSON::XS";
|
||||
1;
|
||||
} or do {
|
||||
require JSON::PP;
|
||||
$json_pkg = "JSON::PP";
|
||||
};
|
||||
|
||||
launch_watchman();
|
||||
|
||||
sub launch_watchman {
|
||||
my $o = watchman_query();
|
||||
if (is_work_tree_watched($o)) {
|
||||
output_result($o->{clock}, @{$o->{files}});
|
||||
}
|
||||
}
|
||||
|
||||
sub output_result {
|
||||
my ($clockid, @files) = @_;
|
||||
|
||||
# Uncomment for debugging watchman output
|
||||
# open (my $fh, ">", ".git/watchman-output.out");
|
||||
# binmode $fh, ":utf8";
|
||||
# print $fh "$clockid\n@files\n";
|
||||
# close $fh;
|
||||
|
||||
binmode STDOUT, ":utf8";
|
||||
print $clockid;
|
||||
print "\0";
|
||||
local $, = "\0";
|
||||
print @files;
|
||||
}
|
||||
|
||||
sub watchman_clock {
|
||||
my $response = qx/watchman clock "$git_work_tree"/;
|
||||
die "Failed to get clock id on '$git_work_tree'.\n" .
|
||||
"Falling back to scanning...\n" if $? != 0;
|
||||
|
||||
return $json_pkg->new->utf8->decode($response);
|
||||
}
|
||||
|
||||
sub watchman_query {
|
||||
my $pid = open2(\*CHLD_OUT, \*CHLD_IN, 'watchman -j --no-pretty')
|
||||
or die "open2() failed: $!\n" .
|
||||
"Falling back to scanning...\n";
|
||||
|
||||
# In the query expression below we're asking for names of files that
|
||||
# changed since $last_update_token but not from the .git folder.
|
||||
#
|
||||
# To accomplish this, we're using the "since" generator to use the
|
||||
# recency index to select candidate nodes and "fields" to limit the
|
||||
# output to file names only. Then we're using the "expression" term to
|
||||
# further constrain the results.
|
||||
my $last_update_line = "";
|
||||
if (substr($last_update_token, 0, 1) eq "c") {
|
||||
$last_update_token = "\"$last_update_token\"";
|
||||
$last_update_line = qq[\n"since": $last_update_token,];
|
||||
}
|
||||
my $query = <<" END";
|
||||
["query", "$git_work_tree", {$last_update_line
|
||||
"fields": ["name"],
|
||||
"expression": ["not", ["dirname", ".git"]]
|
||||
}]
|
||||
END
|
||||
|
||||
# Uncomment for debugging the watchman query
|
||||
# open (my $fh, ">", ".git/watchman-query.json");
|
||||
# print $fh $query;
|
||||
# close $fh;
|
||||
|
||||
print CHLD_IN $query;
|
||||
close CHLD_IN;
|
||||
my $response = do {local $/; <CHLD_OUT>};
|
||||
|
||||
# Uncomment for debugging the watch response
|
||||
# open ($fh, ">", ".git/watchman-response.json");
|
||||
# print $fh $response;
|
||||
# close $fh;
|
||||
|
||||
die "Watchman: command returned no output.\n" .
|
||||
"Falling back to scanning...\n" if $response eq "";
|
||||
die "Watchman: command returned invalid output: $response\n" .
|
||||
"Falling back to scanning...\n" unless $response =~ /^\{/;
|
||||
|
||||
return $json_pkg->new->utf8->decode($response);
|
||||
}
|
||||
|
||||
sub is_work_tree_watched {
|
||||
my ($output) = @_;
|
||||
my $error = $output->{error};
|
||||
if ($retry > 0 and $error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
|
||||
$retry--;
|
||||
my $response = qx/watchman watch "$git_work_tree"/;
|
||||
die "Failed to make watchman watch '$git_work_tree'.\n" .
|
||||
"Falling back to scanning...\n" if $? != 0;
|
||||
$output = $json_pkg->new->utf8->decode($response);
|
||||
$error = $output->{error};
|
||||
die "Watchman: $error.\n" .
|
||||
"Falling back to scanning...\n" if $error;
|
||||
|
||||
# Uncomment for debugging watchman output
|
||||
# open (my $fh, ">", ".git/watchman-output.out");
|
||||
# close $fh;
|
||||
|
||||
# Watchman will always return all files on the first query so
|
||||
# return the fast "everything is dirty" flag to git and do the
|
||||
# Watchman query just to get it over with now so we won't pay
|
||||
# the cost in git to look up each individual file.
|
||||
my $o = watchman_clock();
|
||||
$error = $output->{error};
|
||||
|
||||
die "Watchman: $error.\n" .
|
||||
"Falling back to scanning...\n" if $error;
|
||||
|
||||
output_result($o->{clock}, ("/"));
|
||||
$last_update_token = $o->{clock};
|
||||
|
||||
eval { launch_watchman() };
|
||||
return 0;
|
||||
}
|
||||
|
||||
die "Watchman: $error.\n" .
|
||||
"Falling back to scanning...\n" if $error;
|
||||
|
||||
return 1;
|
||||
}
|
||||
|
||||
sub get_working_dir {
|
||||
my $working_dir;
|
||||
if ($^O =~ 'msys' || $^O =~ 'cygwin') {
|
||||
$working_dir = Win32::GetCwd();
|
||||
$working_dir =~ tr/\\/\//;
|
||||
} else {
|
||||
require Cwd;
|
||||
$working_dir = Cwd::cwd();
|
||||
}
|
||||
|
||||
return $working_dir;
|
||||
}
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to prepare a packed repository for use over
|
||||
# dumb transports.
|
||||
#
|
||||
# To enable this hook, rename this file to "post-update".
|
||||
|
||||
exec git update-server-info
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to verify what is about to be committed
|
||||
# by applypatch from an e-mail message.
|
||||
#
|
||||
# The hook should exit with non-zero status after issuing an
|
||||
# appropriate message if it wants to stop the commit.
|
||||
#
|
||||
# To enable this hook, rename this file to "pre-applypatch".
|
||||
|
||||
. git-sh-setup
|
||||
precommit="$(git rev-parse --git-path hooks/pre-commit)"
|
||||
test -x "$precommit" && exec "$precommit" ${1+"$@"}
|
||||
:
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to verify what is about to be committed.
|
||||
# Called by "git commit" with no arguments. The hook should
|
||||
# exit with non-zero status after issuing an appropriate message if
|
||||
# it wants to stop the commit.
|
||||
#
|
||||
# To enable this hook, rename this file to "pre-commit".
|
||||
|
||||
if git rev-parse --verify HEAD >/dev/null 2>&1
|
||||
then
|
||||
against=HEAD
|
||||
else
|
||||
# Initial commit: diff against an empty tree object
|
||||
against=$(git hash-object -t tree /dev/null)
|
||||
fi
|
||||
|
||||
# If you want to allow non-ASCII filenames set this variable to true.
|
||||
allownonascii=$(git config --type=bool hooks.allownonascii)
|
||||
|
||||
# Redirect output to stderr.
|
||||
exec 1>&2
|
||||
|
||||
# Cross platform projects tend to avoid non-ASCII filenames; prevent
|
||||
# them from being added to the repository. We exploit the fact that the
|
||||
# printable range starts at the space character and ends with tilde.
|
||||
if [ "$allownonascii" != "true" ] &&
|
||||
# Note that the use of brackets around a tr range is ok here, (it's
|
||||
# even required, for portability to Solaris 10's /usr/bin/tr), since
|
||||
# the square bracket bytes happen to fall in the designated range.
|
||||
test $(git diff-index --cached --name-only --diff-filter=A -z $against |
|
||||
LC_ALL=C tr -d '[ -~]\0' | wc -c) != 0
|
||||
then
|
||||
cat <<\EOF
|
||||
Error: Attempt to add a non-ASCII file name.
|
||||
|
||||
This can cause problems if you want to work with people on other platforms.
|
||||
|
||||
To be portable it is advisable to rename the file.
|
||||
|
||||
If you know what you are doing you can disable this check using:
|
||||
|
||||
git config hooks.allownonascii true
|
||||
EOF
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# If there are whitespace errors, print the offending file names and fail.
|
||||
exec git diff-index --check --cached $against --
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to verify what is about to be committed.
|
||||
# Called by "git merge" with no arguments. The hook should
|
||||
# exit with non-zero status after issuing an appropriate message to
|
||||
# stderr if it wants to stop the merge commit.
|
||||
#
|
||||
# To enable this hook, rename this file to "pre-merge-commit".
|
||||
|
||||
. git-sh-setup
|
||||
test -x "$GIT_DIR/hooks/pre-commit" &&
|
||||
exec "$GIT_DIR/hooks/pre-commit"
|
||||
:
|
||||
|
|
@ -0,0 +1,53 @@
|
|||
#!/bin/sh
|
||||
|
||||
# An example hook script to verify what is about to be pushed. Called by "git
|
||||
# push" after it has checked the remote status, but before anything has been
|
||||
# pushed. If this script exits with a non-zero status nothing will be pushed.
|
||||
#
|
||||
# This hook is called with the following parameters:
|
||||
#
|
||||
# $1 -- Name of the remote to which the push is being done
|
||||
# $2 -- URL to which the push is being done
|
||||
#
|
||||
# If pushing without using a named remote those arguments will be equal.
|
||||
#
|
||||
# Information about the commits which are being pushed is supplied as lines to
|
||||
# the standard input in the form:
|
||||
#
|
||||
# <local ref> <local oid> <remote ref> <remote oid>
|
||||
#
|
||||
# This sample shows how to prevent push of commits where the log message starts
|
||||
# with "WIP" (work in progress).
|
||||
|
||||
remote="$1"
|
||||
url="$2"
|
||||
|
||||
zero=$(git hash-object --stdin </dev/null | tr '[0-9a-f]' '0')
|
||||
|
||||
while read local_ref local_oid remote_ref remote_oid
|
||||
do
|
||||
if test "$local_oid" = "$zero"
|
||||
then
|
||||
# Handle delete
|
||||
:
|
||||
else
|
||||
if test "$remote_oid" = "$zero"
|
||||
then
|
||||
# New branch, examine all commits
|
||||
range="$local_oid"
|
||||
else
|
||||
# Update to existing branch, examine new commits
|
||||
range="$remote_oid..$local_oid"
|
||||
fi
|
||||
|
||||
# Check for WIP commit
|
||||
commit=$(git rev-list -n 1 --grep '^WIP' "$range")
|
||||
if test -n "$commit"
|
||||
then
|
||||
echo >&2 "Found WIP commit in $local_ref, not pushing"
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
exit 0
|
||||
|
|
@ -0,0 +1,169 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# Copyright (c) 2006, 2008 Junio C Hamano
|
||||
#
|
||||
# The "pre-rebase" hook is run just before "git rebase" starts doing
|
||||
# its job, and can prevent the command from running by exiting with
|
||||
# non-zero status.
|
||||
#
|
||||
# The hook is called with the following parameters:
|
||||
#
|
||||
# $1 -- the upstream the series was forked from.
|
||||
# $2 -- the branch being rebased (or empty when rebasing the current branch).
|
||||
#
|
||||
# This sample shows how to prevent topic branches that are already
|
||||
# merged to 'next' branch from getting rebased, because allowing it
|
||||
# would result in rebasing already published history.
|
||||
|
||||
publish=next
|
||||
basebranch="$1"
|
||||
if test "$#" = 2
|
||||
then
|
||||
topic="refs/heads/$2"
|
||||
else
|
||||
topic=`git symbolic-ref HEAD` ||
|
||||
exit 0 ;# we do not interrupt rebasing detached HEAD
|
||||
fi
|
||||
|
||||
case "$topic" in
|
||||
refs/heads/??/*)
|
||||
;;
|
||||
*)
|
||||
exit 0 ;# we do not interrupt others.
|
||||
;;
|
||||
esac
|
||||
|
||||
# Now we are dealing with a topic branch being rebased
|
||||
# on top of master. Is it OK to rebase it?
|
||||
|
||||
# Does the topic really exist?
|
||||
git show-ref -q "$topic" || {
|
||||
echo >&2 "No such branch $topic"
|
||||
exit 1
|
||||
}
|
||||
|
||||
# Is topic fully merged to master?
|
||||
not_in_master=`git rev-list --pretty=oneline ^master "$topic"`
|
||||
if test -z "$not_in_master"
|
||||
then
|
||||
echo >&2 "$topic is fully merged to master; better remove it."
|
||||
exit 1 ;# we could allow it, but there is no point.
|
||||
fi
|
||||
|
||||
# Is topic ever merged to next? If so you should not be rebasing it.
|
||||
only_next_1=`git rev-list ^master "^$topic" ${publish} | sort`
|
||||
only_next_2=`git rev-list ^master ${publish} | sort`
|
||||
if test "$only_next_1" = "$only_next_2"
|
||||
then
|
||||
not_in_topic=`git rev-list "^$topic" master`
|
||||
if test -z "$not_in_topic"
|
||||
then
|
||||
echo >&2 "$topic is already up to date with master"
|
||||
exit 1 ;# we could allow it, but there is no point.
|
||||
else
|
||||
exit 0
|
||||
fi
|
||||
else
|
||||
not_in_next=`git rev-list --pretty=oneline ^${publish} "$topic"`
|
||||
/usr/bin/perl -e '
|
||||
my $topic = $ARGV[0];
|
||||
my $msg = "* $topic has commits already merged to public branch:\n";
|
||||
my (%not_in_next) = map {
|
||||
/^([0-9a-f]+) /;
|
||||
($1 => 1);
|
||||
} split(/\n/, $ARGV[1]);
|
||||
for my $elem (map {
|
||||
/^([0-9a-f]+) (.*)$/;
|
||||
[$1 => $2];
|
||||
} split(/\n/, $ARGV[2])) {
|
||||
if (!exists $not_in_next{$elem->[0]}) {
|
||||
if ($msg) {
|
||||
print STDERR $msg;
|
||||
undef $msg;
|
||||
}
|
||||
print STDERR " $elem->[1]\n";
|
||||
}
|
||||
}
|
||||
' "$topic" "$not_in_next" "$not_in_master"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
<<\DOC_END
|
||||
|
||||
This sample hook safeguards topic branches that have been
|
||||
published from being rewound.
|
||||
|
||||
The workflow assumed here is:
|
||||
|
||||
* Once a topic branch forks from "master", "master" is never
|
||||
merged into it again (either directly or indirectly).
|
||||
|
||||
* Once a topic branch is fully cooked and merged into "master",
|
||||
it is deleted. If you need to build on top of it to correct
|
||||
earlier mistakes, a new topic branch is created by forking at
|
||||
the tip of the "master". This is not strictly necessary, but
|
||||
it makes it easier to keep your history simple.
|
||||
|
||||
* Whenever you need to test or publish your changes to topic
|
||||
branches, merge them into "next" branch.
|
||||
|
||||
The script, being an example, hardcodes the publish branch name
|
||||
to be "next", but it is trivial to make it configurable via
|
||||
$GIT_DIR/config mechanism.
|
||||
|
||||
With this workflow, you would want to know:
|
||||
|
||||
(1) ... if a topic branch has ever been merged to "next". Young
|
||||
topic branches can have stupid mistakes you would rather
|
||||
clean up before publishing, and things that have not been
|
||||
merged into other branches can be easily rebased without
|
||||
affecting other people. But once it is published, you would
|
||||
not want to rewind it.
|
||||
|
||||
(2) ... if a topic branch has been fully merged to "master".
|
||||
Then you can delete it. More importantly, you should not
|
||||
build on top of it -- other people may already want to
|
||||
change things related to the topic as patches against your
|
||||
"master", so if you need further changes, it is better to
|
||||
fork the topic (perhaps with the same name) afresh from the
|
||||
tip of "master".
|
||||
|
||||
Let's look at this example:
|
||||
|
||||
o---o---o---o---o---o---o---o---o---o "next"
|
||||
/ / / /
|
||||
/ a---a---b A / /
|
||||
/ / / /
|
||||
/ / c---c---c---c B /
|
||||
/ / / \ /
|
||||
/ / / b---b C \ /
|
||||
/ / / / \ /
|
||||
---o---o---o---o---o---o---o---o---o---o---o "master"
|
||||
|
||||
|
||||
A, B and C are topic branches.
|
||||
|
||||
* A has one fix since it was merged up to "next".
|
||||
|
||||
* B has finished. It has been fully merged up to "master" and "next",
|
||||
and is ready to be deleted.
|
||||
|
||||
* C has not merged to "next" at all.
|
||||
|
||||
We would want to allow C to be rebased, refuse A, and encourage
|
||||
B to be deleted.
|
||||
|
||||
To compute (1):
|
||||
|
||||
git rev-list ^master ^topic next
|
||||
git rev-list ^master next
|
||||
|
||||
if these match, topic has not merged in next at all.
|
||||
|
||||
To compute (2):
|
||||
|
||||
git rev-list master..topic
|
||||
|
||||
if this is empty, it is fully merged to "master".
|
||||
|
||||
DOC_END
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to make use of push options.
|
||||
# The example simply echoes all push options that start with 'echoback='
|
||||
# and rejects all pushes when the "reject" push option is used.
|
||||
#
|
||||
# To enable this hook, rename this file to "pre-receive".
|
||||
|
||||
if test -n "$GIT_PUSH_OPTION_COUNT"
|
||||
then
|
||||
i=0
|
||||
while test "$i" -lt "$GIT_PUSH_OPTION_COUNT"
|
||||
do
|
||||
eval "value=\$GIT_PUSH_OPTION_$i"
|
||||
case "$value" in
|
||||
echoback=*)
|
||||
echo "echo from the pre-receive-hook: ${value#*=}" >&2
|
||||
;;
|
||||
reject)
|
||||
exit 1
|
||||
esac
|
||||
i=$((i + 1))
|
||||
done
|
||||
fi
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to prepare the commit log message.
|
||||
# Called by "git commit" with the name of the file that has the
|
||||
# commit message, followed by the description of the commit
|
||||
# message's source. The hook's purpose is to edit the commit
|
||||
# message file. If the hook fails with a non-zero status,
|
||||
# the commit is aborted.
|
||||
#
|
||||
# To enable this hook, rename this file to "prepare-commit-msg".
|
||||
|
||||
# This hook includes three examples. The first one removes the
|
||||
# "# Please enter the commit message..." help message.
|
||||
#
|
||||
# The second includes the output of "git diff --name-status -r"
|
||||
# into the message, just before the "git status" output. It is
|
||||
# commented because it doesn't cope with --amend or with squashed
|
||||
# commits.
|
||||
#
|
||||
# The third example adds a Signed-off-by line to the message, that can
|
||||
# still be edited. This is rarely a good idea.
|
||||
|
||||
COMMIT_MSG_FILE=$1
|
||||
COMMIT_SOURCE=$2
|
||||
SHA1=$3
|
||||
|
||||
/usr/bin/perl -i.bak -ne 'print unless(m/^. Please enter the commit message/..m/^#$/)' "$COMMIT_MSG_FILE"
|
||||
|
||||
# case "$COMMIT_SOURCE,$SHA1" in
|
||||
# ,|template,)
|
||||
# /usr/bin/perl -i.bak -pe '
|
||||
# print "\n" . `git diff --cached --name-status -r`
|
||||
# if /^#/ && $first++ == 0' "$COMMIT_MSG_FILE" ;;
|
||||
# *) ;;
|
||||
# esac
|
||||
|
||||
# SOB=$(git var GIT_COMMITTER_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
|
||||
# git interpret-trailers --in-place --trailer "$SOB" "$COMMIT_MSG_FILE"
|
||||
# if test -z "$COMMIT_SOURCE"
|
||||
# then
|
||||
# /usr/bin/perl -i.bak -pe 'print "\n" if !$first_line++' "$COMMIT_MSG_FILE"
|
||||
# fi
|
||||
|
|
@ -0,0 +1,78 @@
|
|||
#!/bin/sh
|
||||
|
||||
# An example hook script to update a checked-out tree on a git push.
|
||||
#
|
||||
# This hook is invoked by git-receive-pack(1) when it reacts to git
|
||||
# push and updates reference(s) in its repository, and when the push
|
||||
# tries to update the branch that is currently checked out and the
|
||||
# receive.denyCurrentBranch configuration variable is set to
|
||||
# updateInstead.
|
||||
#
|
||||
# By default, such a push is refused if the working tree and the index
|
||||
# of the remote repository has any difference from the currently
|
||||
# checked out commit; when both the working tree and the index match
|
||||
# the current commit, they are updated to match the newly pushed tip
|
||||
# of the branch. This hook is to be used to override the default
|
||||
# behaviour; however the code below reimplements the default behaviour
|
||||
# as a starting point for convenient modification.
|
||||
#
|
||||
# The hook receives the commit with which the tip of the current
|
||||
# branch is going to be updated:
|
||||
commit=$1
|
||||
|
||||
# It can exit with a non-zero status to refuse the push (when it does
|
||||
# so, it must not modify the index or the working tree).
|
||||
die () {
|
||||
echo >&2 "$*"
|
||||
exit 1
|
||||
}
|
||||
|
||||
# Or it can make any necessary changes to the working tree and to the
|
||||
# index to bring them to the desired state when the tip of the current
|
||||
# branch is updated to the new commit, and exit with a zero status.
|
||||
#
|
||||
# For example, the hook can simply run git read-tree -u -m HEAD "$1"
|
||||
# in order to emulate git fetch that is run in the reverse direction
|
||||
# with git push, as the two-tree form of git read-tree -u -m is
|
||||
# essentially the same as git switch or git checkout that switches
|
||||
# branches while keeping the local changes in the working tree that do
|
||||
# not interfere with the difference between the branches.
|
||||
|
||||
# The below is a more-or-less exact translation to shell of the C code
|
||||
# for the default behaviour for git's push-to-checkout hook defined in
|
||||
# the push_to_deploy() function in builtin/receive-pack.c.
|
||||
#
|
||||
# Note that the hook will be executed from the repository directory,
|
||||
# not from the working tree, so if you want to perform operations on
|
||||
# the working tree, you will have to adapt your code accordingly, e.g.
|
||||
# by adding "cd .." or using relative paths.
|
||||
|
||||
if ! git update-index -q --ignore-submodules --refresh
|
||||
then
|
||||
die "Up-to-date check failed"
|
||||
fi
|
||||
|
||||
if ! git diff-files --quiet --ignore-submodules --
|
||||
then
|
||||
die "Working directory has unstaged changes"
|
||||
fi
|
||||
|
||||
# This is a rough translation of:
|
||||
#
|
||||
# head_has_history() ? "HEAD" : EMPTY_TREE_SHA1_HEX
|
||||
if git cat-file -e HEAD 2>/dev/null
|
||||
then
|
||||
head=HEAD
|
||||
else
|
||||
head=$(git hash-object -t tree --stdin </dev/null)
|
||||
fi
|
||||
|
||||
if ! git diff-index --quiet --cached --ignore-submodules $head --
|
||||
then
|
||||
die "Working directory has staged changes"
|
||||
fi
|
||||
|
||||
if ! git read-tree -u -m "$commit"
|
||||
then
|
||||
die "Could not update working tree to new HEAD"
|
||||
fi
|
||||
|
|
@ -0,0 +1,77 @@
|
|||
#!/bin/sh
|
||||
|
||||
# An example hook script to validate a patch (and/or patch series) before
|
||||
# sending it via email.
|
||||
#
|
||||
# The hook should exit with non-zero status after issuing an appropriate
|
||||
# message if it wants to prevent the email(s) from being sent.
|
||||
#
|
||||
# To enable this hook, rename this file to "sendemail-validate".
|
||||
#
|
||||
# By default, it will only check that the patch(es) can be applied on top of
|
||||
# the default upstream branch without conflicts in a secondary worktree. After
|
||||
# validation (successful or not) of the last patch of a series, the worktree
|
||||
# will be deleted.
|
||||
#
|
||||
# The following config variables can be set to change the default remote and
|
||||
# remote ref that are used to apply the patches against:
|
||||
#
|
||||
# sendemail.validateRemote (default: origin)
|
||||
# sendemail.validateRemoteRef (default: HEAD)
|
||||
#
|
||||
# Replace the TODO placeholders with appropriate checks according to your
|
||||
# needs.
|
||||
|
||||
validate_cover_letter () {
|
||||
file="$1"
|
||||
# TODO: Replace with appropriate checks (e.g. spell checking).
|
||||
true
|
||||
}
|
||||
|
||||
validate_patch () {
|
||||
file="$1"
|
||||
# Ensure that the patch applies without conflicts.
|
||||
git am -3 "$file" || return
|
||||
# TODO: Replace with appropriate checks for this patch
|
||||
# (e.g. checkpatch.pl).
|
||||
true
|
||||
}
|
||||
|
||||
validate_series () {
|
||||
# TODO: Replace with appropriate checks for the whole series
|
||||
# (e.g. quick build, coding style checks, etc.).
|
||||
true
|
||||
}
|
||||
|
||||
# main -------------------------------------------------------------------------
|
||||
|
||||
if test "$GIT_SENDEMAIL_FILE_COUNTER" = 1
|
||||
then
|
||||
remote=$(git config --default origin --get sendemail.validateRemote) &&
|
||||
ref=$(git config --default HEAD --get sendemail.validateRemoteRef) &&
|
||||
worktree=$(mktemp --tmpdir -d sendemail-validate.XXXXXXX) &&
|
||||
git worktree add -fd --checkout "$worktree" "refs/remotes/$remote/$ref" &&
|
||||
git config --replace-all sendemail.validateWorktree "$worktree"
|
||||
else
|
||||
worktree=$(git config --get sendemail.validateWorktree)
|
||||
fi || {
|
||||
echo "sendemail-validate: error: failed to prepare worktree" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
unset GIT_DIR GIT_WORK_TREE
|
||||
cd "$worktree" &&
|
||||
|
||||
if grep -q "^diff --git " "$1"
|
||||
then
|
||||
validate_patch "$1"
|
||||
else
|
||||
validate_cover_letter "$1"
|
||||
fi &&
|
||||
|
||||
if test "$GIT_SENDEMAIL_FILE_COUNTER" = "$GIT_SENDEMAIL_FILE_TOTAL"
|
||||
then
|
||||
git config --unset-all sendemail.validateWorktree &&
|
||||
trap 'git worktree remove -ff "$worktree"' EXIT &&
|
||||
validate_series
|
||||
fi
|
||||
|
|
@ -0,0 +1,128 @@
|
|||
#!/bin/sh
|
||||
#
|
||||
# An example hook script to block unannotated tags from entering.
|
||||
# Called by "git receive-pack" with arguments: refname sha1-old sha1-new
|
||||
#
|
||||
# To enable this hook, rename this file to "update".
|
||||
#
|
||||
# Config
|
||||
# ------
|
||||
# hooks.allowunannotated
|
||||
# This boolean sets whether unannotated tags will be allowed into the
|
||||
# repository. By default they won't be.
|
||||
# hooks.allowdeletetag
|
||||
# This boolean sets whether deleting tags will be allowed in the
|
||||
# repository. By default they won't be.
|
||||
# hooks.allowmodifytag
|
||||
# This boolean sets whether a tag may be modified after creation. By default
|
||||
# it won't be.
|
||||
# hooks.allowdeletebranch
|
||||
# This boolean sets whether deleting branches will be allowed in the
|
||||
# repository. By default they won't be.
|
||||
# hooks.denycreatebranch
|
||||
# This boolean sets whether remotely creating branches will be denied
|
||||
# in the repository. By default this is allowed.
|
||||
#
|
||||
|
||||
# --- Command line
|
||||
refname="$1"
|
||||
oldrev="$2"
|
||||
newrev="$3"
|
||||
|
||||
# --- Safety check
|
||||
if [ -z "$GIT_DIR" ]; then
|
||||
echo "Don't run this script from the command line." >&2
|
||||
echo " (if you want, you could supply GIT_DIR then run" >&2
|
||||
echo " $0 <ref> <oldrev> <newrev>)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ -z "$refname" -o -z "$oldrev" -o -z "$newrev" ]; then
|
||||
echo "usage: $0 <ref> <oldrev> <newrev>" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# --- Config
|
||||
allowunannotated=$(git config --type=bool hooks.allowunannotated)
|
||||
allowdeletebranch=$(git config --type=bool hooks.allowdeletebranch)
|
||||
denycreatebranch=$(git config --type=bool hooks.denycreatebranch)
|
||||
allowdeletetag=$(git config --type=bool hooks.allowdeletetag)
|
||||
allowmodifytag=$(git config --type=bool hooks.allowmodifytag)
|
||||
|
||||
# check for no description
|
||||
projectdesc=$(sed -e '1q' "$GIT_DIR/description")
|
||||
case "$projectdesc" in
|
||||
"Unnamed repository"* | "")
|
||||
echo "*** Project description file hasn't been set" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
# --- Check types
|
||||
# if $newrev is 0000...0000, it's a commit to delete a ref.
|
||||
zero=$(git hash-object --stdin </dev/null | tr '[0-9a-f]' '0')
|
||||
if [ "$newrev" = "$zero" ]; then
|
||||
newrev_type=delete
|
||||
else
|
||||
newrev_type=$(git cat-file -t $newrev)
|
||||
fi
|
||||
|
||||
case "$refname","$newrev_type" in
|
||||
refs/tags/*,commit)
|
||||
# un-annotated tag
|
||||
short_refname=${refname##refs/tags/}
|
||||
if [ "$allowunannotated" != "true" ]; then
|
||||
echo "*** The un-annotated tag, $short_refname, is not allowed in this repository" >&2
|
||||
echo "*** Use 'git tag [ -a | -s ]' for tags you want to propagate." >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
refs/tags/*,delete)
|
||||
# delete tag
|
||||
if [ "$allowdeletetag" != "true" ]; then
|
||||
echo "*** Deleting a tag is not allowed in this repository" >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
refs/tags/*,tag)
|
||||
# annotated tag
|
||||
if [ "$allowmodifytag" != "true" ] && git rev-parse $refname > /dev/null 2>&1
|
||||
then
|
||||
echo "*** Tag '$refname' already exists." >&2
|
||||
echo "*** Modifying a tag is not allowed in this repository." >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
refs/heads/*,commit)
|
||||
# branch
|
||||
if [ "$oldrev" = "$zero" -a "$denycreatebranch" = "true" ]; then
|
||||
echo "*** Creating a branch is not allowed in this repository" >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
refs/heads/*,delete)
|
||||
# delete branch
|
||||
if [ "$allowdeletebranch" != "true" ]; then
|
||||
echo "*** Deleting a branch is not allowed in this repository" >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
refs/remotes/*,commit)
|
||||
# tracking branch
|
||||
;;
|
||||
refs/remotes/*,delete)
|
||||
# delete tracking branch
|
||||
if [ "$allowdeletebranch" != "true" ]; then
|
||||
echo "*** Deleting a tracking branch is not allowed in this repository" >&2
|
||||
exit 1
|
||||
fi
|
||||
;;
|
||||
*)
|
||||
# Anything else (is there anything else?)
|
||||
echo "*** Update hook: unknown type of update to ref $refname of type $newrev_type" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
# --- Finished
|
||||
exit 0
|
||||
BIN
dot_config/tmux/plugins/tmux-tilish/dot_git/index
Normal file
BIN
dot_config/tmux/plugins/tmux-tilish/dot_git/index
Normal file
Binary file not shown.
6
dot_config/tmux/plugins/tmux-tilish/dot_git/info/exclude
Normal file
6
dot_config/tmux/plugins/tmux-tilish/dot_git/info/exclude
Normal file
|
|
@ -0,0 +1,6 @@
|
|||
# git ls-files --others --exclude-from=.git/info/exclude
|
||||
# Lines that start with '#' are comments.
|
||||
# For a project mostly in C, the following would be a good set of
|
||||
# exclude patterns (uncomment them if you want to use them):
|
||||
# *.[oa]
|
||||
# *~
|
||||
1
dot_config/tmux/plugins/tmux-tilish/dot_git/logs/HEAD
Normal file
1
dot_config/tmux/plugins/tmux-tilish/dot_git/logs/HEAD
Normal file
|
|
@ -0,0 +1 @@
|
|||
0000000000000000000000000000000000000000 6abf7be089804a1d19a5737c8f9f7cb5bb519fc3 Hydroxycarbamide <siklos@tuta.io> 1727090004 +0200 clone: from https://github.com/jabirali/tmux-tilish
|
||||
|
|
@ -0,0 +1 @@
|
|||
0000000000000000000000000000000000000000 6abf7be089804a1d19a5737c8f9f7cb5bb519fc3 Hydroxycarbamide <siklos@tuta.io> 1727090004 +0200 clone: from https://github.com/jabirali/tmux-tilish
|
||||
|
|
@ -0,0 +1 @@
|
|||
0000000000000000000000000000000000000000 6abf7be089804a1d19a5737c8f9f7cb5bb519fc3 Hydroxycarbamide <siklos@tuta.io> 1727090004 +0200 clone: from https://github.com/jabirali/tmux-tilish
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
2
dot_config/tmux/plugins/tmux-tilish/dot_git/packed-refs
Normal file
2
dot_config/tmux/plugins/tmux-tilish/dot_git/packed-refs
Normal file
|
|
@ -0,0 +1,2 @@
|
|||
# pack-refs with: peeled fully-peeled sorted
|
||||
6abf7be089804a1d19a5737c8f9f7cb5bb519fc3 refs/remotes/origin/master
|
||||
|
|
@ -0,0 +1 @@
|
|||
6abf7be089804a1d19a5737c8f9f7cb5bb519fc3
|
||||
|
|
@ -0,0 +1 @@
|
|||
ref: refs/remotes/origin/master
|
||||
294
dot_config/tmux/plugins/tmux-tilish/executable_tilish.tmux
Normal file
294
dot_config/tmux/plugins/tmux-tilish/executable_tilish.tmux
Normal file
|
|
@ -0,0 +1,294 @@
|
|||
#!/bin/sh
|
||||
# vim: foldmethod=marker
|
||||
|
||||
# Project: tmux-tilish
|
||||
# Author: Jabir Ali Ouassou <jabir.ali.ouassou@hvl.no>
|
||||
# Licence: MIT licence
|
||||
#
|
||||
# This file contains the `tmux` plugin `tilish`, which implements keybindings
|
||||
# that turns `tmux` into a more typical tiling window manger for your terminal.
|
||||
# The keybindings are taken nearly directly from `i3wm` and `sway`, but with
|
||||
# minor adaptation to fit better with `vim` and `tmux`. See also the README.
|
||||
|
||||
# shellcheck disable=SC2016
|
||||
# shellcheck disable=SC2086
|
||||
# shellcheck disable=SC2250
|
||||
|
||||
# Check input parameters {{{
|
||||
# Whether we need to use legacy workarounds (required before Tmux 2.7).
|
||||
legacy="$(tmux -V | grep -E 'tmux (1\.|2\.[0-6])')"
|
||||
|
||||
# Read user options.
|
||||
for opt in default dmenu easymode navigate navigator prefix shiftnum
|
||||
do
|
||||
export "$opt"="$(tmux show-option -gv @tilish-"$opt" 2>/dev/null)"
|
||||
done
|
||||
|
||||
# Default to US keyboard layout, unless something is configured.
|
||||
if [ -z "$shiftnum" ]
|
||||
then
|
||||
shiftnum='!@#$%^&*()'
|
||||
fi
|
||||
|
||||
# Determine "arrow types".
|
||||
if [ "${easymode:-}" = "on" ]
|
||||
then
|
||||
# Simplified arrows.
|
||||
h='left'; j='down'; k='up'; l='right';
|
||||
H='S-left'; J='S-down'; K='S-up'; L='S-right';
|
||||
else
|
||||
# Vim-style arrows.
|
||||
h='h'; j='j'; k='k'; l='l';
|
||||
H='H'; J='J'; K='K'; L='L';
|
||||
fi
|
||||
|
||||
# Determine modifier vs. prefix key.
|
||||
if [ -z "${prefix:-}" ]
|
||||
then
|
||||
bind='bind -n'
|
||||
mod='M-'
|
||||
else
|
||||
bind='bind -rT tilish'
|
||||
mod=''
|
||||
fi
|
||||
# }}}
|
||||
|
||||
# Define core functionality {{{
|
||||
bind_switch () {
|
||||
# Bind keys to switch between workspaces.
|
||||
tmux $bind "$1" \
|
||||
if-shell "tmux select-window -t :$2" "" "new-window -t :$2"
|
||||
}
|
||||
|
||||
bind_move () {
|
||||
# Bind keys to move panes between workspaces.
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "$1" \
|
||||
if-shell "tmux join-pane -t :$2" \
|
||||
"" \
|
||||
"new-window -dt :$2; join-pane -t :$2; select-pane -t top-left; kill-pane" \\\;\
|
||||
select-layout \\\;\
|
||||
select-layout -E
|
||||
else
|
||||
tmux $bind "$1" \
|
||||
if-shell "tmux new-window -dt :$2" \
|
||||
"join-pane -t :$2; select-pane -t top-left; kill-pane" \
|
||||
"send escape; join-pane -t :$2" \\\;\
|
||||
select-layout
|
||||
fi
|
||||
}
|
||||
|
||||
bind_layout () {
|
||||
# Bind keys to switch or refresh layouts.
|
||||
if [ "$2" = "zoom" ]
|
||||
then
|
||||
# Invoke the zoom feature.
|
||||
tmux $bind "$1" \
|
||||
resize-pane -Z
|
||||
else
|
||||
# Actually switch layout.
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "$1" \
|
||||
select-layout "$2" \\\;\
|
||||
select-layout -E
|
||||
else
|
||||
tmux $bind "$1" \
|
||||
run-shell "tmux select-layout \"$2\"" \\\;\
|
||||
send escape
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
char_at () {
|
||||
# Finding the character at a given position in
|
||||
# a string in a way compatible with POSIX sh.
|
||||
echo $1 | cut -c $2
|
||||
}
|
||||
# }}}
|
||||
|
||||
# Define keybindings {{{
|
||||
# Define a prefix key.
|
||||
if [ -n "$prefix" ]
|
||||
then
|
||||
tmux bind -n "$prefix" switch-client -T tilish
|
||||
fi
|
||||
|
||||
# Switch to workspace via Alt + #.
|
||||
bind_switch "${mod}1" 1
|
||||
bind_switch "${mod}2" 2
|
||||
bind_switch "${mod}3" 3
|
||||
bind_switch "${mod}4" 4
|
||||
bind_switch "${mod}5" 5
|
||||
bind_switch "${mod}6" 6
|
||||
bind_switch "${mod}7" 7
|
||||
bind_switch "${mod}8" 8
|
||||
bind_switch "${mod}9" 9
|
||||
|
||||
# Move pane to workspace via Alt + Shift + #.
|
||||
bind_move "${mod}$(char_at $shiftnum 1)" 1
|
||||
bind_move "${mod}$(char_at $shiftnum 2)" 2
|
||||
bind_move "${mod}$(char_at $shiftnum 3)" 3
|
||||
bind_move "${mod}$(char_at $shiftnum 4)" 4
|
||||
bind_move "${mod}$(char_at $shiftnum 5)" 5
|
||||
bind_move "${mod}$(char_at $shiftnum 6)" 6
|
||||
bind_move "${mod}$(char_at $shiftnum 7)" 7
|
||||
bind_move "${mod}$(char_at $shiftnum 8)" 8
|
||||
bind_move "${mod}$(char_at $shiftnum 9)" 9
|
||||
|
||||
# The mapping of Alt + 0 and Alt + Shift + 0 depends on `base-index`.
|
||||
# It can either refer to workspace number 0 or workspace number 10.
|
||||
if [ "$(tmux show-option -gv base-index)" = "1" ]
|
||||
then
|
||||
bind_switch "${mod}0" 10
|
||||
bind_move "${mod}$(char_at "$shiftnum" 10)" 10
|
||||
else
|
||||
bind_switch "${mod}0" 0
|
||||
bind_move "${mod}$(char_at "$shiftnum" 10)" 0
|
||||
fi
|
||||
|
||||
# Switch layout with Alt + <mnemonic key>. The mnemonics are `s` and `S` for
|
||||
# layouts Vim would generate with `:split`, and `v` and `V` for `:vsplit`.
|
||||
# The remaining mappings based on `z` and `t` should be quite obvious.
|
||||
bind_layout "${mod}s" 'main-horizontal'
|
||||
bind_layout "${mod}S" 'even-vertical'
|
||||
bind_layout "${mod}v" 'main-vertical'
|
||||
bind_layout "${mod}V" 'even-horizontal'
|
||||
bind_layout "${mod}t" 'tiled'
|
||||
bind_layout "${mod}z" 'zoom'
|
||||
|
||||
# Refresh the current layout (e.g. after deleting a pane).
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "${mod}r" select-layout -E
|
||||
else
|
||||
tmux $bind "${mod}r" run-shell 'tmux select-layout'\\\; send escape
|
||||
fi
|
||||
|
||||
# Switch pane via Alt + o. (Mirrors Tmux `Ctrl-b o` and Emacs `Ctrl-x o`.)
|
||||
tmux $bind "${mod}o" select-pane -t :.+1
|
||||
|
||||
# Switch to pane via Alt + hjkl.
|
||||
tmux $bind "${mod}${h}" select-pane -L
|
||||
tmux $bind "${mod}${j}" select-pane -D
|
||||
tmux $bind "${mod}${k}" select-pane -U
|
||||
tmux $bind "${mod}${l}" select-pane -R
|
||||
|
||||
# Move a pane via Alt + Shift + hjkl.
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "${mod}${H}" swap-pane -s '{left-of}'
|
||||
tmux $bind "${mod}${J}" swap-pane -s '{down-of}'
|
||||
tmux $bind "${mod}${K}" swap-pane -s '{up-of}'
|
||||
tmux $bind "${mod}${L}" swap-pane -s '{right-of}'
|
||||
else
|
||||
tmux $bind "${mod}${H}" run-shell 'old=`tmux display -p "#{pane_index}"`; tmux select-pane -L; tmux swap-pane -t $old'
|
||||
tmux $bind "${mod}${J}" run-shell 'old=`tmux display -p "#{pane_index}"`; tmux select-pane -D; tmux swap-pane -t $old'
|
||||
tmux $bind "${mod}${K}" run-shell 'old=`tmux display -p "#{pane_index}"`; tmux select-pane -U; tmux swap-pane -t $old'
|
||||
tmux $bind "${mod}${L}" run-shell 'old=`tmux display -p "#{pane_index}"`; tmux select-pane -R; tmux swap-pane -t $old'
|
||||
fi
|
||||
|
||||
# Open a terminal with Alt + Enter.
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "${mod}enter" \
|
||||
run-shell 'cwd="`tmux display -p \"#{pane_current_path}\"`"; tmux select-pane -t "bottom-right"; tmux split-pane -c "$cwd"'
|
||||
else
|
||||
tmux $bind "${mod}enter" \
|
||||
select-pane -t 'bottom-right' \\\;\
|
||||
split-window \\\;\
|
||||
run-shell 'tmux select-layout' \\\;\
|
||||
send escape
|
||||
fi
|
||||
|
||||
# Name a window with Alt + n.
|
||||
tmux $bind "${mod}n" \
|
||||
command-prompt -p 'Workspace name:' 'rename-window "%%"'
|
||||
|
||||
# Close a window with Alt + Shift + q.
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
tmux $bind "${mod}Q" \
|
||||
if-shell \
|
||||
'[ "$(tmux display-message -p "#{window_panes}")" -gt 1 ]' \
|
||||
'kill-pane; select-layout; select-layout -E' \
|
||||
'kill-pane'
|
||||
else
|
||||
tmux $bind "${mod}Q" \
|
||||
kill-pane
|
||||
fi
|
||||
|
||||
# Close a connection with Alt + Shift + e.
|
||||
tmux $bind "${mod}E" \
|
||||
confirm-before -p "Detach from #H:#S? (y/n)" detach-client
|
||||
|
||||
# Reload configuration with Alt + Shift + c.
|
||||
tmux $bind "${mod}C" \
|
||||
source-file ~/.tmux.conf \\\;\
|
||||
display "Reloaded config"
|
||||
# }}}
|
||||
|
||||
# Define hooks {{{
|
||||
if [ -z "$legacy" ]
|
||||
then
|
||||
# Autorefresh layout after deleting a pane.
|
||||
tmux set-hook -g after-split-window "select-layout; select-layout -E"
|
||||
tmux set-hook -g pane-exited "select-layout; select-layout -E"
|
||||
|
||||
# Autoselect layout after creating new window.
|
||||
if [ -n "${default:-}" ]
|
||||
then
|
||||
tmux set-hook -g window-linked "select-layout \"$default\"; select-layout -E"
|
||||
tmux select-layout "$default"
|
||||
tmux select-layout -E
|
||||
fi
|
||||
fi
|
||||
# }}}
|
||||
|
||||
# Integrate with Vim for transparent navigation {{{
|
||||
if [ "${navigate:-}" = "on" ]
|
||||
then
|
||||
# If `@tilish-navigate` is nonzero, integrate Alt + hjkl with `tmux-navigate`.
|
||||
tmux set -g '@navigate-left' "-n M-$h"
|
||||
tmux set -g '@navigate-down' "-n M-$j"
|
||||
tmux set -g '@navigate-up' "-n M-$k"
|
||||
tmux set -g '@navigate-right' "-n M-$l"
|
||||
elif [ "${navigator:-}" = "on" ]
|
||||
then
|
||||
# If `@tilish-navigator` is nonzero, integrate Alt + hjkl with `vim-tmux-navigator`.
|
||||
# This assumes that your Vim/Neovim is setup to use Alt + hjkl bindings as well.
|
||||
is_vim="ps -o state= -o comm= -t '#{pane_tty}' | grep -iqE '^[^TXZ ]+ +(\\S+\\/)?g?(view|n?vim?x?)(diff)?$'"
|
||||
|
||||
tmux $bind "${mod}${h}" if-shell "$is_vim" 'send M-h' 'select-pane -L'
|
||||
tmux $bind "${mod}${j}" if-shell "$is_vim" 'send M-j' 'select-pane -D'
|
||||
tmux $bind "${mod}${k}" if-shell "$is_vim" 'send M-k' 'select-pane -U'
|
||||
tmux $bind "${mod}${l}" if-shell "$is_vim" 'send M-l' 'select-pane -R'
|
||||
|
||||
if [ -z "$prefix" ]
|
||||
then
|
||||
tmux bind -T copy-mode-vi "M-$h" select-pane -L
|
||||
tmux bind -T copy-mode-vi "M-$j" select-pane -D
|
||||
tmux bind -T copy-mode-vi "M-$k" select-pane -U
|
||||
tmux bind -T copy-mode-vi "M-$l" select-pane -R
|
||||
fi
|
||||
fi
|
||||
# }}}
|
||||
|
||||
# Integrate with `fzf` to approximate `dmenu` {{{
|
||||
if [ -z "$legacy" ] && [ "${dmenu:-}" = "on" ]
|
||||
then
|
||||
if [ -n "$(command -v fzf)" ]
|
||||
then
|
||||
# The environment variables of your `default-shell` are used when running `fzf`.
|
||||
# This solution is about an order of magnitude faster than invoking `compgen`.
|
||||
# Based on: https://medium.com/njiuko/using-fzf-instead-of-dmenu-2780d184753f
|
||||
tmux $bind "${mod}d" \
|
||||
select-pane -t '{bottom-right}' \\\;\
|
||||
split-pane 'sh -c "exec \$(echo \"\$PATH\" | tr \":\" \"\n\" | xargs -I{} -- find {} -maxdepth 1 -mindepth 1 -executable 2>/dev/null | sort -u | fzf)"'
|
||||
else
|
||||
tmux $bind "${mod}d" \
|
||||
display 'To enable this function, install `fzf` and restart `tmux`.'
|
||||
fi
|
||||
fi
|
||||
# }}}
|
||||
Loading…
Add table
Add a link
Reference in a new issue