Skip to content

MSRV_POLICY.md

Latest commit

 

History

History
24 lines (14 loc) · 1.65 KB

MSRV_POLICY.md

File metadata and controls

24 lines (14 loc) · 1.65 KB
Raw

Minimum Supported Rust Version (MSRV) policy

The current MSRV is Rust 1.89 (stable channel).

The MSRV is pinned in rust-toolchain.toml at the repository root and declared in every workspace crate via rust-version = "1.89".

How the MSRV evolves

  • Flaps does not commit to supporting Rust versions older than 1.89.
  • An MSRV bump is treated as a minor version bump per the semver policy. For example, raising the MSRV from 1.89 to 1.92 ships in a 0.X.0 release (or X.0.0 once at 1.0).
  • The current MSRV is documented in CHANGELOG.md under the Changed section of the release that bumps it.

Why we pick the floor we pick

  • 1.89 is the August 2026 Nubster open source fleet baseline.
  • The baseline is reviewed in February and August. Flaps may move ahead of it only for a concrete language, dependency, correctness, or security requirement.

How we verify the MSRV in CI

The repository CI pins rust-toolchain.toml to 1.89.0. The Format, Clippy and Build and test jobs all run on this exact toolchain, which guarantees that nothing newer slips in. A dedicated MSRV check job (cargo +1.89 check --workspace --all-features) runs on every pull request as an early warning on breakage introduced by upstream dependency changes.

Downstream impact

If you depend on a Flaps crate, the dependency resolver will refuse to compile your project on a Rust version older than the MSRV. In your Cargo.toml, you can pin a lower MSRV than ours only if you also pin Flaps to a version that supports it, which is documented per release in CHANGELOG.md.