Skip to content

docs: recommend declaring the Rust MSRV - #3317

Merged
messense merged 1 commit into
PyO3:mainfrom
1998LJ:docs/recommend-rust-version
Oct 8, 2026
Merged

messense merged 1 commit into
PyO3:mainfrom
1998LJ:docs/recommend-rust-version

Conversation

@1998LJ

@1998LJ 1998LJ commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Closes #2452.

Adds a short project-layout guide section recommending that distributable projects declare package.rust-version (MSRV) in Cargo.toml.

The guidance explains why this matters beyond diagnostics: Cargo 1.83+ defaults new or updated lockfiles to format v4, which Rust versions before 1.78 cannot read, while an explicit MSRV lets Cargo choose a compatible lockfile format.

Also links to Cargo's rust-version reference for the full behavior.

Docs-only change; no runtime behavior is modified.

@messense
messense merged commit 05590e7 into PyO3:main Oct 8, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Please recommend package.rust-version in Cargo.toml

2 participants