Rust contribution layer for Spacemacs

Table of ContentsClose

1. Description
2. Install
3. Key bindings

1 Description

This layer supports Rust development in Spacemacs.

It has auto-completion and navigation support through Racer and supports Cargo.

2 Install

2.1 Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add rust to the existing dotspacemacs-configuration-layers list in this file.

2.2 Racer

You must install Racer to use this. Make sure the racer binary is available in your PATH and to set the environment variable RUST_SRC_PATH, as described in the installation instructions.

To enable auto-completion, ensure that the auto-completion layer is enabled.

2.3 Cargo

Cargo is a project management command line tool for Rust. Installation instructions can be found on the main page of Cargo.

2.4 Rustfmt

Format Rust code according to style guidelines using rustfmt.

cargo install rustfmt

To enable automatic buffer formatting on save, set the variable rust-format-on-save to t.

3 Key bindings

Key Binding	Description
`SPC m =`	reformat the buffer
`SPC m c .`	repeat the last Cargo command
`SPC m c C`	remove build artifacts with Cargo
`SPC m c X`	execute a project example with Cargo
`SPC m c c`	compile project with Cargo
`SPC m c d`	generate documentation with Cargo
`SPC m c e`	run benchmarks with Cargo
`SPC m c f`	run the current test with Cargo
`SPC m c i`	create a new project with Cargo (init)
`SPC m c n`	create a new project with Cargo (new)
`SPC m c o`	run all tests in current file with Cargo
`SPC m c s`	search for packages on crates.io with Cargo
`SPC m c u`	update dependencies with Cargo
`SPC m c x`	execute a project with Cargo
`SPC m g g`	jump to definition
`SPC m t`	run tests with Cargo