rust-mode: A major Emacs mode for editing Rust source code
rust-mode makes editing Rust code with Emacs
rust-mode requires Emacs 24 or later.
To install manually, check out this repository and add this to your
(add-to-list 'load-path "/path/to/rust-mode/") (autoload 'rust-mode "rust-mode" nil t) (add-to-list 'auto-mode-alist '("\\.rs\\'" . rust-mode))
.rs files. To enable it explicitly, do
package.el installation via MELPA
It can be more convenient to use Emacs's package manager to handle
installation for you if you use many elisp libraries. If you have
package.el but haven't added MELPA, the community
package source, yet, add this to
(require 'package) (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) (package-initialize)
Then do this to load the package listing:
- M-x eval-buffer
- M-x package-refresh-contents
MELPA stable only updates when a new version tag is created. There isn't a
specified frequency for this project to release versions; if you are a MELPA
stable user and feel that the last release tag is too far out of date, open a
pull request that updates the version header in
rust-mode.el and note that a
new version tag should be added when the request is merged.
See Pull Request #178 (the
first such pull request)) for an example of this.
One you have
package.el, you can install
rust-mode or any other
modes by choosing them from a list:
- M-x package-list-packages
Now, to install packages, move your cursor to them and press
i. This will mark the packages for installation. When
you're done with marking, press x, and ELPA will install
the packages for you (under
- or using M-x package-install rust-mode
Package installation on Debian testing or unstable
apt install elpa-rust-mode
Tests via ERT
rust-mode-tests.el contains tests that can be run via
You can use
run_rust_emacs_tests.sh to run them in batch mode, if
you set the environment variable EMACS to a program that runs emacs.
rust-format-buffer function will format your code with
rustfmt if installed. By default, this is bound to
(setq rust-format-on-save t) in your
~/.emacs will enable automatic
rust-format-buffer when you save a buffer.
rust-mode is distributed under the terms of both the MIT license and the
Apache License (Version 2.0).