Chapter 3. The rustfmt formatting tool


With the rustfmt formatting tool, you can automatically format the source code of your Rust programs. You can use rusftmt either as a standalone tool or with Cargo.

3.1. Installing rustfmt

Complete the following steps to install the rustfmt formatting tool.

Prerequisites

Procedure

Run the following command to install rustfmt:

  • On Red Hat Enterprise Linux 8:

    # yum install rustfmt
    Copy to Clipboard Toggle word wrap
  • On Red Hat Enterprise Linux 9:

    # dnf install rustfmt
    Copy to Clipboard Toggle word wrap

3.2. Using rustfmt as a standalone tool

Use rustfmt as a standalone tool to format a Rust source file and all its dependencies. As an alternative, use rustfmt with the Cargo build tool. For more information, see Using rustfmt with Cargo.

Prerequisites

Procedure

To format a Rust source file using rustfmt as a standalone tool, run the following command:

  • On Red Hat Enterprise Linux 8:

    $ rustfmt <source-file>
    Copy to Clipboard Toggle word wrap
    • Replace <source_file> with the name of your source file.
      Alternatively, you can replace <source_file> with standard input. rustfmt then provides its output in standard output.
  • On Red Hat Enterprise Linux 9:

    $ rustfmt <source-file>
    Copy to Clipboard Toggle word wrap
    • Replace <source_file> with the name of your source file.
      Alternatively, you can replace <source_file> with standard input. rustfmt then provides its output in standard output.
Note

By default, rustfmt modifies the affected files without displaying details or creating backups. To display details and create backups, run rustfmt with the --write-mode value.

3.3. Using rustfmt with the Cargo build tool

Use the rustfmt tool with Cargo to format a Rust source file and all its dependencies.
As an alternative, use rustfmt as a standalone tool. For more information, see Using rustfmt as a standalone tool.

Prerequisites

Procedure

To format all source files in a Cargo code package, run the following command:

  • On Red Hat Enterprise Linux 8:

    $ cargo fmt
    Copy to Clipboard Toggle word wrap
  • On Red Hat Enterprise Linux 9:

    $ cargo fmt
    Copy to Clipboard Toggle word wrap
Note

To change the rustfmt formatting options, create the configuration file rustfmt.toml in the project directory and add your configurations to the file.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat