https://github.com/z-shell/zsh-util-lib
A utility library for Z shell that provides a few general-purpose functions. It's a counterpart to the zsh-string-lib library
https://github.com/z-shell/zsh-util-lib
string-library zsh
Last synced: about 1 month ago
JSON representation
A utility library for Z shell that provides a few general-purpose functions. It's a counterpart to the zsh-string-lib library
- Host: GitHub
- URL: https://github.com/z-shell/zsh-util-lib
- Owner: z-shell
- License: other
- Created: 2021-11-08T12:51:19.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-14T11:33:53.000Z (over 3 years ago)
- Last Synced: 2025-05-05T17:23:36.018Z (12 months ago)
- Topics: string-library, zsh
- Language: Shell
- Homepage: https://wiki.zshell.dev
- Size: 8.79 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zsh Util lib
- [Introduction](#introduction)
- [List Of The Functions](#list-of-the-functions)
- [@util-bind-all](#util-bind-all)
## Introduction
An utility-library for Zshell that provides a few general-purpose functions.
It's a counterpart to the
[zsh-string-lib](https://github.com/z-shell/zsh-string-lib) library.
## List Of The Functions
### @util-bind-all
Rebinds all key bindings so that they're executing some custom code. It's an
alternative to overloading of all Zle widgets.
Arguments:
1. The custom snippet of code to run before executing the original widget.
2. A bool (`1`,`yes`,`true`,`on` for truth or other value for false) indicating
whether the widget calls should be automatically forwarded to their original
(before-binding) versions.
3. (Optional) Custom snippet of code to be executed **after** executing the
original widget.
4. (Optional) A method of the binding – either `bindkey` (the default) or
`zle-N`. The first one is fully bindkey based, i.e.: e.g.: it doesn't create
the backup widgets that are typically prefixed with "orig–". The second is
half-bindkey / half-zle -N based - it does create the backup widgets, however
the widgets are obtained using `bindkey` listing invocation, which means that
typically only a half of all widgets are bound.
Example:
```zsh
@util-bind-all 'print hello!' yes 'print hello after!'
```