Working with TOML files

The highlighting and code style settings are applied to .toml files automatically. You can adjust the settings in Settings | Editor | Color Scheme | TOML and Settings | Editor | Code Style | TOML.

In Cargo.toml, you will see special hints alongside crate versions. These hints indicate the crate's version currently recorded in Cargo.lock as well as latest one (if available).

Code completion works for most manifest keys as well as Cargo features. You can also autocomplete local dependency paths and navigate to the source via click:

Gif

When specifying dependencies from crates.io, you can autocomplete their names and versions:

Gif

The IDE provides a dedicated UI for enabling/disabling Cargo workspace features. It also allows you to specify the target architecture, automatically filtering the appropriate workspace features.

For more information, refer to Support for conditional compilation.

You can navigate across Cargo features and jump to feature declarations from cfg and cfg_attr attributes:

Gif

The IDE runs a number of inspections to verify Cargo.toml. For example, it checks whether the referenced crates exist, whether their versions are up-to-date, and whether they are actually used within the code. It also detects any cyclic feature dependencies.

note

Currently, the inspections do not detect dependencies that are used exclusively within macro expansions.

Most problems can be fixed in one click – press AltEnter to view the options:

To view the full list of Cargo.toml inspections, go to Settings | Editor | Inspections and expand the Rust | Cargo.toml node:

You can also find inspection descriptions on Inspectopedia.

You will see a gutter icon next to each extern crate declaration – you can use it to quickly open the crate's description on docs.rs in your browser:

Gif