Multiplex server for rust-analyzer, allows multiple LSP clients (editor
windows) to share a single rust-analyzer instance per cargo workspace.
The project has two binaries, ra-multiplex which is a thin wrapper that acts
like rust-analyzer but only connects to a TCP socket at 127.0.0.1:27631 and
pipes stdin and stdout through it.
The second binary ra-multiplex-server will listen on :27631 and spawn the
rust-analyzer server, depending on the working directory the ra-multiplex
client was spawned from it can reuse an already spawned rust-analyzer
instance. It detects workspace root as the furthermost ancestor directory
containing a Cargo.toml file. If the automatic workspace detection fails or
if you're not using rust-analyzer as a server you can create a marker file
.ra-multiplex-workspace-root in the directory you want to use as a workspace
root, the first ancestor directory containing this file will be used.
Because neither LSP nor rust-analyzer itself support multiple clients per
server ra-multiplex-server caches the handshake messages and modifies IDs of
requests & responses to track which response belongs to which client. Because
not all messages can be tracked this way it drops some, notably it drops any
requests from the server, this appears to not be a problem with
coc-rust-analyzer in neovim but YMMV.
If you have any problems you're welcome to open issues on this repository.
Build the project with
sh
$ cargo build --release
Run the ra-multiplex-server, make sure that rust-analyzer is in your
PATH:
sh
$ which rust-analyzer
/home/user/.cargo/bin/rust-analyzer
$ target/release/ra-multiplex-server
Configure your editor to use ra-multiplex as rust-analyzer, for example for
CoC in neovim edit ~/.config/nvim/coc-settings.json, add:
json
{
"rust-analyzer.serverPath": "/path/to/ra-multiplex"
}
Configuration is stored in a TOML file in your system's default configuration
directory, for example ~/.config/ra-multiplex/config.toml. If you're not sure
where that is on your system starting either ra-multiplex or
ra-multiplex-server without a config file present will print a warning with
the expected path.
Note that the configuration file is likely not necessary and ra-multiplex
should be usable with all defaults.
Example configuration file:
```toml
#
#
false for infinite timeoutinstance_timeout = 300 # after 5 minutes
gc_interval = 10 # every 10 seconds
#
#
listen = ["127.0.0.1", 27631] # localhost & some random unprivileged port
#
listenconnect = ["127.0.0.1", 27631] # same as listen
#
env_logger documentation here:log_filters = "info"
ra-multiplex client should process any arguments#
false, in this case ra-multiplex can be used asrust-analyzer but no other server. for morearg_parsing = false ```
Using other servers requires a bit more setup. First enable the arg_parse
option in ~/.config/ra-multiplex/config.toml:
toml
arg_parsing = true
Then for each server you want to use (including rust-analyzer) create a
wrapper script that passes the right arguments like in the following example.
We're using the standard cargo install directories so update the examples for
your needs.
Wrapper script rust-analyzer-proxy:
```sh
exec ~/.cargo/bin/ra-multiplex --server ~/.cargo/bin/rust-analyzer -- $@ ```
Wrapper script clangd-proxy:
```sh
exec ~/.cargo/bin/ra-multiplex --server /usr/bin/clangd -- --log=error $@ ```
Configure LSP client to use the wrapper script, for CoC
~/.config/nvim/coc-settings.json:
json
{
"rust-analyzer.serverPath": "/home/user/.cargo/bin/rust-analyzer-proxy",
"clangd.path": "/home/user/.cargo/bin/clangd-proxy"
}