Note: I'm too busy with other stuff to work on this right now. If you like vizardry, I recommend using dbeniamine's awesome vizardry fork

Vizardry

Remember back in the dark ages of 2013? When you had to search for vim plugins like a wild animal, using your browser?

In 2014, you can just type ":Invoke <keyword>" and vizardry will automatically search github for the plugin you want and install it for you.

##Basic Usage

• Type :Invoke with no keywords to reload your plugins.
• Type :Invoke <keyword> and hit yes to install a plugin and reload.
• Type :Banish <samekeyword> to remove that plugin from pathogen. You will have to restart vim to see the effect.

##Additional Usage

• Type :Unbanish <keyword> to reverse a banish.
• Type :Scry with no keywards to list all invoked and banished plugins.
• Type :Scry <keyword> to search github for a script and output the top 10 results.
• Type :Invoke <number> to install the plugin with that number from the last scry.
• Type :Magic to manage global and plugin-specific settings. See Magic below.

##Examples Suppose you're in the middle of vimming and you have a sudden need to surround random words in "scare quotes". You can't remember who made the surround plugin, or whether it's called surround.vim, vim-surround or vim-surround-plugin. Most importantly, you're lazy.

Just type:

:Invoke surround

Vizardry will pop up a prompt saying:

Found tpope/vim-surround
(surround.vim: quoting/parenthesizing made simple)

Clone as "surround"? (Yes/No/Rename)

Press Y and you can immediately start surrounding things. It's that easy.


Even plugins with vague or silly names can be found with vizardry. Imagine you're running multiple instances of vim and need a package to sync registers.

Type:

:Invoke sync registers

Vizardry will prompt you with:

Found ardagnir/united-front
(Automatically syncs registers between vim instances)

Clone as "syncregisters"? (Yes/No/Rename)

Just as easy.

##Magic Too many globals and settings for each plugin? Vizardry stores a set of magic files that can keep track of these for you.

• Type :Magic * <magic words> and add thse words to a file that acts similarly to your vimrc.
• Type :Magic <plugin> <magic words> to add plugin-specific globals and settings. These are only used when that plugin isn't banished.
• Type :Magic{edit/split/vsplit} <plugin> to edit/split/vsplit the magic file for that plugin.

##Requirements

• Vizardry requires pathogen. But you already have pathogen installed, don't you?

• It also needs curl, as well as commandline programs that come with most *nix systems.

• You will probably have issues if you use a Windows OS.

##Installation Use pathogen.

cd ~/.vim/bundle
git clone https://github.com/ardagnir/vizardry

##Notes

• Vizardry banishes plugins by adding a tilde to the end of their directory name. This stops pathogen from reading them. If you want to remove packages completly, you must do it yourself.
• Vizardry finds the matching plugin with the highest star rating on github. This is usually, but not always, the one you want, so pay attention. Remember that you can use scry to find more results.
• Vizardry currently has no way of updating packages. That should change soon, but until then, you'll have to update them from the shell.
• If you want to use submodules instead of cloning, set g:VizardryGitMethod to "submodule add"

##License Vizardry is licensed under the AGPL v3