Happy Holidays everyone!
This post has been sitting in my drafts for a while now, so today I finally managed to complete it.
There are best-practices for all kinds of programming languages but I haven’t seen vim-script’s one.
This post doern’t try to cover actual best practices but rather just “issues” often found when scripting Vim.
There are number of WIKIs, blog posts, super-duper-vim-configs unintentionally propagating copy-pasting anti-pattern. There’s no particular person to blame for promoting bad practices, rather copy-pasting had been the only solution to a problem of sharing vim-scripts for a while. I’ve gone through lots of vim-configs(just to learn stuff) and find the most popular snippet being copy-pasted is:
" restore last file position au BufReadPost * if line("'\"") > 1 && line("'\"") <= line("$") | exe "normal! g`\"" | endi
To me this looks like a quick hack and not something I’d like to see in my .vimrc
You can even find that snippet in official help by running
Copy-pasting is bad. I guess every programmer knows this. Imagine your other programming language used copy-pasting as a way to share code…
Anyways, what’s the good solution then?
TPope’s pathogen started “Vim plugins revolution”. Getting scripts is becoming easier.
For example Vundle lets in your
" Restore last file position Bundle 'vim-scripts/last-pos'
instead keeping the script itself. You can even remove the comment above as intent is quite obvious.
.vimrc has actual code(ie custom functions) along with configuration settings it’s probably a time to look into and extract the code into a plugin.
This also applies to any other code sitting in your
.vim/, colorscheme, syntax tweaks or custom functions can be easily extracted into a plugin so other people can benefit as well ;)
IMO publishing scripts has never been easier. Just push plugin to github that’s all it takes to let other ppl use it. Pushing to vim.org is still too complicated(and hopefully vim-scripts will fix that soon, you could help too )
For example ide-popup.vim, ingretu colorscheme, sudo-gui.vim are good examples in my case.
And if it doesn’t fit into own plugin then maybe you could contribute to already existing one?
Learn by doing
By practicing above you’ll
- learn/improve your vim-script fu
- let others use your cool ninja stars^W ideas
Atleast that’s how I got started.
Make your vim plugin day
Should we?! )
- Writing Vim Plugins by Steve Losh
- Learn Vim Script The Hard Way by Steve Losh
- VimL source codes on Github