neovim-java
Neovim Java client
Consists of following modules:
- Core RPC - core of the library providing most basic interface for communicating with Neovim - it can be used without other modules, but other modules are recommended for most uses
- Reactive Core RPC - simple wrapper around Core RPC module for providing a reactive interface
- Unix Socket Connection - simple addition of another RPCConnection for using unix domain sockets
- Neovim API - main interface for communicating with neovim. This is the recommended module to use, it provides a reactive interface and greatly simplified interface, providing complete implementations for all functions provided by Neovim.
- Neovim Rx API - small wrapper around Neovim API providing RxJava2 interface instead of Java reactive interface
- Handler annotations - addition allowing creation of annotation based handlers for requests and notifications
- Neovim notifications - addition allowing usage of notifications through Java 9 Flows interface and also provides data models for all neovim notifications
- API Explorer - simple JavaFX application used for testing library and exploring neovim API
Many features are not completely tested and this library was mostly built to experiment with Neovim RPC API, but there should be no issues with using this library.
To include this library right away and start working with Neovim, Neovim API is enough.
Include it in your dependencies:
Maven(Neovim API):
<dependency>
<groupId>com.ensarsarajcic.neovim.java</groupId>
<artifactId>neovim-api</artifactId>
<version>${neovimjava.version}</version>
</dependency>
Gradle(Neovim API):
compile 'com.ensarsarajcic.neovim.java:neovim-api:${neovimjava.version}'
Or if you prefer RxJava2, use Neovim Rx API:
Maven(Neovim Rx API):
<dependency>
<groupId>com.ensarsarajcic.neovim.java</groupId>
<artifactId>neovim-rx-api</artifactId>
<version>${neovimjava.version}</version>
</dependency>
Gradle(Neovim Rx API):
compile 'com.ensarsarajcic.neovim.java:neovim-rx-api:${neovimjava.version}'
If you wish to use latest SNAPSHOT version, it is available in Sonatype snapshots repository.
For more information, check out README of modules you are interested in.
Remote plugin support
This repository contains a small remote plugin example in rplugin-example
. To run this example run mvn package
and run Neovim with provided vimrc by calling nvim -u rplugin-example/vimrc
from project root.
It should be possible to then call the :NeovimJavaIncrementCount
command which communicated with java plugin.