prettier-plugin-rust

Prettier Rust

The massively popular Prettier code formatter, now with Rust support!

• Get Started: Search for the Prettier - Code formatter (Rust) extension in VSCode.

A formatter -- not a linter!

Prettier Rust doesn't panic on missing semicolons, in fact it AUTO-COMPLETES them!

Thanks to the specially built jinx-rust parser, Prettier is completely independent from Rust's strict validation process.
As such, it is able to format rust just like it formats typescript!

Configuration

Configure prettier by creating a .prettierrc.toml file, or any other file format listed in prettier docs.

To ignore files, list them in .prettierignore (like you would .gitignore)

API Option	CLI Option	Default	Docs
tabWidth	--tab-width	4	link
printWidth	--print-width	100	link
endOfLine	--end-of-line	"lf"	link
trailingComma	--trailing-comma		Not supported yet.
embeddedLanguageFormatting	--embedded-language-formatting		Not supported yet.

Ignoring stuff

To ignore something, add // prettier-ignore above it.

#[rustfmt::skip] and #![rustfmt::skip] are also supported (locally).

Installation

VSCode

• Either install the standalone extension Prettier - Code formatter (Rust) or

• use the official one which has issues loading plugins and will NOT auto-update them. Read about plugins in Prettier docs.

If you have rust-analyzer or another extension that formats rust files installed, VSCode will prompt you to choose your preferred formatter the next time you attempt to format a file. If you already had one defined, you may have to adjust your settings:

"[rust]": {
		"editor.defaultFormatter": "jinxdash.prettier-rust"
}

crate

Not available yet

npm

The plugin is published on npm as prettier-plugin-rust and can be used like any other prettier plugin.

npm install --save-dev prettier-plugin-rust

Refer to the Prettier documentation for available CLI commands.