https://github.com/tpope/vim-salve

salve.vim: static support for Leiningen and Boot
https://github.com/tpope/vim-salve

Last synced: 9 months ago
JSON representation

salve.vim: static support for Leiningen and Boot

• Host: GitHub
• URL: https://github.com/tpope/vim-salve
• Owner: tpope
• Created: 2014-04-29T21:15:31.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-07-07T16:35:05.000Z (over 1 year ago)
• Last Synced: 2025-01-08T16:27:48.119Z (10 months ago)
• Language: Vim Script
• Homepage:
• Size: 23.4 KB
• Stars: 195
• Watchers: 8
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: README.markdown

Awesome Lists containing this project

• awesome-clojure - vim-leiningen (Vim)

README

          
# salve.vim

Static Vim support for [Leiningen][], [Boot][], and the [Clojure CLI][].

> Leiningen ran... [the ants] would get to him soon, despite the salve on

> his boots.

-- from "Leiningen versus the Ants"

## Features

* `:Console` command to start a REPL or focus an existing instance if already

  running using [dispatch.vim][].

* Autoconnect [fireplace.vim][] to the REPL, or autostart it with `:Console`.

* [Navigation commands][projectionist.vim]: `:Esource`, `:Emain`, `:Etest`,

  and `:Eresource`.

* Alternate between test and implementation with `:A`.

* Use `:make` to invoke `lein`, `boot`, or `clojure`, complete with stacktrace

  parsing.

* Default [dispatch.vim][]'s `:Dispatch` to running the associated test file.

* `'path'` is seeded with the classpath to enable certain static Vim and

  [fireplace.vim][] behaviors.

[Leiningen]: http://leiningen.org/

[Boot]: http://boot-clj.com/

[Clojure CLI]: https://clojure.org/guides/deps_and_cli

[fireplace.vim]: https://github.com/tpope/vim-fireplace

[dispatch.vim]: https://github.com/tpope/vim-dispatch

[projectionist.vim]: https://github.com/tpope/vim-projectionist

## Installation

Install using your favorite package manager, or use Vim's built-in package

support:

    mkdir -p ~/.vim/pack/tpope/start

    cd ~/.vim/pack/tpope/start

    git clone https://tpope.io/vim/salve.git

    git clone https://tpope.io/vim/projectionist.git

    git clone https://tpope.io/vim/dispatch.git

    git clone https://tpope.io/vim/fireplace.git

    vim -u NONE -c "helptags salve/doc" -c q

    vim -u NONE -c "helptags projectionist/doc" -c q

    vim -u NONE -c "helptags dispatch/doc" -c q

    vim -u NONE -c "helptags fireplace/doc" -c q

## FAQ

> Why does it sometimes take a few extra seconds for Vim to startup?

Much of the functionality of salve.vim depends on knowing the classpath.

When possible, this is retrieved from a [fireplace.vim][] connection, but if

not, this means a call to `lein classpath` or `boot show --fake-classpath`.

Once retrieved, the classpath is cached until a project manifest file

changes: for Leiningen `project.clj` or `~/.lein/profiles.clj`, for Boot

`build.boot` or `~/.boot/profile.boot`, for the Clojure CLI `deps.edn` or

`~/.clojure/deps.edn`.

## License

Copyright © Tim Pope.  Distributed under the same terms as Vim itself.

See `:help license`.