vim-overlay.nix

self: super:

{
  # Install overlay with:
  # $ mkdir -p ~/.config/nixpkgs/overlays
  # $ curl -fsSL -o ~/.config/nixpkgs/overlays/vim-overlay.nix https://gist.github.com/LnL7/06d2f6b980f0c283cc57e6a287f2dda5/raw/7d50a7f56007a1fb40e9f1b61fd3e94068726177/vim-overlay.nix
  userPackages = super.userPackages or {} // {

    # To install or upgrade vim with:
    # $ nix-env -f '<nixpkgs>' -iA userPackages.vim
    vim = super.vim_configurable.customize {
      inherit (super.vim_configurable) name;
      vimrcConfig.packages.myVimPackage = with super.vimPlugins; {
        # loaded on launch
        start = [ youcompleteme fugitive ];
        # manually loadable by calling `:packadd $plugin-name`
        opt = [ phpCompletion elm-vim ];
        # To automatically load a plugin when opening a filetype, add vimrc lines like:
        # autocmd FileType php :packadd phpCompletion
      };
    };

  };
}