Uma Lição de VIM #15.9: Plugins – CtrlP e CtrlPFunky

(Essa é a parte em que você vai ter a impressão de estar programando em Perl, porque qualquer caractere é válido.)

O nono e penúltimo plugin (na verdade os nonos e penúltimos plugins) discutido é o CtrlP e seu plugin (sim, um plugin do plugin[1]) CtrlPFunky.

Para instalar os dois, com Vundle:

Bundle ‘kien/ctrlp.vim’
Bundle ‘tacahiroy/ctrlp-funky’ 

CtrlP é um plugin que facilita encontrar e abrir arquivos, com procura fuzzy. E, por procura fuzzy eu quero dizer que ele encontra qualquer arquivo que tenha as letras digitadas na ordem que você digitou.

ctrlp

Para acionar o CtrlP, você deve digitar, logicamente, [Ctrl]p. Ao fazer isso, uma janela parecida com a Quickfix irá aparecer, mostrando alguns arquivos e um prompt para que você digite o que quer encontrar. No exemplo acima, como que digitei “vim”, ele encontrou todos os arquivos a partir do diretório atual que começavam com “v”, tinham um “i” no meio e terminavam com “m” (seria basicamente o mesmo que pegar a lista de arquivos a partir do diretório atual e seus sub-diretórios e procurar pela regex “v.*i.*m”.)

Uma vez que você encontre o arquivo desejado na lista (ela não tem rolagem, então se você ainda não estiver vendo o arquivo, continue adicionando caracteres para que o arquivo desejado apareça na lista — uma vez lá, você pode selecioná-lo com as setas), você pode:

  • Pressionar [Enter] para abrir o arquivo na janela atual.
  • Pressionar [Ctrl]t para abrir o arquivo em outra aba.
  • Pressionar [Ctrl]s para fazer um split horizontal e abrir o arquivo no novo split.
  • Pressionar [Ctrl]v para fazer um split vertical e abrir o arquivo no novo split.

Um problema que você talvez encontre é que o CtrlP costuma listar tudo que se encaixar na expressão utilizada, inclusive arquivos binário, objetos intermediários, etc. Para remover estes arquivos da listagem, você pode usar :set wildignore, que também afeta a lista de arquivos que o VIM mostra quando você estiver usando os comandos normais de abertura de arquivo (:e, :tabe, etc).

Como a configuração do wildignore é uma lista, você pode adicionar ou remover usando += e -=. Por exemplo, para ignorar os arquivos de objetos compilados do Python e o diretório que o setup.py constuma usar para construir o pacote de distribuição do módulo, você teria:

set wildignore+=*.pyc
set wildignore+=*/build/*

ou ainda, para economizar uma linha:

set wildignore+=*.pyc,*/build/*

CtrlP tem um plugin, chamado CtrlPFunky. O que ele faz é basicamente o mesmo que o CtrlP, mas procurando funções, não arquivos.

Para ativar o CtrlPFunky, você precisa primeiro adicionar o mesmo como uma extensão do CtrlP (e, só pra avisar, isso é específico do CtrlP, não algo que funciona com todo e qualquer plugin):

let g:ctrlp_extensions = [‘funky’

Uma vez instalado, você pode usar :CtrlPFunky para mostrar a lista de funções no fonte (e a procura continua igual). O problema com CtrlPFunky é que, assim como todas as demais coisas que vínhamos vendo, ele se basea no tipo de arquivo atual (:set ft) e para arquivos em que o conteúdo e uma mistura de várias linguagens (p.ex., arquivo template com a linguagem de template, HTML, CSS e JavaScript), a listagem de funções pode não ser o que você está esperando (ou sequer vai funcionar).

Para facilitar a sua vida, você pode fazer um mapeamento do comando para um atalho de teclado. Por exemplo, eu coloquei [Ctrl]o para chamar o CtrlPFunky com

nnoremap <C-O> :CtrlPFunky<CR>

[1] “Plugin-ception” har har har[2].

[2] Eu não consigo entender porque as pessoas utilizando tanto o “ception” quando encontram um meta desta jeito. Um “inception” é a inserção de uma idéia de forma que a pessoa pense que a idéia é dela, não uma “Matrioska“.

My list of VIM Bundles

Not that anybody asked me, but I recently ditched Sublime Text 2 for VIM… again.

But here is the thing: I just ditched it ’cause I’m using a lot of bundles to change VIM default behaviour, adding more feature and that fuss. The ones I’m using:

Vundle
Vundle is the plugin I’m currenctly using to manage all the other plugins. Vundle is a really simple way to keep your other plugins up-to-date. All the other plugins listed here were installed using Vundle.

vundle

Powerline
Powerline changes the default “last status” line to provide a lot more information. The cool thing about Powerline is that it comes not only with a VIM plugin, but also with a Bash prompt and an iPython prompt, so everything have (almost) the same look.

powerline

Vim-Fugitive
I got Vim-Fugitive to display the current branch in the old Powerline plugin (the current one does that already). One of the things I still try to use is :Gstatus, which display the current changes in the index. The problem here is that the display, although pretty familiar, it’s a mess when you’re dealing with a single file (it shows “Changes not staged for commit” and then, when you add it to the index, it just change that to “Changes staged for commit”, which is pretty easy to miss in the list of things that are shown).

fugitive

Vim-Commentary
Vim-Commentary lets you comment a block of text pretty quickly, which is useful. The only issue with it is that it follows the current file type (as VIM does not have a “block type” or “region type” support), so trying to comment a few lines of JavaScript in an HTML file will produce HTML comments, not JavaScript/C++ comments. Still pretty useful to quickly comment that one line in your Python code.
Tabular
Tabular is a hard plugin to master, but really useful. With it, you can realign your code on custom characters (for example, align your variable definition on the “=” character). Or make all your HTML/XML properties align on “=”. And so on.
Auto Pairs
Auto-pairs does exactly what it says: It complete pairs of characters, adding a second " after your first ", the closing bracket and so on.
Vim-Flake8
On our Python project, we have a strictly “follow PEP8” policy. With Vim-Flake8, PEP8 errors are displayed in the error window for easy access (and fix).

flake8

SnipMate
SnipMate is a TextMate-like snippet plugin, but really easy to use. Type the snippet name, press [Tab] and it will complete the snippet, positioning the cursor on the marker areas.

snipmate

CtrlP
Again, a plugin inspired on TextMate/Sublime Text: Fuzzy file search. It allows faster file switching by doing fuzzy search on filenames and directories, to the point that I barely use the open command/dialog these days. Also, you can chose to open the file in the current buffer, new split window or new tab.

ctrlp

Vim Multiple Cursors
Again, a feature based on TextMate/Sublime Text: Selection of multiple elements and change in those selected. It is a more visual way of doing :s/<original>/<replacement>.

multiple-cursors

After seeing this, you’re probably asking yourself: But with all those features based on Sublime Text, why not use Sublime Text directly? Well, for one, I’m a fan of the VIM movement/selection way of doing things; second, I use “jump to mark” pretty often (including “jump to last changed area in this file” and “jump to the previous jump place”) and Sublime does not have that; third, I prefer the way VIM colorizes the code, even if I try to use the same colorscheme in both editors (the difference here is the syntax file, so…); fourth, even if Sublime have a Vintage mode, most of the things I use (like smart jumps) do not exists.

Also, some bugs in plugins/Sublime let me down from time to time: Ctrl+R, sometimes, start in visual mode when Vintage is on (in other words, as soon as you find the definition you’re looking for, you start selecting text); Flake8 for Sublime manages, from time to time, to move the cursor to focus nothing, so you’re forced to move your hand to the mouse and click on the text again to be able to do anything.