emacs-prelude/docs/modules/rust.md
Kostas Tsiligkiris 0c84593c19 [DOCS] Add module for Rust language
The rust.md was based on python.md module.
2022-04-11 21:52:53 +03:00

38 lines
1.3 KiB
Markdown

# Prelude Rust
!!! Note
This module builds on top of the shared [Programming](programming.md) module.
## Package Prerequisites
For the proper functioning of this module, you'll need to install the
following packages in your system:
* `rustc` (Rust compiler)
* `cargo` (Rust package manager)
* `rustfmt` (Rust tool for formatting code)
* `racer` (Rust completion tool, not necessary if `prelude-lsp` is enabled)
* `rls` (Rust Language Server, if the `prelude-lsp` feature is enabled)
## Rust Mode
Emacs comes with Rust programming support through the built-in
`rust-mode`. Whenever you are editing Rust code run <kbd>C-h m</kbd> to
look at the Rust mode key bindings.
## Syntax checking
Prelude ships with [Flycheck](https://github.com/flycheck/flycheck),
an on the fly syntax checker. Flycheck has support for Rust. Rust is
automatically setup in flycheck, by executing
`flycheck-rust-setup`. If the current file is part of a Cargo project,
flycheck is configured according to the Cargo project layout.
## Cargo integration
Along with `rust-mode`, `cargo-minor-mode` is also configured. You can
give cargo commands from inside the buffer to run cargo commands, like
<kbd>C-c C-c C-b</kbd> for `cargo-process-build`, <kbd>C-c C-c
C-t</kbd> for `cargo-process-test` and <kbd>C-c C-c C-r</kbd> for
`cargo-process-run`