Compare commits
No commits in common. "master" and "0.2.0" have entirely different histories.
1
.github/FUNDING.yml
vendored
|
@ -1 +0,0 @@
|
||||||
github: junegunn
|
|
37
.github/ISSUE_TEMPLATE.md
vendored
|
@ -1,37 +0,0 @@
|
||||||
<!--
|
|
||||||
### Before Submitting
|
|
||||||
|
|
||||||
- You checked the [faq](https://github.com/junegunn/vim-plug/wiki/faq) for common problems.
|
|
||||||
- Check your [requirements](https://github.com/junegunn/vim-plug/wiki/requirements) are satisfied.
|
|
||||||
- You are not going to suggest vim-plug manage itself like Vundle, see #240, #364, #367 ...
|
|
||||||
-->
|
|
||||||
|
|
||||||
Explain the problem here ...
|
|
||||||
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
<!-- Paste your Plug block (from `call plug#begin()` to `call plug#end()`) -->
|
|
||||||
```
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
<!-- Paste the contents of `:version` below -->
|
|
||||||
```
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
<!-- Check all that apply. -->
|
|
||||||
- Type:
|
|
||||||
- [ ] Bug
|
|
||||||
- [ ] Enhancement
|
|
||||||
- [ ] Feature Request
|
|
||||||
- [ ] Question
|
|
||||||
- OS:
|
|
||||||
- [ ] All/Other
|
|
||||||
- [ ] Linux
|
|
||||||
- [ ] macOS
|
|
||||||
- [ ] Windows
|
|
||||||
- Vim:
|
|
||||||
- [ ] Terminal Vim
|
|
||||||
- [ ] GVim
|
|
||||||
- [ ] Neovim
|
|
8
.github/PULL_REQUEST_TEMPLATE.md
vendored
|
@ -1,8 +0,0 @@
|
||||||
<!-- ## Before Submitting
|
|
||||||
|
|
||||||
- You made sure the existing tests/travis build works.
|
|
||||||
- You made sure any new features were tested where appropriate.
|
|
||||||
- You checked a similar feature wasn't already turned down by searching issues & PRs.
|
|
||||||
-->
|
|
||||||
|
|
||||||
Describe the details of your PR ...
|
|
52
.github/workflows/test.yml
vendored
|
@ -1,52 +0,0 @@
|
||||||
---
|
|
||||||
name: Test vim-plug
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches: [master, devel]
|
|
||||||
pull_request:
|
|
||||||
branches: [master]
|
|
||||||
workflow_dispatch:
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
vim:
|
|
||||||
- vim
|
|
||||||
# FIXME: (core dumped) https://github.com/junegunn/vim-plug/runs/4422576984?check_suite_focus=true#step:3:238
|
|
||||||
# - neovim-stable
|
|
||||||
# - neovim-unstable
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
with:
|
|
||||||
fetch-depth: 0
|
|
||||||
|
|
||||||
- name: Install packages and test
|
|
||||||
env:
|
|
||||||
ENV: ${{ matrix.vim }}
|
|
||||||
run: |
|
|
||||||
export DEPS=~/deps
|
|
||||||
export PATH=~/deps/bin:$PATH
|
|
||||||
|
|
||||||
git config --global user.email "you@example.com"
|
|
||||||
git config --global user.name "Your Name"
|
|
||||||
|
|
||||||
case "$ENV" in
|
|
||||||
vim)
|
|
||||||
sudo apt-get install vim
|
|
||||||
;;
|
|
||||||
neovim-*)
|
|
||||||
sudo add-apt-repository ppa:neovim-ppa/${ENV/neovim-/}
|
|
||||||
sudo apt-get update
|
|
||||||
sudo apt-get install neovim
|
|
||||||
|
|
||||||
mkdir -p $DEPS/bin
|
|
||||||
echo 'nvim "$@"' > $DEPS/bin/vim
|
|
||||||
chmod +x $DEPS/bin/vim
|
|
||||||
export VADER_OUTPUT_FILE=/dev/stderr
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
test/run !
|
|
1
.gitignore
vendored
|
@ -1 +0,0 @@
|
||||||
doc/tags
|
|
71
.travis.yml
|
@ -1,71 +0,0 @@
|
||||||
language: minimal
|
|
||||||
env:
|
|
||||||
global:
|
|
||||||
- DEPS=$HOME/deps
|
|
||||||
- PATH=$DEPS/bin:$PATH
|
|
||||||
jobs:
|
|
||||||
include:
|
|
||||||
- env: ENV=vim80-bionic
|
|
||||||
dist: bionic
|
|
||||||
stage: vim8
|
|
||||||
- env: ENV=vim-nightly
|
|
||||||
dist: trusty
|
|
||||||
stage: vim8
|
|
||||||
- env: ENV=neovim-stable
|
|
||||||
dist: bionic
|
|
||||||
addons: {apt: {packages: [neovim], sources: [{sourceline: 'ppa:neovim-ppa/stable'}]}}
|
|
||||||
stage: neovim
|
|
||||||
- env: ENV=neovim-nightly
|
|
||||||
dist: bionic
|
|
||||||
addons: {apt: {packages: [neovim], sources: [{sourceline: 'ppa:neovim-ppa/unstable'}]}}
|
|
||||||
stage: neovim
|
|
||||||
- env: ENV=vim74-trusty-python
|
|
||||||
dist: trusty
|
|
||||||
stage: vim74
|
|
||||||
- env: ENV=vim74-xenial-python3
|
|
||||||
dist: xenial
|
|
||||||
stage: vim74
|
|
||||||
- env: ENV=vim74-trusty-ruby
|
|
||||||
dist: trusty
|
|
||||||
addons: {apt: {packages: [vim-nox]}}
|
|
||||||
stage: vim74
|
|
||||||
- env: ENV=vim74-xenial-ruby
|
|
||||||
dist: xenial
|
|
||||||
addons: {apt: {packages: [vim-nox]}}
|
|
||||||
stage: vim74
|
|
||||||
- env: ENV=osx-highsierra
|
|
||||||
os: osx
|
|
||||||
osx_image: xcode9.4
|
|
||||||
stage: vim8
|
|
||||||
install: |
|
|
||||||
git config --global user.email "you@example.com"
|
|
||||||
git config --global user.name "Your Name"
|
|
||||||
|
|
||||||
C_OPTS="--prefix=$DEPS --with-features=huge --disable-gui "
|
|
||||||
case "$ENV" in
|
|
||||||
vim-*)
|
|
||||||
;;
|
|
||||||
neovim-*)
|
|
||||||
mkdir -p ${DEPS}/bin
|
|
||||||
ln -s /usr/bin/nvim ${DEPS}/bin/vim
|
|
||||||
export VADER_OUTPUT_FILE=/dev/stderr
|
|
||||||
return
|
|
||||||
;;
|
|
||||||
vim74-* | vim80-*)
|
|
||||||
mkdir -p ${DEPS}/bin
|
|
||||||
ln -s /usr/bin/vim.nox ${DEPS}/bin/vim
|
|
||||||
return
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
return
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
git clone --depth 1 https://github.com/vim/vim
|
|
||||||
cd vim
|
|
||||||
export PATH=/usr/bin:$PATH
|
|
||||||
./configure $C_OPTS
|
|
||||||
make
|
|
||||||
make install
|
|
||||||
cd -
|
|
||||||
script: test/run !
|
|
21
LICENSE
|
@ -1,21 +0,0 @@
|
||||||
MIT License
|
|
||||||
|
|
||||||
Copyright (c) 2017 Junegunn Choi
|
|
||||||
|
|
||||||
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.
|
|
530
README.md
|
@ -1,463 +1,165 @@
|
||||||
<div align="center">
|

|
||||||
<sup>Special thanks to:</sup>
|
|
||||||
<br>
|
|
||||||
<br>
|
|
||||||
<a href="https://warp.dev/?utm_source=github&utm_medium=referral&utm_campaign=vimplug_20240209">
|
|
||||||
<div>
|
|
||||||
<img src="https://raw.githubusercontent.com/junegunn/i/master/warp.png" width="300" alt="Warp">
|
|
||||||
</div>
|
|
||||||
<b>Warp is a modern, Rust-based terminal with AI built in so you and your team can build great software, faster.</b>
|
|
||||||
<div>
|
|
||||||
<sup>Visit warp.dev to learn more.</sup>
|
|
||||||
</div>
|
|
||||||
</a>
|
|
||||||
<br>
|
|
||||||
<hr>
|
|
||||||
</div>
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<h1 title="vim-plug">
|
A single-file Vim plugin manager.
|
||||||
<picture>
|
|
||||||
<source media="(prefers-color-scheme: dark)" srcset="./plug-dark.png">
|
|
||||||
<img src="./plug.png" height="75" alt="vim-plug">
|
|
||||||
</picture>
|
|
||||||
<a href="https://github.com/junegunn/vim-plug/actions/workflows/test.yml?query=branch%3Amaster">
|
|
||||||
<img src="https://img.shields.io/github/actions/workflow/status/junegunn/vim-plug/test.yml?branch=master">
|
|
||||||
</a>
|
|
||||||
</h1>
|
|
||||||
|
|
||||||
A minimalist Vim plugin manager.
|
Somewhere between [Pathogen](https://github.com/tpope/vim-pathogen) and
|
||||||
|
[Vundle](https://github.com/gmarik/vundle), but with faster parallel installer.
|
||||||
|
|
||||||
<img src="https://raw.githubusercontent.com/junegunn/i/master/vim-plug/installer.gif" height="450">
|

|
||||||
|
|
||||||
## Pros.
|
### Pros.
|
||||||
|
|
||||||
- Minimalist design
|
- Easier to setup
|
||||||
- Just one file with no dependencies. Super easy to set up.
|
- Parallel installation/update (requires
|
||||||
- Concise, intuitive syntax that you can learn within minutes. No boilerplate code required.
|
[+ruby](http://junegunn.kr/2013/09/installing-vim-with-ruby-support/))
|
||||||
- No feature bloat
|
- Smallest possible feature set
|
||||||
- Extremely stable with flawless backward compatibility
|
- Branch/tag support
|
||||||
- Works perfectly with all versions of Vim since 2006 and all versions of Neovim ever released
|
- On-demand loading
|
||||||
- [Super-fast][40/4] parallel installation/update
|
- Dependency resolution using `Plugfile` (experimental)
|
||||||
- Creates shallow clones to minimize disk space usage and download time
|
|
||||||
- On-demand loading for [faster startup time][startup-time]
|
|
||||||
- Can review and rollback updates
|
|
||||||
- Branch/tag/commit support
|
|
||||||
- Post-update hooks
|
|
||||||
- Support for externally managed plugins
|
|
||||||
|
|
||||||
[40/4]: https://raw.githubusercontent.com/junegunn/i/master/vim-plug/40-in-4.gif
|
### Cons.
|
||||||
[startup-time]: https://github.com/junegunn/vim-startuptime-benchmark#result
|
|
||||||
|
|
||||||
## Installation
|
- Everything else
|
||||||
|
|
||||||
[Download plug.vim](https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim)
|
### Usage
|
||||||
and put it in the "autoload" directory.
|
|
||||||
|
|
||||||
<details>
|
[Download plug.vim](https://raw.github.com/junegunn/vim-plug/master/plug.vim)
|
||||||
<summary>Click to see the instructions</summary>
|
and put it in ~/.vim/autoload
|
||||||
|
|
||||||
### Vim
|
|
||||||
|
|
||||||
#### Unix
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
|
mkdir -p ~/.vim/autoload
|
||||||
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
|
curl -fLo ~/.vim/autoload/plug.vim https://raw.github.com/junegunn/vim-plug/master/plug.vim
|
||||||
```
|
```
|
||||||
|
|
||||||
You can automate the process by putting the command in your Vim configuration
|
Edit your .vimrc
|
||||||
file as suggested [here][auto].
|
|
||||||
|
|
||||||
[auto]: https://github.com/junegunn/vim-plug/wiki/tips#automatic-installation
|
|
||||||
|
|
||||||
#### Windows (PowerShell)
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
|
|
||||||
ni $HOME/vimfiles/autoload/plug.vim -Force
|
|
||||||
```
|
|
||||||
|
|
||||||
### Neovim
|
|
||||||
|
|
||||||
#### Unix, Linux
|
|
||||||
|
|
||||||
```sh
|
|
||||||
sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
|
|
||||||
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Linux (Flatpak)
|
|
||||||
|
|
||||||
```sh
|
|
||||||
curl -fLo ~/.var/app/io.neovim.nvim/data/nvim/site/autoload/plug.vim --create-dirs \
|
|
||||||
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Windows (PowerShell)
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
|
|
||||||
ni "$(@($env:XDG_DATA_HOME, $env:LOCALAPPDATA)[$null -eq $env:XDG_DATA_HOME])/nvim-data/site/autoload/plug.vim" -Force
|
|
||||||
```
|
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
Add a vim-plug section to your `~/.vimrc` (or `~/.config/nvim/init.vim` for Neovim)
|
|
||||||
|
|
||||||
1. Begin the section with `call plug#begin()`
|
|
||||||
1. List the plugins with `Plug` commands
|
|
||||||
1. End the section with `call plug#end()`
|
|
||||||
|
|
||||||
For example,
|
|
||||||
|
|
||||||
```vim
|
```vim
|
||||||
call plug#begin()
|
call plug#begin('~/.vim/plugged')
|
||||||
|
|
||||||
" List your plugins here
|
|
||||||
Plug 'tpope/vim-sensible'
|
|
||||||
|
|
||||||
call plug#end()
|
|
||||||
```
|
|
||||||
|
|
||||||
Reload the file or restart Vim, then you can,
|
|
||||||
|
|
||||||
* `:PlugInstall` to install the plugins
|
|
||||||
* `:PlugUpdate` to install or update the plugins
|
|
||||||
* `:PlugDiff` to review the changes from the last update
|
|
||||||
* `:PlugClean` to remove plugins no longer in the list
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> That's basically all you need to know to get started. The rest of the
|
|
||||||
> document is for advanced users who want to know more about the features and
|
|
||||||
> options.
|
|
||||||
|
|
||||||
> [!TIP]
|
|
||||||
> `plug#end()` automatically executes `filetype plugin indent on` and `syntax
|
|
||||||
> enable`. We believe this is a good default for most users, but if you don't
|
|
||||||
> want this behavior, you can revert the settings after the call.
|
|
||||||
>
|
|
||||||
> ```vim
|
|
||||||
> call plug#end()
|
|
||||||
> filetype indent off " Disable file-type-specific indentation
|
|
||||||
> syntax off " Disable syntax highlighting
|
|
||||||
> ```
|
|
||||||
|
|
||||||
### Getting Help
|
|
||||||
|
|
||||||
- See [tutorial] page to learn more about the basics of vim-plug
|
|
||||||
- See [tips] and [FAQ] pages for common problems and questions
|
|
||||||
|
|
||||||
[tutorial]: https://github.com/junegunn/vim-plug/wiki/tutorial
|
|
||||||
[tips]: https://github.com/junegunn/vim-plug/wiki/tips
|
|
||||||
[FAQ]: https://github.com/junegunn/vim-plug/wiki/faq
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
The following examples demonstrate the additional features of vim-plug.
|
|
||||||
|
|
||||||
### Vim script example
|
|
||||||
|
|
||||||
```vim
|
|
||||||
call plug#begin()
|
|
||||||
" The default plugin directory will be as follows:
|
|
||||||
" - Vim (Linux/macOS): '~/.vim/plugged'
|
|
||||||
" - Vim (Windows): '~/vimfiles/plugged'
|
|
||||||
" - Neovim (Linux/macOS/Windows): stdpath('data') . '/plugged'
|
|
||||||
" You can specify a custom plugin directory by passing it as the argument
|
|
||||||
" - e.g. `call plug#begin('~/.vim/plugged')`
|
|
||||||
" - Avoid using standard Vim directory names like 'plugin'
|
|
||||||
|
|
||||||
" Make sure you use single quotes
|
|
||||||
|
|
||||||
" Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
Plug 'junegunn/seoul256.vim'
|
||||||
|
Plug 'junegunn/vim-easy-align'
|
||||||
|
Plug 'scrooloose/nerdtree', { 'on': 'NERDTreeToggle' }
|
||||||
|
" Plug 'user/repo1', 'branch_or_tag'
|
||||||
|
" Plug 'user/repo2', { 'rtp': 'vim/plugin/dir', 'branch': 'devel' }
|
||||||
|
" Plug 'git@github.com:junegunn/vim-github-dashboard.git'
|
||||||
|
" ...
|
||||||
|
|
||||||
" Any valid git URL is allowed
|
|
||||||
Plug 'https://github.com/junegunn/vim-easy-align.git'
|
|
||||||
|
|
||||||
" Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
|
|
||||||
Plug 'fatih/vim-go', { 'tag': '*' }
|
|
||||||
|
|
||||||
" Using a non-default branch
|
|
||||||
Plug 'neoclide/coc.nvim', { 'branch': 'release' }
|
|
||||||
|
|
||||||
" Use 'dir' option to install plugin in a non-default directory
|
|
||||||
Plug 'junegunn/fzf', { 'dir': '~/.fzf' }
|
|
||||||
|
|
||||||
" Post-update hook: run a shell command after installing or updating the plugin
|
|
||||||
Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
|
|
||||||
|
|
||||||
" Post-update hook can be a lambda expression
|
|
||||||
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
|
|
||||||
|
|
||||||
" If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
|
|
||||||
Plug 'nsf/gocode', { 'rtp': 'vim' }
|
|
||||||
|
|
||||||
" On-demand loading: loaded when the specified command is executed
|
|
||||||
Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
|
|
||||||
|
|
||||||
" On-demand loading: loaded when a file with a specific file type is opened
|
|
||||||
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
|
|
||||||
|
|
||||||
" Unmanaged plugin (manually installed and updated)
|
|
||||||
Plug '~/my-prototype-plugin'
|
|
||||||
|
|
||||||
" Call plug#end to update &runtimepath and initialize the plugin system.
|
|
||||||
" - It automatically executes `filetype plugin indent on` and `syntax enable`
|
|
||||||
call plug#end()
|
call plug#end()
|
||||||
" You can revert the settings after the call like so:
|
|
||||||
" filetype indent off " Disable file-type-specific indentation
|
|
||||||
" syntax off " Disable syntax highlighting
|
|
||||||
|
|
||||||
" Color schemes should be loaded after plug#end().
|
|
||||||
" We prepend it with 'silent!' to ignore errors when it's not yet installed.
|
|
||||||
silent! colorscheme seoul256
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Lua example for Neovim
|
Reload .vimrc and `:PlugInstall` to install plugins.
|
||||||
|
|
||||||
In Neovim, you can write your configuration in a Lua script file named
|
### Plugin directory
|
||||||
`init.lua`. The following code is the Lua script equivalent to the Vim script
|
|
||||||
example above.
|
|
||||||
|
|
||||||
```lua
|
If you omit the path argument to `plug#begin()`, plugins are installed in
|
||||||
local vim = vim
|
`plugged` directory under the first path in `runtimepath` at the point when
|
||||||
local Plug = vim.fn['plug#']
|
`plug#begin()` is called. This is usually `~/.vim/plugged` (or
|
||||||
|
`$HOME/vimfiles/plugged` on Windows) given that you didn't touch runtimepath
|
||||||
|
before the call.
|
||||||
|
|
||||||
vim.call('plug#begin')
|
### Commands
|
||||||
|
|
||||||
-- Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
|
|
||||||
Plug('junegunn/seoul256.vim')
|
|
||||||
|
|
||||||
-- Any valid git URL is allowed
|
|
||||||
Plug('https://github.com/junegunn/vim-easy-align.git')
|
|
||||||
|
|
||||||
-- Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
|
|
||||||
Plug('fatih/vim-go', { ['tag'] = '*' })
|
|
||||||
|
|
||||||
-- Using a non-default branch
|
|
||||||
Plug('neoclide/coc.nvim', { ['branch'] = 'release' })
|
|
||||||
|
|
||||||
-- Use 'dir' option to install plugin in a non-default directory
|
|
||||||
Plug('junegunn/fzf', { ['dir'] = '~/.fzf' })
|
|
||||||
|
|
||||||
-- Post-update hook: run a shell command after installing or updating the plugin
|
|
||||||
Plug('junegunn/fzf', { ['dir'] = '~/.fzf', ['do'] = './install --all' })
|
|
||||||
|
|
||||||
-- Post-update hook can be a lambda expression
|
|
||||||
Plug('junegunn/fzf', { ['do'] = function()
|
|
||||||
vim.fn['fzf#install']()
|
|
||||||
end })
|
|
||||||
|
|
||||||
-- If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
|
|
||||||
Plug('nsf/gocode', { ['rtp'] = 'vim' })
|
|
||||||
|
|
||||||
-- On-demand loading: loaded when the specified command is executed
|
|
||||||
Plug('preservim/nerdtree', { ['on'] = 'NERDTreeToggle' })
|
|
||||||
|
|
||||||
-- On-demand loading: loaded when a file with a specific file type is opened
|
|
||||||
Plug('tpope/vim-fireplace', { ['for'] = 'clojure' })
|
|
||||||
|
|
||||||
-- Unmanaged plugin (manually installed and updated)
|
|
||||||
Plug('~/my-prototype-plugin')
|
|
||||||
|
|
||||||
vim.call('plug#end')
|
|
||||||
|
|
||||||
-- Color schemes should be loaded after plug#end().
|
|
||||||
-- We prepend it with 'silent!' to ignore errors when it's not yet installed.
|
|
||||||
vim.cmd('silent! colorscheme seoul256')
|
|
||||||
```
|
|
||||||
|
|
||||||
## Commands
|
|
||||||
|
|
||||||
| Command | Description |
|
| Command | Description |
|
||||||
| ----------------------------------- | ------------------------------------------------------------------ |
|
| ---------------------- | ------------------------------------------------------------------ |
|
||||||
| `PlugInstall [name ...] [#threads]` | Install plugins |
|
| PlugInstall [#threads] | Install plugins |
|
||||||
| `PlugUpdate [name ...] [#threads]` | Install or update plugins |
|
| PlugUpdate [#threads] | Install or update plugins |
|
||||||
| `PlugClean[!]` | Remove unlisted plugins (bang version will clean without prompt) |
|
| PlugClean[!] | Remove unused directories (bang version will clean without prompt) |
|
||||||
| `PlugUpgrade` | Upgrade vim-plug itself |
|
| PlugUpgrade | Upgrade vim-plug itself |
|
||||||
| `PlugStatus` | Check the status of plugins |
|
| PlugStatus | Check the status of plugins |
|
||||||
| `PlugDiff` | Examine changes from the previous update and the pending changes |
|
|
||||||
| `PlugSnapshot[!] [output path]` | Generate script for restoring the current snapshot of the plugins |
|
|
||||||
|
|
||||||
## `Plug` options
|
### Options for parallel installer
|
||||||
|
|
||||||
| Option | Description |
|
|
||||||
| ----------------------- | ----------------------------------------------------------- |
|
|
||||||
| `branch`/`tag`/`commit` | Branch/tag/commit of the repository to use |
|
|
||||||
| `rtp` | Subdirectory that contains Vim plugin |
|
|
||||||
| `dir` | Custom directory for the plugin |
|
|
||||||
| `as` | Use different name for the plugin |
|
|
||||||
| `do` | Post-update hook (string or funcref) |
|
|
||||||
| `on` | On-demand loading: Commands or `<Plug>`-mappings |
|
|
||||||
| `for` | On-demand loading: File types |
|
|
||||||
| `frozen` | Do not remove and do not update unless explicitly specified |
|
|
||||||
|
|
||||||
## Global options
|
|
||||||
|
|
||||||
| Flag | Default | Description |
|
| Flag | Default | Description |
|
||||||
| ------------------- | --------------------------------- | ------------------------------------------------------ |
|
| ---------------- | ------- | --------------------------------- |
|
||||||
| `g:plug_threads` | 16 | Default number of threads to use |
|
| `g:plug_threads` | 16 | Default number of threads to use |
|
||||||
| `g:plug_timeout` | 60 | Time limit of each task in seconds (*Ruby & Python*) |
|
| `g:plug_timeout` | 60 | Time limit of each task in seconds |
|
||||||
| `g:plug_retries` | 2 | Number of retries in case of timeout (*Ruby & Python*) |
|
|
||||||
| `g:plug_shallow` | 1 | Use shallow clone |
|
|
||||||
| `g:plug_window` | `-tabnew` | Command to open plug window |
|
|
||||||
| `g:plug_pwindow` | `vertical rightbelow new` | Command to open preview window in `PlugDiff` |
|
|
||||||
| `g:plug_url_format` | `https://git::@github.com/%s.git` | `printf` format to build repo URL (Only applies to the subsequent `Plug` commands) |
|
|
||||||
|
|
||||||
|
### Example: A small [sensible](https://github.com/tpope/vim-sensible) Vim configuration
|
||||||
## Keybindings
|
|
||||||
|
|
||||||
- `D` - `PlugDiff`
|
|
||||||
- `S` - `PlugStatus`
|
|
||||||
- `R` - Retry failed update or installation tasks
|
|
||||||
- `U` - Update plugins in the selected range
|
|
||||||
- `q` - Abort the running tasks or close the window
|
|
||||||
- `:PlugStatus`
|
|
||||||
- `L` - Load plugin
|
|
||||||
- `:PlugDiff`
|
|
||||||
- `X` - Revert the update
|
|
||||||
|
|
||||||
## Post-update hooks
|
|
||||||
|
|
||||||
There are some plugins that require extra steps after installation or update.
|
|
||||||
In that case, use the `do` option to describe the task to be performed.
|
|
||||||
|
|
||||||
```vim
|
```vim
|
||||||
Plug 'Shougo/vimproc.vim', { 'do': 'make' }
|
call plug#begin()
|
||||||
Plug 'ycm-core/YouCompleteMe', { 'do': './install.py' }
|
Plug 'tpope/vim-sensible'
|
||||||
|
call plug#end()
|
||||||
```
|
```
|
||||||
|
|
||||||
If the value starts with `:`, it will be recognized as a Vim command.
|
### On-demand loading of plugins
|
||||||
|
|
||||||
```vim
|
|
||||||
Plug 'fatih/vim-go', { 'do': ':GoInstallBinaries' }
|
|
||||||
```
|
|
||||||
|
|
||||||
To call a Vim function, you can pass a lambda expression like so:
|
|
||||||
|
|
||||||
```vim
|
|
||||||
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
|
|
||||||
```
|
|
||||||
|
|
||||||
If you need more control, you can pass a reference to a Vim function that
|
|
||||||
takes a dictionary argument.
|
|
||||||
|
|
||||||
```vim
|
|
||||||
function! BuildYCM(info)
|
|
||||||
" info is a dictionary with 3 fields
|
|
||||||
" - name: name of the plugin
|
|
||||||
" - status: 'installed', 'updated', or 'unchanged'
|
|
||||||
" - force: set on PlugInstall! or PlugUpdate!
|
|
||||||
if a:info.status == 'installed' || a:info.force
|
|
||||||
!./install.py
|
|
||||||
endif
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
Plug 'ycm-core/YouCompleteMe', { 'do': function('BuildYCM') }
|
|
||||||
```
|
|
||||||
|
|
||||||
A post-update hook is executed inside the directory of the plugin and only run
|
|
||||||
when the repository has changed, but you can force it to run unconditionally
|
|
||||||
with the bang-versions of the commands: `PlugInstall!` and `PlugUpdate!`.
|
|
||||||
|
|
||||||
> [!TIP]
|
|
||||||
> Make sure to escape BARs and double-quotes when you write the `do` option
|
|
||||||
> inline as they are mistakenly recognized as command separator or the start of
|
|
||||||
> the trailing comment.
|
|
||||||
>
|
|
||||||
> ```vim
|
|
||||||
> Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }
|
|
||||||
> ```
|
|
||||||
>
|
|
||||||
> But you can avoid the escaping if you extract the inline specification using a
|
|
||||||
> variable (or any Vim script expression) as follows:
|
|
||||||
>
|
|
||||||
> ```vim
|
|
||||||
> let g:fzf_install = 'yes | ./install'
|
|
||||||
> Plug 'junegunn/fzf', { 'do': g:fzf_install }
|
|
||||||
> ```
|
|
||||||
|
|
||||||
### `PlugInstall!` and `PlugUpdate!`
|
|
||||||
|
|
||||||
The installer takes the following steps when installing/updating a plugin:
|
|
||||||
|
|
||||||
1. `git clone` or `git fetch` from its origin
|
|
||||||
2. Check out branch, tag, or commit and optionally `git merge` remote branch
|
|
||||||
3. If the plugin was updated (or installed for the first time)
|
|
||||||
1. Update submodules
|
|
||||||
2. Execute post-update hooks
|
|
||||||
|
|
||||||
The commands with the `!` suffix ensure that all steps are run unconditionally.
|
|
||||||
|
|
||||||
## On-demand loading of plugins
|
|
||||||
|
|
||||||
```vim
|
```vim
|
||||||
" NERD tree will be loaded on the first invocation of NERDTreeToggle command
|
" NERD tree will be loaded on the first invocation of NERDTreeToggle command
|
||||||
Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
|
Plug 'scrooloose/nerdtree', { 'on': 'NERDTreeToggle' }
|
||||||
|
|
||||||
" Multiple commands
|
" Multiple commands
|
||||||
Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
|
Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
|
||||||
|
|
||||||
" Loaded when clojure file is opened
|
|
||||||
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
|
|
||||||
|
|
||||||
" Multiple file types
|
|
||||||
Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
|
|
||||||
|
|
||||||
" On-demand loading on both conditions
|
|
||||||
Plug 'junegunn/vader.vim', { 'on': 'Vader', 'for': 'vader' }
|
|
||||||
|
|
||||||
" Code to execute when the plugin is lazily loaded on demand
|
|
||||||
Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
|
|
||||||
autocmd! User goyo.vim echom 'Goyo is now loaded!'
|
|
||||||
```
|
```
|
||||||
|
|
||||||
> [!NOTE]
|
### Dependency resolution
|
||||||
> #### Should I set up on-demand loading?
|
|
||||||
>
|
|
||||||
> You probably don't need to.
|
|
||||||
>
|
|
||||||
> A properly implemented Vim plugin should already load lazily without any
|
|
||||||
> help from a plugin manager (`:help autoload`). So there are few cases where
|
|
||||||
> these options actually make much sense. Making a plugin load faster is
|
|
||||||
> the responsibility of the plugin developer, not the user. If you find
|
|
||||||
> a plugin that takes too long to load, consider opening an issue on the
|
|
||||||
> plugin's issue tracker.
|
|
||||||
>
|
|
||||||
> Let me give you a perspective. The time it takes to load a plugin is usually
|
|
||||||
> less than 2 or 3ms on modern computers. So unless you use a very large
|
|
||||||
> number of plugins, you are unlikely to save more than 50ms. If you have
|
|
||||||
> spent an hour carefully setting up the options to shave off 50ms, you
|
|
||||||
> will have to start Vim 72,000 times just to break even. You should ask
|
|
||||||
> yourself if that's a good investment of your time.
|
|
||||||
>
|
|
||||||
> Make sure that you're tackling the right problem by breaking down the
|
|
||||||
> startup time of Vim using `--startuptime`.
|
|
||||||
>
|
|
||||||
> ```sh
|
|
||||||
> vim --startuptime /tmp/log
|
|
||||||
> ```
|
|
||||||
>
|
|
||||||
> On-demand loading should only be used as a last resort. It is basically
|
|
||||||
> a hacky workaround and is not always guaranteed to work.
|
|
||||||
|
|
||||||
> [!TIP]
|
See [Dependency
|
||||||
> You can pass an empty list to `on` or `for` option to disable the loading
|
Resolution](https://github.com/junegunn/vim-plug/wiki/Dependency-Resolution).
|
||||||
> of the plugin. You can manually load the plugin using `plug#load(NAMES...)`
|
|
||||||
> function.
|
|
||||||
>
|
|
||||||
> See https://github.com/junegunn/vim-plug/wiki/tips#loading-plugins-manually
|
|
||||||
|
|
||||||
|
### Articles
|
||||||
|
|
||||||
## Collaborators
|
- [Writing my own Vim plugin manager](http://junegunn.kr/2013/09/writing-my-own-vim-plugin-manager)
|
||||||
|
- [Thoughts on Vim plugin dependency](http://junegunn.kr/2013/09/thoughts-on-vim-plugin-dependency)
|
||||||
|
|
||||||
- [Jan Edmund Lazo](https://github.com/janlazo) - Windows support
|
### FAQ/Troubleshooting
|
||||||
- [Jeremy Pallats](https://github.com/starcraftman) - Python installer
|
|
||||||
|
|
||||||
## License
|
#### Plugins are not installed/updated in parallel
|
||||||
|
|
||||||
|
Your Vim does not support Ruby interface. `:echo has('ruby')` should print 1.
|
||||||
|
In order to setup Vim with Ruby support, you may refer to [this
|
||||||
|
article](http://junegunn.kr/2013/09/installing-vim-with-ruby-support).
|
||||||
|
|
||||||
|
#### *Vim: Caught deadly signal SEGV*
|
||||||
|
|
||||||
|
If your Vim crashes with the above message, first check if its Ruby interface is
|
||||||
|
working correctly with the following command:
|
||||||
|
|
||||||
|
```vim
|
||||||
|
:ruby puts RUBY_VERSION
|
||||||
|
```
|
||||||
|
|
||||||
|
If Vim crashes even with this command, it is likely that Ruby interface is
|
||||||
|
broken, and you have to rebuild Vim with a working version of Ruby.
|
||||||
|
(`brew remove vim && brew install vim` or `./configure && make ...`)
|
||||||
|
|
||||||
|
If you're on OS X, one possibility is that you had installed Vim with
|
||||||
|
[Homebrew](http://brew.sh/) while using a Ruby installed with
|
||||||
|
[RVM](http://rvm.io/) or [rbenv](https://github.com/sstephenson/rbenv) and later
|
||||||
|
removed that version of Ruby.
|
||||||
|
|
||||||
|
[Please let me know](https://github.com/junegunn/vim-plug/issues) if you can't
|
||||||
|
resolve the problem. In the meantime, you can set `g:plug_threads` to 1, so that
|
||||||
|
Ruby installer is not used at all.
|
||||||
|
|
||||||
|
#### Freezing plugin version with commit hash
|
||||||
|
|
||||||
|
vim-plug does not allow you to freeze the version of a plugin with its commit
|
||||||
|
hash. This is by design. I don't believe a user of a plugin should be looking
|
||||||
|
at its individual commits. Instead, one should be choosing the right version
|
||||||
|
using release tags or versioned branches (e.g. 1.2.3, stable, devel, etc.)
|
||||||
|
|
||||||
|
```vim
|
||||||
|
Plug 'junegunn/vim-easy-align', '2.9.2'
|
||||||
|
```
|
||||||
|
|
||||||
|
If the repository doesn't come with such tags or branches, you should think of
|
||||||
|
it as "unstable" or "in development", and always use its latest revision.
|
||||||
|
|
||||||
|
If you really must choose a certain untagged revision, consider forking the
|
||||||
|
repository.
|
||||||
|
|
||||||
|
### Regarding feature request
|
||||||
|
|
||||||
|
You may submit a request for a new feature by [creating an
|
||||||
|
issue](https://github.com/junegunn/vim-plug/issues). However, please be minded
|
||||||
|
that this is an opinionated software and I want to keep the feature set as small
|
||||||
|
as possible. So I may not agree with you on the necessity of the suggested
|
||||||
|
feature. If that happens, I suggest the following options.
|
||||||
|
|
||||||
|
1. Check out [Vundle](https://github.com/gmarik/vundle) or
|
||||||
|
[NeoBundle](https://github.com/Shougo/neobundle.vim).
|
||||||
|
They offer broader feature sets.
|
||||||
|
2. Create a fork of this project and let it be your own plugin manager.
|
||||||
|
There's no need for us to have a single canonical branch.
|
||||||
|
|
||||||
MIT
|
|
||||||
|
|
428
doc/plug.txt
|
@ -1,428 +0,0 @@
|
||||||
plug.txt plug Last change: Jun 1 2024
|
|
||||||
PLUG - TABLE OF CONTENTS *plug* *plug-toc*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
vim-plug |vim-plug|
|
|
||||||
Pros. |plug-pros|
|
|
||||||
Installation |plug-installation|
|
|
||||||
Usage |plug-usage|
|
|
||||||
Getting Help |plug-getting-help|
|
|
||||||
Examples |plug-examples|
|
|
||||||
Vim script example |plug-vim-script-example|
|
|
||||||
Lua example for Neovim |plug-lua-example-for-neovim|
|
|
||||||
Commands |plug-commands|
|
|
||||||
Plug options |plug-options|
|
|
||||||
Global options |plug-global-options|
|
|
||||||
Keybindings |plug-keybindings|
|
|
||||||
Post-update hooks |plug-post-update-hooks|
|
|
||||||
PlugInstall! and PlugUpdate! |pluginstall-and-plugupdate|
|
|
||||||
On-demand loading of plugins |plug-on-demand-loading-of-plugins|
|
|
||||||
Collaborators |plug-collaborators|
|
|
||||||
License |plug-license|
|
|
||||||
|
|
||||||
VIM-PLUG *vim-plug*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
A minimalist Vim plugin manager.
|
|
||||||
|
|
||||||
|
|
||||||
PROS. *plug-pros*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
- Minimalist design
|
|
||||||
- Just one file with no dependencies. Super easy to set up.
|
|
||||||
- Concise, intuitive syntax that you can learn within minutes. No
|
|
||||||
boilerplate code required.
|
|
||||||
- No feature bloat
|
|
||||||
- Extremely stable with flawless backward compatibility
|
|
||||||
- Works perfectly with all versions of Vim since 2006 and all versions of
|
|
||||||
Neovim ever released
|
|
||||||
- {Super-fast}{1} parallel installation/update
|
|
||||||
- Creates shallow clones to minimize disk space usage and download time
|
|
||||||
- On-demand loading for {faster startup time}{2}
|
|
||||||
- Can review and rollback updates
|
|
||||||
- Branch/tag/commit support
|
|
||||||
- Post-update hooks
|
|
||||||
- Support for externally managed plugins
|
|
||||||
|
|
||||||
{1} https://raw.githubusercontent.com/junegunn/i/master/vim-plug/40-in-4.gif
|
|
||||||
{2} https://github.com/junegunn/vim-startuptime-benchmark#result
|
|
||||||
|
|
||||||
|
|
||||||
INSTALLATION *plug-installation*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
{Download plug.vim}{3} and put it in the "autoload" directory.
|
|
||||||
|
|
||||||
{3} https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
|
|
||||||
|
|
||||||
|
|
||||||
USAGE *plug-usage*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
Add a vim-plug section to your `~/.vimrc` (or `init.vim` for Neovim)
|
|
||||||
|
|
||||||
*plug#begin* *plug#end*
|
|
||||||
|
|
||||||
1. Begin the section with `call plug#begin()`
|
|
||||||
2. List the plugins with `Plug` commands
|
|
||||||
3. End the section with `call plug#end()`
|
|
||||||
|
|
||||||
For example,
|
|
||||||
>
|
|
||||||
call plug#begin()
|
|
||||||
|
|
||||||
" List your plugins here
|
|
||||||
Plug 'tpope/vim-sensible'
|
|
||||||
|
|
||||||
call plug#end()
|
|
||||||
<
|
|
||||||
Reload the file or restart Vim, then you can,
|
|
||||||
|
|
||||||
*:PlugInstall* *:PlugUpdate* *:PlugDiff*
|
|
||||||
|
|
||||||
- `:PlugInstall` to install the plugins
|
|
||||||
- `:PlugUpdate` to install or update the plugins
|
|
||||||
- `:PlugDiff` to review the changes from the last update
|
|
||||||
|
|
||||||
[!NOTE] That's basically all you need to know to get started. The rest of the
|
|
||||||
document is for advanced users who want to know more about the features and
|
|
||||||
options.
|
|
||||||
|
|
||||||
|
|
||||||
< Getting Help >______________________________________________________________~
|
|
||||||
*plug-getting-help*
|
|
||||||
|
|
||||||
- See {tutorial}{4} page to learn more about the basics of vim-plug
|
|
||||||
- See {tips}{5} and {FAQ}{6} pages for common problems and questions
|
|
||||||
|
|
||||||
{4} https://github.com/junegunn/vim-plug/wiki/tutorial
|
|
||||||
{5} https://github.com/junegunn/vim-plug/wiki/tips
|
|
||||||
{6} https://github.com/junegunn/vim-plug/wiki/faq
|
|
||||||
|
|
||||||
|
|
||||||
EXAMPLES *plug-examples*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
The following examples demonstrate the additional features of vim-plug.
|
|
||||||
|
|
||||||
|
|
||||||
< Vim script example >________________________________________________________~
|
|
||||||
*plug-vim-script-example*
|
|
||||||
>
|
|
||||||
call plug#begin()
|
|
||||||
" The default plugin directory will be as follows:
|
|
||||||
" - Vim (Linux/macOS): '~/.vim/plugged'
|
|
||||||
" - Vim (Windows): '~/vimfiles/plugged'
|
|
||||||
" - Neovim (Linux/macOS/Windows): stdpath('data') . '/plugged'
|
|
||||||
" You can specify a custom plugin directory by passing it as the argument
|
|
||||||
" - e.g. `call plug#begin('~/.vim/plugged')`
|
|
||||||
" - Avoid using standard Vim directory names like 'plugin'
|
|
||||||
|
|
||||||
" Make sure you use single quotes
|
|
||||||
|
|
||||||
" Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
|
|
||||||
" Any valid git URL is allowed
|
|
||||||
Plug 'https://github.com/junegunn/vim-easy-align.git'
|
|
||||||
|
|
||||||
" Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
|
|
||||||
Plug 'fatih/vim-go', { 'tag': '*' }
|
|
||||||
|
|
||||||
" Using a non-default branch
|
|
||||||
Plug 'neoclide/coc.nvim', { 'branch': 'release' }
|
|
||||||
|
|
||||||
" Use 'dir' option to install plugin in a non-default directory
|
|
||||||
Plug 'junegunn/fzf', { 'dir': '~/.fzf' }
|
|
||||||
|
|
||||||
" Post-update hook: run a shell command after installing or updating the plugin
|
|
||||||
Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }
|
|
||||||
|
|
||||||
" Post-update hook can be a lambda expression
|
|
||||||
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
|
|
||||||
|
|
||||||
" If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
|
|
||||||
Plug 'nsf/gocode', { 'rtp': 'vim' }
|
|
||||||
|
|
||||||
" On-demand loading: loaded when the specified command is executed
|
|
||||||
Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
|
|
||||||
|
|
||||||
" On-demand loading: loaded when a file with a specific file type is opened
|
|
||||||
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
|
|
||||||
|
|
||||||
" Unmanaged plugin (manually installed and updated)
|
|
||||||
Plug '~/my-prototype-plugin'
|
|
||||||
|
|
||||||
" Call plug#end to update &runtimepath and initialize the plugin system.
|
|
||||||
" - It automatically executes `filetype plugin indent on` and `syntax enable`
|
|
||||||
call plug#end()
|
|
||||||
" You can revert the settings after the call like so:
|
|
||||||
" filetype indent off " Disable file-type-specific indentation
|
|
||||||
" syntax off " Disable syntax highlighting
|
|
||||||
|
|
||||||
" Color schemes should be loaded after plug#end().
|
|
||||||
" We prepend it with 'silent!' to ignore errors when it's not yet installed.
|
|
||||||
silent! colorscheme seoul256
|
|
||||||
<
|
|
||||||
|
|
||||||
< Lua example for Neovim >____________________________________________________~
|
|
||||||
*plug-lua-example-for-neovim*
|
|
||||||
|
|
||||||
In Neovim, you can write your configuration in a Lua script file named
|
|
||||||
`init.lua`. The following code is the Lua script equivalent to the Vim script
|
|
||||||
example above.
|
|
||||||
>
|
|
||||||
local vim = vim
|
|
||||||
local Plug = vim.fn['plug#']
|
|
||||||
|
|
||||||
vim.call('plug#begin')
|
|
||||||
|
|
||||||
-- Shorthand notation for GitHub; translates to https://github.com/junegunn/seoul256.vim.git
|
|
||||||
Plug('junegunn/seoul256.vim')
|
|
||||||
|
|
||||||
-- Any valid git URL is allowed
|
|
||||||
Plug('https://github.com/junegunn/vim-easy-align.git')
|
|
||||||
|
|
||||||
-- Using a tagged release; wildcard allowed (requires git 1.9.2 or above)
|
|
||||||
Plug('fatih/vim-go', { ['tag'] = '*' })
|
|
||||||
|
|
||||||
-- Using a non-default branch
|
|
||||||
Plug('neoclide/coc.nvim', { ['branch'] = 'release' })
|
|
||||||
|
|
||||||
-- Use 'dir' option to install plugin in a non-default directory
|
|
||||||
Plug('junegunn/fzf', { ['dir'] = '~/.fzf' })
|
|
||||||
|
|
||||||
-- Post-update hook: run a shell command after installing or updating the plugin
|
|
||||||
Plug('junegunn/fzf', { ['dir'] = '~/.fzf', ['do'] = './install --all' })
|
|
||||||
|
|
||||||
-- Post-update hook can be a lambda expression
|
|
||||||
Plug('junegunn/fzf', { ['do'] = function()
|
|
||||||
vim.fn['fzf#install']()
|
|
||||||
end })
|
|
||||||
|
|
||||||
-- If the vim plugin is in a subdirectory, use 'rtp' option to specify its path
|
|
||||||
Plug('nsf/gocode', { ['rtp'] = 'vim' })
|
|
||||||
|
|
||||||
-- On-demand loading: loaded when the specified command is executed
|
|
||||||
Plug('preservim/nerdtree', { ['on'] = 'NERDTreeToggle' })
|
|
||||||
|
|
||||||
-- On-demand loading: loaded when a file with a specific file type is opened
|
|
||||||
Plug('tpope/vim-fireplace', { ['for'] = 'clojure' })
|
|
||||||
|
|
||||||
-- Unmanaged plugin (manually installed and updated)
|
|
||||||
Plug('~/my-prototype-plugin')
|
|
||||||
|
|
||||||
vim.call('plug#end')
|
|
||||||
|
|
||||||
-- Color schemes should be loaded after plug#end().
|
|
||||||
-- We prepend it with 'silent!' to ignore errors when it's not yet installed.
|
|
||||||
vim.cmd('silent! colorscheme seoul256')
|
|
||||||
<
|
|
||||||
|
|
||||||
COMMANDS *plug-commands*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
-------------------------------------+------------------------------------------------------------------
|
|
||||||
Command | Description ~
|
|
||||||
-------------------------------------+------------------------------------------------------------------
|
|
||||||
`PlugInstall [name ...] [#threads]` | Install plugins
|
|
||||||
`PlugUpdate [name ...] [#threads]` | Install or update plugins
|
|
||||||
`PlugClean[!]` | Remove unlisted plugins (bang version will clean without prompt)
|
|
||||||
`PlugUpgrade` | Upgrade vim-plug itself
|
|
||||||
`PlugStatus` | Check the status of plugins
|
|
||||||
`PlugDiff` | Examine changes from the previous update and the pending changes
|
|
||||||
`PlugSnapshot[!] [output path]` | Generate script for restoring the current snapshot of the plugins
|
|
||||||
-------------------------------------+------------------------------------------------------------------
|
|
||||||
|
|
||||||
|
|
||||||
PLUG OPTIONS *plug-options*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
*<Plug>-mappings*
|
|
||||||
|
|
||||||
------------------------+------------------------------------------------------------
|
|
||||||
Option | Description ~
|
|
||||||
------------------------+------------------------------------------------------------
|
|
||||||
`branch` / `tag` / `commit` | Branch/tag/commit of the repository to use
|
|
||||||
`rtp` | Subdirectory that contains Vim plugin
|
|
||||||
`dir` | Custom directory for the plugin
|
|
||||||
`as` | Use different name for the plugin
|
|
||||||
`do` | Post-update hook (string or funcref)
|
|
||||||
`on` | On-demand loading: Commands or <Plug>-mappings
|
|
||||||
`for` | On-demand loading: File types
|
|
||||||
`frozen` | Do not remove and do not update unless explicitly specified
|
|
||||||
------------------------+------------------------------------------------------------
|
|
||||||
|
|
||||||
|
|
||||||
GLOBAL OPTIONS *plug-global-options*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
*g:plug_threads* *g:plug_timeout* *g:plug_retries* *g:plug_shallow* *g:plug_window*
|
|
||||||
*g:plug_pwindow* *g:plug_url_format*
|
|
||||||
|
|
||||||
--------------------+-----------------------------------+-----------------------------------------------------------------------------------
|
|
||||||
Flag | Default | Description ~
|
|
||||||
--------------------+-----------------------------------+-----------------------------------------------------------------------------------
|
|
||||||
`g:plug_threads` | 16 | Default number of threads to use
|
|
||||||
`g:plug_timeout` | 60 | Time limit of each task in seconds (Ruby & Python)
|
|
||||||
`g:plug_retries` | 2 | Number of retries in case of timeout (Ruby & Python)
|
|
||||||
`g:plug_shallow` | 1 | Use shallow clone
|
|
||||||
`g:plug_window` | `-tabnew` | Command to open plug window
|
|
||||||
`g:plug_pwindow` | `vertical rightbelow new` | Command to open preview window in `PlugDiff`
|
|
||||||
`g:plug_url_format` | `https://git::@github.com/%s.git` | `printf` format to build repo URL (Only applies to the subsequent `Plug` commands)
|
|
||||||
--------------------+-----------------------------------+-----------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
|
|
||||||
KEYBINDINGS *plug-keybindings*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
- `D` - `PlugDiff`
|
|
||||||
- `S` - `PlugStatus`
|
|
||||||
- `R` - Retry failed update or installation tasks
|
|
||||||
- `U` - Update plugins in the selected range
|
|
||||||
- `q` - Close the window
|
|
||||||
- `:PlugStatus`
|
|
||||||
- `L` - Load plugin
|
|
||||||
- `:PlugDiff`
|
|
||||||
- `X` - Revert the update
|
|
||||||
|
|
||||||
|
|
||||||
POST-UPDATE HOOKS *plug-post-update-hooks*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
There are some plugins that require extra steps after installation or update.
|
|
||||||
In that case, use the `do` option to describe the task to be performed.
|
|
||||||
>
|
|
||||||
Plug 'Shougo/vimproc.vim', { 'do': 'make' }
|
|
||||||
Plug 'ycm-core/YouCompleteMe', { 'do': './install.py' }
|
|
||||||
<
|
|
||||||
If the value starts with `:`, it will be recognized as a Vim command.
|
|
||||||
>
|
|
||||||
Plug 'fatih/vim-go', { 'do': ':GoInstallBinaries' }
|
|
||||||
<
|
|
||||||
To call a Vim function, you can pass a lambda expression like so:
|
|
||||||
>
|
|
||||||
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
|
|
||||||
<
|
|
||||||
If you need more control, you can pass a reference to a Vim function that
|
|
||||||
takes a dictionary argument.
|
|
||||||
>
|
|
||||||
function! BuildYCM(info)
|
|
||||||
" info is a dictionary with 3 fields
|
|
||||||
" - name: name of the plugin
|
|
||||||
" - status: 'installed', 'updated', or 'unchanged'
|
|
||||||
" - force: set on PlugInstall! or PlugUpdate!
|
|
||||||
if a:info.status == 'installed' || a:info.force
|
|
||||||
!./install.py
|
|
||||||
endif
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
Plug 'ycm-core/YouCompleteMe', { 'do': function('BuildYCM') }
|
|
||||||
<
|
|
||||||
A post-update hook is executed inside the directory of the plugin and only run
|
|
||||||
when the repository has changed, but you can force it to run unconditionally
|
|
||||||
with the bang-versions of the commands: `PlugInstall!` and `PlugUpdate!`.
|
|
||||||
|
|
||||||
[!TIP] Make sure to escape BARs and double-quotes when you write the `do`
|
|
||||||
option inline as they are mistakenly recognized as command separator or the
|
|
||||||
start of the trailing comment.
|
|
||||||
>
|
|
||||||
Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }
|
|
||||||
<
|
|
||||||
But you can avoid the escaping if you extract the inline specification using a
|
|
||||||
variable (or any Vim script expression) as follows:
|
|
||||||
>
|
|
||||||
let g:fzf_install = 'yes | ./install'
|
|
||||||
Plug 'junegunn/fzf', { 'do': g:fzf_install }
|
|
||||||
<
|
|
||||||
|
|
||||||
< PlugInstall! and PlugUpdate! >______________________________________________~
|
|
||||||
*pluginstall-and-plugupdate*
|
|
||||||
|
|
||||||
The installer takes the following steps when installing/updating a plugin:
|
|
||||||
|
|
||||||
1. `git clone` or `git fetch` from its origin
|
|
||||||
2. Check out branch, tag, or commit and optionally `git merge` remote branch
|
|
||||||
3. If the plugin was updated (or installed for the first time)
|
|
||||||
1. Update submodules
|
|
||||||
2. Execute post-update hooks
|
|
||||||
|
|
||||||
The commands with the `!` suffix ensure that all steps are run
|
|
||||||
unconditionally.
|
|
||||||
|
|
||||||
|
|
||||||
ON-DEMAND LOADING OF PLUGINS *plug-on-demand-loading-of-plugins*
|
|
||||||
==============================================================================
|
|
||||||
>
|
|
||||||
" NERD tree will be loaded on the first invocation of NERDTreeToggle command
|
|
||||||
Plug 'preservim/nerdtree', { 'on': 'NERDTreeToggle' }
|
|
||||||
|
|
||||||
" Multiple commands
|
|
||||||
Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }
|
|
||||||
|
|
||||||
" Loaded when clojure file is opened
|
|
||||||
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }
|
|
||||||
|
|
||||||
" Multiple file types
|
|
||||||
Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }
|
|
||||||
|
|
||||||
" On-demand loading on both conditions
|
|
||||||
Plug 'junegunn/vader.vim', { 'on': 'Vader', 'for': 'vader' }
|
|
||||||
|
|
||||||
" Code to execute when the plugin is lazily loaded on demand
|
|
||||||
Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
|
|
||||||
autocmd! User goyo.vim echom 'Goyo is now loaded!'
|
|
||||||
<
|
|
||||||
[!NOTE] #### Should I set up on-demand loading?
|
|
||||||
|
|
||||||
You probably don't need to.
|
|
||||||
|
|
||||||
A properly implemented Vim plugin should already load lazily without any help
|
|
||||||
from a plugin manager (`:help autoload`). So there are few cases where these
|
|
||||||
options actually make much sense. Making a plugin load faster is the
|
|
||||||
responsibility of the plugin developer, not the user. If you find a plugin
|
|
||||||
that takes too long to load, consider opening an issue on the plugin's issue
|
|
||||||
tracker.
|
|
||||||
|
|
||||||
Let me give you a perspective. The time it takes to load a plugin is usually
|
|
||||||
less than 2 or 3ms on modern computers. So unless you use a very large number
|
|
||||||
of plugins, you are unlikely to save more than 50ms. If you have spent an hour
|
|
||||||
carefully setting up the options to shave off 50ms, you will have to start Vim
|
|
||||||
72,000 times just to break even. You should ask yourself if that's a good
|
|
||||||
investment of your time.
|
|
||||||
|
|
||||||
Make sure that you're tackling the right problem by breaking down the startup
|
|
||||||
time of Vim using `--startuptime`.
|
|
||||||
>
|
|
||||||
vim --startuptime /tmp/log
|
|
||||||
<
|
|
||||||
On-demand loading should only be used as a last resort. It is basically a
|
|
||||||
hacky workaround and is not always guaranteed to work.
|
|
||||||
|
|
||||||
*plug#load*
|
|
||||||
|
|
||||||
[!TIP] You can pass an empty list to `on` or `for` option to disable the
|
|
||||||
loading of the plugin. You can manually load the plugin using
|
|
||||||
`plug#load(NAMES...)` function.
|
|
||||||
|
|
||||||
See https://github.com/junegunn/vim-plug/wiki/tips#loading-plugins-manually
|
|
||||||
|
|
||||||
|
|
||||||
COLLABORATORS *plug-collaborators*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
- {Jan Edmund Lazo}{7} - Windows support
|
|
||||||
- {Jeremy Pallats}{8} - Python installer
|
|
||||||
|
|
||||||
{7} https://github.com/janlazo
|
|
||||||
{8} https://github.com/starcraftman
|
|
||||||
|
|
||||||
|
|
||||||
LICENSE *plug-license*
|
|
||||||
==============================================================================
|
|
||||||
|
|
||||||
MIT
|
|
||||||
|
|
||||||
==============================================================================
|
|
||||||
vim:tw=78:sw=2:ts=2:ft=help:norl:nowrap:
|
|
BIN
gif/Plugfile.gif
Normal file
After Width: | Height: | Size: 528 KiB |
BIN
gif/parallel.gif
Normal file
After Width: | Height: | Size: 306 KiB |
BIN
gif/pi.gif
Normal file
After Width: | Height: | Size: 922 KiB |
BIN
gif/pu.gif
Normal file
After Width: | Height: | Size: 247 KiB |
BIN
gif/serial.gif
Normal file
After Width: | Height: | Size: 650 KiB |
BIN
gif/si.gif
Normal file
After Width: | Height: | Size: 1.1 MiB |
BIN
gif/su.gif
Normal file
After Width: | Height: | Size: 521 KiB |
BIN
gif/vim-plug.gif
Normal file
After Width: | Height: | Size: 2.3 MiB |
BIN
plug-dark.png
Before Width: | Height: | Size: 26 KiB |
BIN
plug.png
Before Width: | Height: | Size: 23 KiB After Width: | Height: | Size: 5.0 KiB |
|
@ -7,10 +7,8 @@ Test cases for vim-plug
|
||||||
|
|
||||||
### Run
|
### Run
|
||||||
|
|
||||||
```
|
```vim
|
||||||
./run
|
:e workflow.vader | Vader
|
||||||
|
|
||||||
./run !
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### TODO
|
### TODO
|
||||||
|
@ -20,6 +18,7 @@ Test cases for the following features are currently missing:
|
||||||
- Output formatting
|
- Output formatting
|
||||||
- Timeout or interrupt cleaning up git processes
|
- Timeout or interrupt cleaning up git processes
|
||||||
- User prompt in PlugClean command
|
- User prompt in PlugClean command
|
||||||
|
- Automatic dependency resolution using Plugfile
|
||||||
- Single-threaded installer
|
- Single-threaded installer
|
||||||
- Windows support
|
- Windows support
|
||||||
|
|
||||||
|
|
|
@ -1,41 +0,0 @@
|
||||||
Execute (plug#shellescape() works without optional arguments):
|
|
||||||
if has('unix')
|
|
||||||
AssertEqual "''", plug#shellescape("")
|
|
||||||
AssertEqual "'foo'\\'''", plug#shellescape("foo'")
|
|
||||||
endif
|
|
||||||
|
|
||||||
Execute (plug#shellescape() ignores invalid optional argument):
|
|
||||||
if has('unix')
|
|
||||||
AssertEqual "''", plug#shellescape("", '')
|
|
||||||
AssertEqual "'foo'\\'''", plug#shellescape("foo'", [])
|
|
||||||
endif
|
|
||||||
|
|
||||||
Execute (plug#shellescape() depends on the shell):
|
|
||||||
AssertEqual "'foo'\\'''", plug#shellescape("foo'", {'shell': 'sh'})
|
|
||||||
AssertEqual '^"foo''^"', plug#shellescape("foo'", {'shell': 'cmd.exe'})
|
|
||||||
AssertEqual "'foo'''", plug#shellescape("foo'", {'shell': 'powershell'})
|
|
||||||
AssertEqual "'foo'''", plug#shellescape("foo'", {'shell': 'powershell.exe'})
|
|
||||||
AssertEqual "'foo'''", plug#shellescape("foo'", {'shell': 'pwsh'})
|
|
||||||
|
|
||||||
Execute (plug#shellescape() supports non-trivial cmd.exe escaping):
|
|
||||||
" batchfile
|
|
||||||
AssertEqual '^"^^%%PATH^^%%^"', plug#shellescape("^%PATH^%", {
|
|
||||||
\ 'shell': 'cmd.exe',
|
|
||||||
\ })
|
|
||||||
AssertEqual '^"^^%%PATH^^%%^"', plug#shellescape("^%PATH^%", {
|
|
||||||
\ 'shell': 'cmd.exe',
|
|
||||||
\ 'script': 1,
|
|
||||||
\ })
|
|
||||||
" command prompt
|
|
||||||
AssertEqual '^"^^^%PATH^^^%^"', plug#shellescape("^%PATH^%", {
|
|
||||||
\ 'shell': 'cmd.exe',
|
|
||||||
\ 'script': 0,
|
|
||||||
\ }),
|
|
||||||
|
|
||||||
Execute (plug#shellescape() supports non-trivial powershell.exe escaping):
|
|
||||||
AssertEqual '''\"Foo\\''''\\Bar\"''', plug#shellescape('"Foo\''\Bar"', {
|
|
||||||
\ 'shell': 'powershell',
|
|
||||||
\ }),
|
|
||||||
AssertEqual '''\"Foo\\''''\\Bar\"''', plug#shellescape('"Foo\''\Bar"', {
|
|
||||||
\ 'shell': 'powershell.exe',
|
|
||||||
\ }),
|
|
|
@ -1,375 +0,0 @@
|
||||||
**********************************************************************
|
|
||||||
Execute (#112 On-demand loading should not suppress messages from ftplugin):
|
|
||||||
call ResetPlug()
|
|
||||||
call plug#begin('$PLUG_FIXTURES')
|
|
||||||
Plug '$PLUG_FIXTURES/ftplugin-msg', { 'for': 'c' }
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
redir => out
|
|
||||||
tabnew a.c
|
|
||||||
redir END
|
|
||||||
Assert stridx(out, 'ftplugin-c') >= 0, 'Unexpected output (1): '.out
|
|
||||||
|
|
||||||
* The same applies to plug#load())
|
|
||||||
call ResetPlug()
|
|
||||||
redir => out
|
|
||||||
call plug#load('ftplugin-msg')
|
|
||||||
redir END
|
|
||||||
Assert stridx(out, 'ftplugin-c') >= 0, 'Unexpected output (2): '.out
|
|
||||||
q
|
|
||||||
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#114 Should not contain empty path in &rtp):
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
Log &rtp
|
|
||||||
Assert &rtp !~ ',,', 'Commas'
|
|
||||||
Assert &rtp !~ '^,', 'Comma prefix'
|
|
||||||
Assert &rtp !~ ',$', 'Comma suffix'
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#130 Proper cleanup of on-demand loading triggers):
|
|
||||||
augroup PlugLOD
|
|
||||||
autocmd!
|
|
||||||
augroup END
|
|
||||||
|
|
||||||
" Cleared on command
|
|
||||||
call ReloadPlug()
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-emoji', { 'on': ['EmojiCommand', 'EmojiCommand2', '<Plug>(EmojiMapping)'] }
|
|
||||||
call plug#end()
|
|
||||||
PlugInstall | q
|
|
||||||
call mkdir(g:plugs['vim-emoji'].dir.'/after/plugin', 'p')
|
|
||||||
|
|
||||||
Assert exists(':EmojiCommand'), 'EmojiCommand not defined'
|
|
||||||
Assert exists(':EmojiCommand2'), 'EmojiCommand2 not defined'
|
|
||||||
Assert !empty(mapcheck('<Plug>(EmojiMapping)')), '<Plug>(EmojiMapping) not defined'
|
|
||||||
|
|
||||||
silent! EmojiCommand
|
|
||||||
|
|
||||||
Assert !exists(':EmojiCommand'), 'EmojiCommand defined'
|
|
||||||
Assert !exists(':EmojiCommand2'), 'EmojiCommand2 defined'
|
|
||||||
Assert empty(mapcheck('<Plug>(EmojiMapping)')), '<Plug>(EmojiMapping) defined'
|
|
||||||
|
|
||||||
" Cleared on FileType
|
|
||||||
call ReloadPlug()
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-emoji', { 'on': ['EmojiCommandExtra', '<Plug>(EmojiMappingExtra)'], 'for': ['emoji'] }
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
Assert exists(':EmojiCommandExtra'), 'EmojiCommandExtra not defined'
|
|
||||||
Assert !empty(mapcheck('<Plug>(EmojiMappingExtra)')), '<Plug>(EmojiMappingExtra) not defined'
|
|
||||||
|
|
||||||
setf emoji
|
|
||||||
|
|
||||||
Assert !exists(':EmojiCommandExtra'), 'EmojiCommandExtra defined'
|
|
||||||
Assert empty(mapcheck('<Plug>(EmojiMappingExtra)')), '<Plug>(EmojiMappingExtra) defined'
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#131 Syntax error):
|
|
||||||
call plug#begin('/proc/no-permission')
|
|
||||||
Plug 'junegunn/vim-emoji'
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
redir => out
|
|
||||||
silent PlugInstall
|
|
||||||
redir END
|
|
||||||
Assert out =~ 'Invalid plug directory: /proc/no-permission', out
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#139-1 Using new remote branch):
|
|
||||||
" Make sure to remove the clone
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
call plug#end()
|
|
||||||
PlugClean!
|
|
||||||
|
|
||||||
" Install master branch
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug expand('file:////tmp/vim-plug-test/new-branch')
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
|
|
||||||
unlet! g:foo g:bar g:baz
|
|
||||||
call ResetPlug()
|
|
||||||
call plug#load('new-branch')
|
|
||||||
Assert exists('g:foo'), 'g:foo should be found (1)'
|
|
||||||
Assert !exists('g:bar'), 'g:bar should not be found (1)'
|
|
||||||
Assert !exists('g:baz'), 'g:baz should not be found (1)'
|
|
||||||
|
|
||||||
" Create a new branch on origin
|
|
||||||
call system('cd /tmp/vim-plug-test/new-branch && git checkout -b new &&'
|
|
||||||
\. 'echo "let g:bar = 1" > plugin/bar.vim && git add plugin/bar.vim &&'
|
|
||||||
\. 'git commit -m second')
|
|
||||||
|
|
||||||
" We're setting up two plugins so that parallel installer is used
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
Plug expand('file:////tmp/vim-plug-test/new-branch'), { 'branch': 'new' }
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
silent %y
|
|
||||||
Log @"
|
|
||||||
Assert @" !~? 'error', 'Should be able to use new remote branch: ' . @"
|
|
||||||
|
|
||||||
unlet! g:foo g:bar g:baz
|
|
||||||
call ResetPlug()
|
|
||||||
call plug#load('new-branch')
|
|
||||||
Assert exists('g:foo'), 'g:foo should be found (2)'
|
|
||||||
Assert exists('g:bar'), 'g:bar should be found (2)'
|
|
||||||
Assert !exists('g:baz'), 'g:baz should not be found (2)'
|
|
||||||
|
|
||||||
call PlugStatusSorted()
|
|
||||||
|
|
||||||
Expect:
|
|
||||||
- new-branch: OK
|
|
||||||
- seoul256.vim: OK
|
|
||||||
Finished. 0 error(s).
|
|
||||||
[==]
|
|
||||||
|
|
||||||
Execute (#139-2 Using yet another new remote branch):
|
|
||||||
" Create another branch on origin
|
|
||||||
call system('cd /tmp/vim-plug-test/new-branch && git checkout master &&'
|
|
||||||
\. 'git checkout -b brand-new &&'
|
|
||||||
\. 'echo "let g:baz = 1" > plugin/baz.vim && git add plugin/baz.vim &&'
|
|
||||||
\. 'git commit -m third')
|
|
||||||
|
|
||||||
" Test Vim installer here
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug expand('file:////tmp/vim-plug-test/new-branch'), { 'branch': 'brand-new' }
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
silent %y
|
|
||||||
Log @"
|
|
||||||
Assert @" !~? 'error', 'Should be able to use new remote branch: ' . @"
|
|
||||||
|
|
||||||
unlet! g:foo g:bar g:baz
|
|
||||||
call ResetPlug()
|
|
||||||
call plug#load('new-branch')
|
|
||||||
Assert exists('g:foo'), 'g:foo should be found'
|
|
||||||
Assert !exists('g:bar'), 'g:bar should not be found'
|
|
||||||
Assert exists('g:baz'), 'g:baz should be found'
|
|
||||||
|
|
||||||
call PlugStatusSorted()
|
|
||||||
|
|
||||||
Expect:
|
|
||||||
- new-branch: OK
|
|
||||||
Finished. 0 error(s).
|
|
||||||
[=]
|
|
||||||
|
|
||||||
Execute (#139-3 Should fail when not possible to fast-forward):
|
|
||||||
" Commit on cloned repo
|
|
||||||
call system('cd /tmp/vim-plug-test/plugged/new-branch && git checkout master &&'
|
|
||||||
\. 'touch foobar && git add foobar && git commit -m foobar')
|
|
||||||
|
|
||||||
" Different commit on remote
|
|
||||||
call system('cd /tmp/vim-plug-test/new-branch && git checkout master &&'
|
|
||||||
\. 'touch foobaz && git add foobaz && git commit -m foobaz')
|
|
||||||
|
|
||||||
for multi in [0, 1]
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
if multi
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
endif
|
|
||||||
Plug expand('file:////tmp/vim-plug-test/new-branch')
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
silent %y
|
|
||||||
Assert @" =~ 'Not possible to fast-forward', @"
|
|
||||||
endfor
|
|
||||||
q
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#145: Merging on-demand loading triggers - cmd):
|
|
||||||
unlet! g:xxx g:yyy
|
|
||||||
call plug#begin()
|
|
||||||
Plug '$PLUG_FIXTURES/xxx', { 'on': 'XXX' }
|
|
||||||
Plug '$PLUG_FIXTURES/yyy', { 'on': ['XXX', 'YYY'] }
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
silent! XXX
|
|
||||||
|
|
||||||
Assert exists('g:xxx'), 'xxx is not loaded'
|
|
||||||
Assert exists('g:yyy'), 'yyy is not loaded'
|
|
||||||
Assert !exists(':YYY')
|
|
||||||
|
|
||||||
Execute (#145: Merging on-demand loading triggers - map):
|
|
||||||
unlet! g:xxx g:yyy
|
|
||||||
|
|
||||||
call ReloadPlug()
|
|
||||||
call plug#begin()
|
|
||||||
Plug '$PLUG_FIXTURES/xxx', { 'on': '<Plug>(xxx)' }
|
|
||||||
Plug '$PLUG_FIXTURES/yyy', { 'on': ['<Plug>(xxx)' ,'<Plug>(yyy)' ] }
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
Assert !empty(mapcheck("<Plug>(xxx)"))
|
|
||||||
Assert !empty(mapcheck("<Plug>(yyy)"))
|
|
||||||
|
|
||||||
# FIXME feedkeys() cannot be tested with Vader
|
|
||||||
call plug#load('xxx', 'yyy')
|
|
||||||
Assert empty(mapcheck("<Plug>(xxx)"))
|
|
||||||
Assert empty(mapcheck("<Plug>(yyy)"))
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#159: shell=/bin/tcsh):
|
|
||||||
let org = &shell
|
|
||||||
try
|
|
||||||
set shell=/bin/tcsh
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
PlugStatus
|
|
||||||
Log getline(1, '$')
|
|
||||||
q
|
|
||||||
AssertEqual '/bin/tcsh', &shell
|
|
||||||
finally
|
|
||||||
let &shell = org
|
|
||||||
endtry
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#154: Spaces in &rtp should not be escaped):
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plug it')
|
|
||||||
Plug 'foo/seoul256 vim'
|
|
||||||
call plug#end()
|
|
||||||
Log &rtp
|
|
||||||
Assert stridx(&rtp, 'plug it/seoul256 vim') >= 0
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#184: Duplicate entries in &rtp):
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'foo/plugin1'
|
|
||||||
\| Plug 'foo/plugin0'
|
|
||||||
|
|
||||||
Plug 'foo/plugin2'
|
|
||||||
\| Plug 'foo/plugin0'
|
|
||||||
\| Plug 'foo/plugin1'
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
Log &rtp
|
|
||||||
AssertEqual 3, len(filter(split(&rtp, ','), 'stridx(v:val, "plugged") >= 0'))
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#236: Plugin removed from &rtp when .vimrc is reloaded):
|
|
||||||
unlet! g:loaded_easy_align_plugin
|
|
||||||
silent! delc EasyAlign
|
|
||||||
|
|
||||||
call ReloadPlug()
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-easy-align', { 'on': 'EasyAlign' }
|
|
||||||
call plug#end()
|
|
||||||
PlugInstall | q
|
|
||||||
|
|
||||||
Assert &rtp !~ '/vim-easy-align', 'Plugin should not be in &rtp'
|
|
||||||
%EasyAlign=
|
|
||||||
Assert &rtp =~ '/vim-easy-align', 'Plugin should be in &rtp'
|
|
||||||
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-easy-align', { 'on': 'EasyAlign' }
|
|
||||||
call plug#end()
|
|
||||||
Assert &rtp =~ '/vim-easy-align', 'Plugin should still be in &rtp'
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#350: Ruby installer failed to unshallow tagged plugin on update):
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
call plug#end()
|
|
||||||
PlugClean!
|
|
||||||
|
|
||||||
" Shallow clone. We should have at least 2 plugins to enable parallel installer.
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-easy-align'
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
Assert filereadable(g:plugs['vim-easy-align'].dir.'/.git/shallow')
|
|
||||||
|
|
||||||
" Now unshallowed
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/vim-easy-align', { 'tag': '2.9.0' }
|
|
||||||
Plug 'junegunn/seoul256.vim'
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
Assert !filereadable(g:plugs['vim-easy-align'].dir.'/.git/shallow')
|
|
||||||
q
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#474: Load ftdetect files in filetypedetect augroup):
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/rust.vim', { 'for': 'rust', 'commit': '115d321d383eb96d438466c56cc871fcc1bd0faa' }
|
|
||||||
call plug#end()
|
|
||||||
PlugInstall!
|
|
||||||
q
|
|
||||||
|
|
||||||
tabnew /tmp/vim-plug-test/any.rs
|
|
||||||
AssertEqual 'rust', &filetype
|
|
||||||
Log &filetype
|
|
||||||
filetype detect
|
|
||||||
AssertEqual 'rust', &filetype
|
|
||||||
Log &filetype
|
|
||||||
bd
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#489/#587 On-demand loading with 'on' option should trigger BufRead autocmd w/o nomodeline):
|
|
||||||
call plug#begin('$PLUG_FIXTURES')
|
|
||||||
Plug 'foo/ftplugin-msg', { 'on': 'XXX' }
|
|
||||||
call plug#end()
|
|
||||||
|
|
||||||
tabnew a.java
|
|
||||||
call setline(1, '// vim: set filetype=lava:')
|
|
||||||
redir => out
|
|
||||||
silent! XXX
|
|
||||||
redir END
|
|
||||||
Assert stridx(out, 'ftplugin-java') >= 0
|
|
||||||
AssertEqual 'lava', &filetype
|
|
||||||
q!
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (Cursor moved to another window during post-update hook):
|
|
||||||
function! DoSplit(...)
|
|
||||||
new
|
|
||||||
call setline(1, 'empty')
|
|
||||||
endfunction
|
|
||||||
call plug#begin('/tmp/vim-plug-test/plugged')
|
|
||||||
Plug 'junegunn/rust.vim', { 'do': function('DoSplit') }
|
|
||||||
call plug#end()
|
|
||||||
PlugInstall!
|
|
||||||
AssertEqual 1, line('$')
|
|
||||||
AssertEqual 'empty', getline(1)
|
|
||||||
q!
|
|
||||||
q
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#593 Add plugin to &rtp before running post-update hook with : prefix):
|
|
||||||
call ReloadPlug()
|
|
||||||
call plug#begin()
|
|
||||||
Plug 'junegunn/vim-pseudocl', { 'on': 'XXX', 'do': ':let g:bar = pseudocl#complete#extract_words(''a b'')' }
|
|
||||||
call plug#end()
|
|
||||||
PlugInstall!
|
|
||||||
AssertEqual ['a', 'b'], g:bar
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (#602 Confusion with branch name and path name):
|
|
||||||
call plug#begin()
|
|
||||||
Plug expand('file:////tmp/vim-plug-test/new-branch'), { 'branch': 'plugin' }
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
call PlugStatusSorted()
|
|
||||||
|
|
||||||
Expect:
|
|
||||||
- new-branch: OK
|
|
||||||
Finished. 0 error(s).
|
|
||||||
[=]
|
|
||||||
|
|
||||||
**********************************************************************
|
|
||||||
Execute (PlugStatus showed error with wildcard tag):
|
|
||||||
call plug#begin()
|
|
||||||
Plug 'junegunn/vim-easy-align', { 'tag': '*' }
|
|
||||||
call plug#end()
|
|
||||||
PlugUpdate
|
|
||||||
call PlugStatusSorted()
|
|
||||||
|
|
||||||
Expect:
|
|
||||||
- vim-easy-align: OK
|
|
||||||
Finished. 0 error(s).
|
|
||||||
[=]
|
|
144
test/run
|
@ -1,137 +1,19 @@
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# Privileged mode, ignores $CDPATH etc.
|
cd $(dirname $BASH_SOURCE)
|
||||||
set -p
|
cd ..
|
||||||
set -eu
|
PLUG_SRC=$(pwd)/plug.vim
|
||||||
|
cd - > /dev/null
|
||||||
|
|
||||||
cd "$(dirname "${BASH_SOURCE[0]}")"
|
export VADER_RTP=$TMPDIR/vader-rtp
|
||||||
|
vim -e +Vader -c ':call writefile([fnamemodify(globpath(&rtp, "autoload/vader.vim"), ":h:h")], $VADER_RTP)' +q
|
||||||
|
|
||||||
export BASE="$PWD"
|
MINI_VIMRC=$TMPDIR/mini-vimrc
|
||||||
export PLUG_SRC="$PWD/../plug.vim"
|
cat > $MINI_VIMRC << EOF
|
||||||
export PLUG_FIXTURES="$PWD/fixtures"
|
let \$MYVIMRC = '$MINI_VIMRC'
|
||||||
mkdir -p "$PLUG_FIXTURES"
|
set nocompatible
|
||||||
export TEMP=/tmp/vim-plug-test
|
set rtp=$(cat $VADER_RTP)
|
||||||
rm -rf "$TEMP"
|
source $PLUG_SRC
|
||||||
mkdir -p "$TEMP"
|
|
||||||
|
|
||||||
cat > $TEMP/mini-vimrc << VIMRC
|
|
||||||
set rtp+=$TEMP/junegunn/vader.vim
|
|
||||||
set shell=/bin/bash
|
|
||||||
VIMRC
|
|
||||||
|
|
||||||
clone() {
|
|
||||||
if [ ! -d "$2" ]; then
|
|
||||||
git clone "$1" "$2"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
clone_repos() (
|
|
||||||
cd $TEMP
|
|
||||||
mkdir -p junegunn vim-scripts jg
|
|
||||||
for repo in vader.vim goyo.vim rust.vim seoul256.vim vim-easy-align vim-fnr \
|
|
||||||
vim-oblique vim-pseudocl vim-redis vim-emoji; do
|
|
||||||
clone https://github.com/junegunn/${repo}.git junegunn/$repo &
|
|
||||||
done
|
|
||||||
clone https://github.com/vim-scripts/beauty256.git vim-scripts/beauty256 &
|
|
||||||
clone https://github.com/junegunn/fzf.git fzf &
|
|
||||||
clone https://github.com/yous/subsubmodule.git yous/subsubmodule && \
|
|
||||||
(cd yous/subsubmodule && git submodule update --init --recursive &) &
|
|
||||||
wait
|
|
||||||
|
|
||||||
clone junegunn/vim-emoji jg/vim-emoji
|
|
||||||
cd junegunn/seoul256.vim && git checkout no-t_co && git checkout master
|
|
||||||
)
|
|
||||||
|
|
||||||
make_dirs() (
|
|
||||||
rm -rf "$PLUG_FIXTURES/$1"
|
|
||||||
mkdir -p "$PLUG_FIXTURES/$1"
|
|
||||||
cd "$PLUG_FIXTURES/$1"
|
|
||||||
mkdir -p autoload colors ftdetect ftplugin indent plugin syntax
|
|
||||||
for d in *; do
|
|
||||||
[ -d "$d" ] || continue
|
|
||||||
cat > "$d/xxx.vim" << EOF
|
|
||||||
" echom expand('<sfile>')
|
|
||||||
let g:total_order = get(g:, 'total_order', [])
|
|
||||||
let g:$2 = get(g:, '$2', [])
|
|
||||||
let s:name = join(filter(['$2', '${1:4}', '$d'], '!empty(v:val)'), '/')
|
|
||||||
call add(g:$2, s:name)
|
|
||||||
call add(g:total_order, s:name)
|
|
||||||
EOF
|
EOF
|
||||||
done
|
|
||||||
)
|
|
||||||
|
|
||||||
gitinit() (
|
vim -u $MINI_VIMRC +Vader*
|
||||||
cd "$PLUG_FIXTURES/$1"
|
|
||||||
git init -b master
|
|
||||||
git commit -m 'commit' --allow-empty
|
|
||||||
)
|
|
||||||
|
|
||||||
prepare() {
|
|
||||||
make_dirs xxx/ xxx
|
|
||||||
make_dirs xxx/after xxx
|
|
||||||
mkdir -p "$PLUG_FIXTURES/xxx/doc"
|
|
||||||
cat > "$PLUG_FIXTURES/xxx/doc/xxx.txt" << DOC
|
|
||||||
hello *xxx*
|
|
||||||
DOC
|
|
||||||
gitinit xxx
|
|
||||||
|
|
||||||
make_dirs yyy/ yyy
|
|
||||||
make_dirs yyy/after yyy
|
|
||||||
mkdir -p "$PLUG_FIXTURES/yyy/rtp/doc"
|
|
||||||
cat > "$PLUG_FIXTURES/yyy/rtp/doc/yyy.txt" << DOC
|
|
||||||
hello *yyy*
|
|
||||||
DOC
|
|
||||||
gitinit yyy
|
|
||||||
|
|
||||||
make_dirs z1/ z1
|
|
||||||
make_dirs z2/ z2
|
|
||||||
|
|
||||||
rm -rf "$PLUG_FIXTURES/ftplugin-msg"
|
|
||||||
mkdir -p "$PLUG_FIXTURES"/ftplugin-msg/{plugin,ftplugin}
|
|
||||||
echo "echomsg 'ftplugin-c'" > "$PLUG_FIXTURES/ftplugin-msg/ftplugin/c.vim"
|
|
||||||
echo "echomsg 'ftplugin-java'" > "$PLUG_FIXTURES/ftplugin-msg/ftplugin/java.vim"
|
|
||||||
|
|
||||||
chmod +w "$PLUG_FIXTURES/cant-delete/autoload" || rm -rf "$PLUG_FIXTURES/cant-delete"
|
|
||||||
mkdir -p "$PLUG_FIXTURES/cant-delete/autoload"
|
|
||||||
touch "$PLUG_FIXTURES/cant-delete/autoload/cant-delete.vim"
|
|
||||||
chmod -w "$PLUG_FIXTURES/cant-delete/autoload"
|
|
||||||
|
|
||||||
rm -rf $TEMP/new-branch
|
|
||||||
cd $TEMP
|
|
||||||
git init new-branch -b master
|
|
||||||
cd new-branch
|
|
||||||
mkdir plugin
|
|
||||||
echo 'let g:foo = 1' > plugin/foo.vim
|
|
||||||
git add plugin/foo.vim
|
|
||||||
git commit -m initial
|
|
||||||
git checkout -b plugin
|
|
||||||
git checkout master
|
|
||||||
|
|
||||||
cd "$BASE"
|
|
||||||
}
|
|
||||||
|
|
||||||
select_vim() {
|
|
||||||
local vim=/usr/bin/vim
|
|
||||||
if [ -n "${DEPS:-}" ] && [ -e "${DEPS}/bin/vim" ]; then
|
|
||||||
vim="${DEPS}/bin/vim"
|
|
||||||
elif [ -e "/usr/local/bin/vim" ]; then
|
|
||||||
vim=/usr/local/bin/vim
|
|
||||||
fi
|
|
||||||
echo $vim
|
|
||||||
}
|
|
||||||
|
|
||||||
clone_repos
|
|
||||||
prepare
|
|
||||||
|
|
||||||
git --version
|
|
||||||
vim=$(select_vim)
|
|
||||||
echo "Selected Vim: $vim"
|
|
||||||
if [ "${1:-}" = '!' ]; then
|
|
||||||
FAIL=0
|
|
||||||
$vim -Nu $TEMP/mini-vimrc -c 'Vader! test.vader' > /dev/null || FAIL=1
|
|
||||||
prepare
|
|
||||||
$vim -Nu $TEMP/mini-vimrc -c 'let g:plug_threads = 1 | Vader! test.vader' > /dev/null || FAIL=1
|
|
||||||
test $FAIL -eq 0
|
|
||||||
else
|
|
||||||
$vim -Nu $TEMP/mini-vimrc -c 'Vader test.vader'
|
|
||||||
fi
|
|
||||||
|
|
106
test/test.vader
|
@ -1,106 +0,0 @@
|
||||||
Execute (Initialize test environment):
|
|
||||||
Save &rtp, g:plugs, g:plug_home, g:plug_window
|
|
||||||
unlet! g:plugs g:plug_home g:plug_window
|
|
||||||
|
|
||||||
let g:plug_url_format = 'file:///tmp/vim-plug-test/%s'
|
|
||||||
let g:base_rtp = &rtp
|
|
||||||
let g:first_rtp = split(&rtp, ',')[0]
|
|
||||||
let g:last_rtp = split(&rtp, ',')[-1]
|
|
||||||
let g:temp_plugged = tempname()
|
|
||||||
if !exists('$PLUG_SRC')
|
|
||||||
let $PLUG_SRC = globpath(&rtp, 'autoload/plug.vim')
|
|
||||||
endif
|
|
||||||
let $PLUG_TMP = fnamemodify(tempname(), ':h').'/plug.vim'
|
|
||||||
|
|
||||||
" Temporarily patch plug.vim
|
|
||||||
call system('cp "$PLUG_SRC" "$PLUG_TMP"')
|
|
||||||
let patch =
|
|
||||||
\ ['function! ResetPlug()', 'let s:loaded = {}', 'endfunction',
|
|
||||||
\ 'function! CompareURI(a, b)', 'return s:compare_git_uri(a:a, a:b)', 'endfunction']
|
|
||||||
|
|
||||||
call writefile(extend(readfile($PLUG_TMP), patch), $PLUG_TMP)
|
|
||||||
|
|
||||||
set t_Co=256
|
|
||||||
colo default
|
|
||||||
pclose
|
|
||||||
|
|
||||||
function! PlugStatusSorted()
|
|
||||||
PlugStatus
|
|
||||||
%y
|
|
||||||
q
|
|
||||||
normal! P
|
|
||||||
%sort
|
|
||||||
g/^$/d
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! AssertExpect(bang, pat, cnt, ...)
|
|
||||||
let op = a:bang ? '==#' : '=~#'
|
|
||||||
let args = [a:cnt, len(filter(getline(1, '$'), "v:val ".op." '".a:pat."'"))] + a:000
|
|
||||||
call call('vader#assert#equal', args)
|
|
||||||
endfunction
|
|
||||||
command! -nargs=+ -bang AssertExpect call AssertExpect('<bang>' == '!', <args>)
|
|
||||||
|
|
||||||
function! EnsureLoaded()
|
|
||||||
if has('vim_starting')
|
|
||||||
runtime! plugin/**/*.vim
|
|
||||||
endif
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! RmRf(file)
|
|
||||||
call system(printf('rm -rf "%s"', a:file))
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! ReloadPlug()
|
|
||||||
call ResetPlug()
|
|
||||||
source $PLUG_TMP
|
|
||||||
let &rtp = g:base_rtp
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! GitBranch(repo)
|
|
||||||
return system(printf('cd %s && git rev-parse --abbrev-ref HEAD', g:plugs[a:repo].dir))[:-2]
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! GitTag(repo)
|
|
||||||
return system(printf('cd %s && git describe --tags', g:plugs[a:repo].dir))[:-2]
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
function! GitCommit(repo)
|
|
||||||
return system(printf('cd %s && git rev-parse HEAD', g:plugs[a:repo].dir))[:-2]
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
source $PLUG_TMP
|
|
||||||
|
|
||||||
Execute (Print Interpreter Version):
|
|
||||||
redir => out
|
|
||||||
if has('ruby')
|
|
||||||
silent! ruby puts 'Ruby: ' + RUBY_VERSION
|
|
||||||
endif
|
|
||||||
if has('python')
|
|
||||||
silent! python import sys; svi = sys.version_info; print 'Python: {}.{}.{}'.format(svi[0], svi[1], svi[2])
|
|
||||||
endif
|
|
||||||
if has('python3')
|
|
||||||
silent! python3 import sys; svi = sys.version_info; print('Python: {}.{}.{}'.format(svi[0], svi[1], svi[2]))
|
|
||||||
endif
|
|
||||||
redir END
|
|
||||||
Log split(out, '\n')
|
|
||||||
|
|
||||||
Include: workflow.vader
|
|
||||||
Include: regressions.vader
|
|
||||||
Include: functional.vader
|
|
||||||
|
|
||||||
Execute (Cleanup):
|
|
||||||
silent! call RmRf(g:temp_plugged)
|
|
||||||
silent! unlet g:plugs g:plug_home g:plug_url_format
|
|
||||||
silent! unlet g:temp_plugged g:first_rtp g:last_rtp g:base_rtp out
|
|
||||||
silent! delf PlugStatusSorted
|
|
||||||
silent! delf AssertExpect
|
|
||||||
silent! delf PlugUpdated
|
|
||||||
silent! delf EnsureLoaded
|
|
||||||
silent! delf ReloadPlug
|
|
||||||
silent! delc AssertExpect
|
|
||||||
silent! unmap /
|
|
||||||
silent! unmap ?
|
|
||||||
call delete($PLUG_TMP)
|
|
||||||
|
|
||||||
Restore
|
|
||||||
|
|