Extend builtin syntax highlighting to referred and aliased vars in Clojure buffers
Clojure Vim script
Latest commit 9ac6cb8 Jul 5, 2015 @guns Provide more setup tips in the README
cf. #4

README.markdown

      _                 .-.       _                  .-.   _     .-.  .-.  _     .-.  .-.
     :_;                : :      :_;                 : :  :_;    : :  : : :_;    : : .' `.
.-..-.-,-.,-.,-. .  .--.: :  .--..-.-..-.--. .--.  . : `-..-..--.: `-.: : .-..--.: `-`. .'
: `; : : ,. ,. :`,`'  ..: :_' .; : : :; : ..' '_.:`,`: .. : ' .; : .. : :_: ' .; : .. : :
`.__.:_:_;:_;:_;   `.__.`.__`.__.: `.__.:_; `.__.'   :_;:_:_`._. :_;:_`.__:_`._. :_;:_:_;
                               .-. :                         .-. :           .-. :
                               `._.'                         `._.'           `._.'

Extend builtin syntax highlighting to local, referred, and aliased vars in Clojure buffers.

demo

Exclusions from clojure.core (via (:refer-clojure)) are also reflected.

This is essentially a re-implementation of the dynamic highlighting feature from Meikel Brandmeyer's VimClojure project.

Requires:

While Vim ships with vim-clojure-static, this plugin uses a feature from a very recent version.

If you'd like vim-clojure-highlight ported to another REPL plugin, please create an issue! This can be done quite easily.

Installation

Install as a normal Vim plugin. If you are unfamiliar with this process, please refer to Pathogen.

Usage

vim-clojure-highlight installs an autocommand that detects and highlights local vars, ns-refers, and aliased references every time a *.clj file is (re)loaded. The syntax highlighting reflects the state of the REPL, so unevaluated references remain unmatched.

This will fail silently if no fireplace nREPL sessions exist.

Reload your buffer with :e after an eval to update syntax matches. Alternately, use the :ClojureHighlightReferences command in a custom autocommand or mapping to do the same.

Eager loading

If you would like to eager-load a fireplace session so that vim-clojure-highlight works on the first load of a clojure file, install an autocommand hook that calls :Require:

" Evaluate Clojure buffers on load
autocmd BufRead *.clj try | silent! Require | catch /^Fireplace/ | endtry

Rainbow parentheses and other syntax extensions

Since vim-clojure-highlight dynamically alters the syntax state of a buffer, it's possible that other syntax extensions will be affected by this plugin.

A simple workaround is to activate Clojure syntax extensions in an autocmd:

autocmd Syntax clojure EnableSyntaxExtension

For example, this is how you might enable rainbow_parentheses.vim for Clojure buffers:

autocmd VimEnter *       RainbowParenthesesToggle
autocmd Syntax   clojure RainbowParenthesesLoadRound
autocmd Syntax   clojure RainbowParenthesesLoadSquare
autocmd Syntax   clojure RainbowParenthesesLoadBraces

See doc/vim-clojure-highlight.txt for more commands and options.