README.adoc

vim-iced

Clojure Interactive Development Environment for Vim8/Neovim.

Warning

This project is in maintenance mode. New features will not be added. Now I’m developing vim-elin as the main project, so please look forward to it.

Requirements

• Vim 8.1.0614 or later, Neovim 0.4.0 or later.

• Clojure 1.8 or later.

  • 1.10 or later is recommended.

• No python! (boost possible with if_python3)

Features

⚡	Asynchronous evaluation	powered by channel in Vim8 / Neovim
🔥	Testing	Run test under cursor Run tests in namespace Re run failed/last test Also supports kaocha by vim-iced-kaocha
🚀	Refactoring	Clean namespace Add missing Thread first/last Extract function Move to let Rename symbol
💭	Auto completion	Provided by following external plugins. - vim-iced-coc-source for coc.nvim - vim-iced-asyncomplete for asyncomplete.vim - cmp-iced for nvim-cmp Omni completion is provided by default.
📐	Formatting	Supports followings currently. - cljfmt via nREPL - cljstyle - zprint - joker
🔍	Reference	Docs, Javadoc, and ClojureDocs 🎥 Function dependencies and references 🎥
🐜	Debugging	Supports cider-nrepl’s debugger 🎥 Browsing tapped values 🎥
📓	Skeleton	Provides code skeleton when you open new file
🎩	ClojureScript support	Supports followings currently. - Figwheel Main, lein-figwheel - shadow-cljs
😎	Static analysis	Boost performance with static analysis powered by clj-kondo
🔌	Socket REPL	Supports minimal operations.
🎨	Command palette	Access commands smoothly and define user custom commands

Note	vim-iced is heavily powered by cider-nrepl, refactor-nrepl, and iced-nrepl.

Documents

• Installation

• Quick start

  • Cheatsheet

• vim-iced.txt (Vim help file)

External plugins

🔥	vim-iced-kaocha	Provides some commands for testing with kaocha.
🔍	vim-iced-project-namespaces	Provides :IcedBrowseNamespace command for jumping to namespace in your project.
	vim-iced-function-list	Provides :IcedBrowseFunction command for jumping to functions in current namespace.
💭	vim-iced-coc-source	Provides auto completion by coc.nvim.
	vim-iced-asyncomplete	Provides auto completion by asyncomplete.vim.
	vim-iced-ncm2	Provides auto completion by ncm2.
	vim-iced-compe	Provides auto completion by nvim-compe.
🐜	vim-iced-fern-debugger	Provides tree views for debugging results and tapped values by fern.vim.
📚	https://github.com/liquidz/vim-iced-multi-session	Provides multi session support like connecting to nREPL and shadow-cljs.

License

Copyright (c) 2018-2024 Masashi Iizuka

Distributed under the MIT License.