[ANN] parinfer-rust 0.4.0 (emacs support!)

[Jason Felice]

Thanks to Justin Barclay, parinfer-rust, and therefore Parinfer's Smart Mode, is now available for emacs!

parinfer-rust

Infer parentheses for Clojure, Lisp and Scheme.

https://github.com/eraserhd/parinfer-rust

A full-featured, super fast implementation of Shaun Lebron’s parinfer. This repo comes with Vim plugin files that work with Vim8 and Neovim. The Rust library can be called from other editors that can load dynamic libraries.

This plugin, unlike others available for Vim, implements "smart" mode. Rather than switching between "paren" mode and "indent" mode, parinfer uses information about how the user is changing the file to decide what to do.

Installing

Dependencies:

• rust >= 1.36

• libclang, which may be part of a clang package, depending on your OS

Vim and Neovim

pathogen

If you are using Tim Pope’s pathogen:

$ cd ~/.vim/bundle
$ git clone g...@github.com:eraserhd/parinfer-rust.git
$ cd ~/.vim/bundle/parinfer-rust
$ cargo build --release

vim-plug

Plug 'eraserhd/parinfer-rust'

Then, build project using cargo:

$ cd /path/to/parinfer-rust
$ cargo build --release

Or, with optional automatic recompilation on update:

Plug 'eraserhd/parinfer-rust', {'do':
        \  'cargo build --release'}

Kakoune

plug.kak

Add this to your kakrc

plug "eraserhd/parinfer-rust" do %{
    cargo build --release
    cargo install --force --path .
}

Re-source your kakrc or restart Kakoune. Then run :plug-install. plug.kak will download, build and install plugin for you.

Manual

$ cd ~/my-projects
$ git clone g...@github.com:eraserhd/parinfer-rust.git
$ cd parinfer-rust
$ make install
$ cargo build --release
$ cargo install

Emacs

To install parinfer-rust for Emacs follow the instructions at parinfer-rust-mode.el

Building WebAssembly

WebAssembly currently needs the ``nigthly'' toolchain:

$ rustup update
$ rustup install nightly
$ rustup target add wasm32-unknown-unknown --toolchain nightly
$ cargo +nightly install cargo-web

It can then be built with:

$ cargo +nightly web build --release

Tests

You can run tests like so:

$ cargo test                   # Run the native tests
$ cargo +nightly web test      # Test the WebAssembly version
$ vim --clean -u tests/run.vim # Integration tests

Tests are in a nice, readable format in tests/test_*.vim. Please add tests for any new features (or even old ones!). You can set the VIM_TO_TEST environment variable to Vim’s path to test weird or different builds.

Contributors

This wouldn’t be possible without the work of others:

• Shaun Lebron - Inventing parinfer and doing the math.

• Case Nelson - Writing the nvim-parinfer, from which VimL code and some inspiration was stolen.

• Justin Barclay - Emacs module.

License

ISC License