diff --git a/docs/reference/policies/index.md b/docs/reference/policies/index.md index 3dd5a19fe9878..6e4f68755101c 100644 --- a/docs/reference/policies/index.md +++ b/docs/reference/policies/index.md @@ -2,4 +2,6 @@ - [Versioning](./versioning.md) - [Platform support](./platforms.md) +- [Python support](./python.md) +- [Rust support](./rust.md) - [License](./license.md) diff --git a/docs/reference/policies/platforms.md b/docs/reference/policies/platforms.md index cef025f26477e..546ded9f596b4 100644 --- a/docs/reference/policies/platforms.md +++ b/docs/reference/policies/platforms.md @@ -48,47 +48,3 @@ The minimum supported Windows versions are Windows 10 and Windows Server 2016, f uv supports macOS 13+ (Ventura). uv is known to work on macOS 12, but requires installation of a `realpath` executable. - -## Python support - -uv supports and is tested against the following Python versions: - -- 3.8 -- 3.9 -- 3.10 -- 3.11 -- 3.12 -- 3.13 -- 3.14 - -uv has Tier 1 support for the following Python implementations: - -- CPython - -As with platforms, Tier 1 support can be thought of "guaranteed to work". uv supports managed -installations of these implementations, and the builds are maintained by Astral. - -uv has Tier 2 support for: - -- PyPy -- GraalPy - -uv is "expected to work" with these implementations. uv also supports managed installations of these -Python implementations, but the builds are not maintained by Astral. - -uv has Tier 3 support for: - -- Pyston -- Pyodide - -uv "should work" with these implementations, but stability may vary. - -## Minimum supported Rust version - -The minimum supported Rust version required to compile uv is listed in the `rust-version` key of the -`[workspace.package]` section in `Cargo.toml`. It may change in any release (minor or patch). It -will never be newer than N-2 Rust versions, where N is the latest stable version. For example, if -the latest stable Rust version is 1.85, uv's minimum supported Rust version will be at most 1.83. - -This is only relevant to users who build uv from source. Installing uv from the Python package index -usually installs a pre-built binary and does not require Rust compilation. diff --git a/docs/reference/policies/python.md b/docs/reference/policies/python.md new file mode 100644 index 0000000000000..356b465059426 --- /dev/null +++ b/docs/reference/policies/python.md @@ -0,0 +1,37 @@ +# Python support + +## Python versions + +uv supports and is tested against the following Python versions: + +- 3.8 +- 3.9 +- 3.10 +- 3.11 +- 3.12 +- 3.13 +- 3.14 + +## Python implementations + +uv has Tier 1 support for the following Python implementations: + +- CPython + +As with [platforms](./platforms.md), Tier 1 support can be thought of "guaranteed to work". uv +supports managed installations of these implementations, and the builds are maintained by Astral. + +uv has Tier 2 support for: + +- PyPy +- GraalPy + +uv is "expected to work" with these implementations. uv also supports managed installations of these +Python implementations, but the builds are not maintained by Astral. + +uv has Tier 3 support for: + +- Pyston +- Pyodide + +uv "should work" with these implementations, but stability may vary. diff --git a/docs/reference/policies/rust.md b/docs/reference/policies/rust.md new file mode 100644 index 0000000000000..9d0dfd65f812c --- /dev/null +++ b/docs/reference/policies/rust.md @@ -0,0 +1,9 @@ +# Rust support + +The minimum supported Rust version required to compile uv is listed in the `rust-version` key of the +`[workspace.package]` section in `Cargo.toml`. It may change in any release (minor or patch). It +will never be newer than N-2 Rust versions, where N is the latest stable version. For example, if +the latest stable Rust version is 1.85, uv's minimum supported Rust version will be at most 1.83. + +This is only relevant to users who build uv from source. Installing uv from the Python package index +usually installs a pre-built binary and does not require Rust compilation. diff --git a/mkdocs.yml b/mkdocs.yml index 1609f60c28bf6..3c0224b54506d 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -258,6 +258,8 @@ nav: - reference/policies/index.md - Versioning: reference/policies/versioning.md - Platform support: reference/policies/platforms.md + - Python support: reference/policies/python.md + - Rust support: reference/policies/rust.md - License: reference/policies/license.md validation: omitted_files: warn