Guardrails / rust

Rust edition is current enough

rust/edition-floor@v1

The package declares a Rust edition instead of falling back to the implied 2015 edition, and that edition is no older than the configured floor.

Id	rust/edition-floor
Version	v1
Category	rust
Default severity	warning
Interpreter	python3
Timeout	30 seconds
Violations tolerated	0
Collects	rust

Collectors

This guardrail doesn't gather anything itself. It relies on the collectors below, which the CLI runs once per build before any check, and reads what they found from GUARDRAIL_FACTS. If a collector collects nothing, this guardrail is skipped, not failed.

Collector	Gathers	Inputs it is given
rust	The Cargo build in the project directory: the crate it declares, the Rust version and edition it asks for, every workspace member, the dependencies each manifest names with where each comes from and whether it is pinned, and the lock file beside them.	projectDir

The inputs above are this guardrail's own inputs, passed straight through to the collector. Setting one in buildnote.json changes what is collected, and two guardrails configured the same way share a single collection.

Configuration

{
  "guardrails": {
      "failOn": "error",
      "checks": [
          {
              "use": "rust/edition-floor@v1",
              "severity": "warning",
              "with": {
                  "projectDir": ".",
                  "minEdition": "2021"
              },
              "exemptions": []
          }
      ]
  }
}

Inputs

Input	Description	Default	Environment variable
projectDir	Directory holding the project, relative to the directory the CLI runs in.	.	GUARDRAIL_INPUT_PROJECTDIR
minEdition	Oldest Rust edition accepted, given as its year. A declared edition below this is a violation.	2021	GUARDRAIL_INPUT_MINEDITION

How to fix

Declare the edition in Cargo.toml and migrate to it:

[package]
name = "widget"
edition = "2021"

cargo fix --edition

When the key is missing, Cargo assumes the 2015 edition, so the crate compiles under the module path resolution, closure capture and bare trait object rules that later editions changed. The compiler's suggestions then stop matching the code in front of you, and your dependencies are built under different rules from your own crate.

More in rust

• rust/lockfile-committed. The build commits Cargo.lock, so a rebuild of the same commit resolves the same crate versions.
• rust/no-git-dependencies. No manifest declares a dependency with a git source, so every crate in the build comes from a registry that versions it.
• rust/version-declared. The build names the Rust toolchain it compiles with. The toolchain is an exact release, not a moving channel, and it is no older than the configured floor.

All 4 rust guardrails