1
0
Fork 0
mirror of https://github.com/zdharma-continuum/zinit-annex-meta-plugins.git synced 2024-11-21 12:07:59 +01:00
A Zsh-Zinit extension that allows to install predefined groups of plugins ↔ meta-plugins.
Find a file
vladislav doster 7a8104cf62
Merge pull request #9 from zdharma-continuum/ci/gh-action-lint-workflow
feat: add lint gh action workflows
2023-04-15 23:46:14 -05:00
.github/workflows feat: add lint gh action workflow 2023-04-14 17:11:08 -05:00
images fuzzy-mplg-ex.png 2020-07-18 16:30:31 +02:00
.gitattributes Initial commit. 2020-07-17 01:27:40 +02:00
.gitignore zdharma -> &-continuum 2021-11-12 12:03:42 +01:00
LICENSE Initial commit. 2020-07-17 01:27:40 +02:00
README.md feat: add lint gh action workflow 2023-04-14 17:11:08 -05:00
z-a-meta-plugins.plugin.zsh Remove non-ascii chars from filenames (#4) 2021-11-19 23:19:20 +01:00
za-meta-plugins-before-load-handler Remove non-ascii chars from filenames (#4) 2021-11-19 23:19:20 +01:00
za-meta-plugins-default-ice-cmd Remove non-ascii chars from filenames (#4) 2021-11-19 23:19:20 +01:00
za-meta-plugins-default-ice-cmd-help-handler Remove non-ascii chars from filenames (#4) 2021-11-19 23:19:20 +01:00
za-meta-plugins-meta-cmd-help-handler Remove non-ascii chars from filenames (#4) 2021-11-19 23:19:20 +01:00

Meta-Plugins support for Zsh-Zinit

Install groups of plugins via a single, friendly label …

… and also have the curated, optimal ice lists automatically applied !

screenshot

Rationale

It can be tiring to:

  1. Constantly, over and over collect some new interesting plugins to install/load.
  2. Over and over reconstruct the new findings on the new machines.
  3. Constantly extend and tweak the ice list of each plugin, so that it's hard on eyes, especially for an outsider.

Meta-Plugins annex helps in those problems:

Problem Solution
(1)
finding new plugins
the annex contains a curated, broad list of plugins, e.g.: all the console tools like fd, fzf, exa, ripgrep, etc.,
(2)
reconstructing the findings in new environments
it's easy to say and memorize e.g.: zinit for console-tools – one label pulls a group of plugins and also the curated, optimal, default ice lists for each of them,
(3)
constant increase of complexity of the commands
the provided, hopefully best/optimal ices for each plugin are handled transparently and automatically; care is given to each ice list so that the plugin loads without any glitches (e.g.: without "No files for compilation found." message and other, even such slight issues).

Other unique benefits of the Meta-Plugins annex:

Benefit Description
plugin dependencies The meta-plugins implement a dependency mechanism (to some extent), so that e.g.: selecting a from-source built ogham/exa will automatically pull-in also the Rust compiler (available under meta-plugin name: rust-toolchain).
flexible disabling of chosen sub-plugins in any meta-plugin A meta-plugin can contain many sub-plugins and it's possible to skip installing some of them by the skip'plg-1 plg-2…' ice, e.g.: zinit skip'ripgrep fd' for console-tools. This way despite that some of the meta-plugins are broad the user still has control over what's and how much is being installed.
common from-source meta-plugins For the plugins that provide the binary programs it is often the case that a meta-plugin exists that'll build the program from source (e.g.: fuzzy meta-plugin and its fuzzy-src counterpart). This might be handy e.g.: if there's no binary for our machine.

The list of the meta-plugins

Meta-Plugin ID Contained sub-plugins
annexes zdharma-continuum/zinit-annex-unscope, zdharma-continuum/zinit-annex-as-monitor, zdharma-continuum/zinit-annex-patch-dl, zdharma-continuum/zinit-annex-rust, zdharma-continuum/zinit-annex-submods, zdharma-continuum/zinit-annex-bin-gem-node
annexes+con zdharma-continuum/zinit-console, annexes (meta-plugin)
zsh-users zsh-users/zsh-syntax-highlighting, zsh-users/zsh-autosuggestions, zsh-users/zsh-completions
zsh-users+fast, zdharma-continuum/fast-syntax-highlighting, zsh-users/zsh-autosuggestions, zsh-users/zsh-completions
zdharma zdharma-continuum/fast-syntax-highlighting, zdharma-continuum/history-search-multi-word, zdharma-continuum/zsh-diff-so-fancy
zdharma2 zdharma-continuum/zconvey, zdharma-continuum/zui, zdharma-continuum/zflai
molovo molovo/color, molovo/revolver, molovo/zunit
sharkdp sharkdp/fd, sharkdp/bat, sharkdp/hexyl, sharkdp/hyperfine, sharkdp/vivid
developer github-issues (package), github-issues-srv (package), molovo/color, molovo/revolver, molovo/zunit, voronkovich/gitignore, jonas/tig
console-tools dircolors-material (package), sharkdp (meta-plugin), ogham/exa, BurntSushi/ripgrep, jonas/tig
fuzzy fzf (package), fzy (package), lotabout/skim, peco/peco
fuzzy-src fzf-go, fzy (package), skim-cargo, peco-go
ext-git Fakerr/git-recall, paulirish/git-open, paulirish/git-recent, davidosomething/git-my, arzzen/git-quick-stats, iwata/git-now, tj/git-extras, wfxr/forgit
rust-utils rust-toolchain, cargo-extensions
prezto PZTM::archive, PZTM::directory, PZTM::utility

Example zshrc

# Installs total of 22 plugins
zinit for annexes zsh-users+fast console-tools fuzzy