Skip to content

Commit 0dd4d01

Browse files
authored
Link to Dependency specifiers instead of PEP 508 (#8411)
The canonical source is https://packaging.python.org/en/latest/specifications/dependency-specifiers/, not PEP 508 anymore, so we should link there and use the new name.
1 parent 40f842d commit 0dd4d01

File tree

4 files changed

+20
-14
lines changed

4 files changed

+20
-14
lines changed

crates/README.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ Utilities for interacting with Python version numbers and specifiers.
3333

3434
## [uv-pep508-rs](./uv-pep508)
3535

36-
Utilities for interacting with [PEP 508](https://peps.python.org/pep-0508/) dependency specifiers.
36+
Utilities for parsing and evaluating
37+
[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/),
38+
previously known as [PEP 508](https://peps.python.org/pep-0508/).
3739

3840
## [uv-platform-tags](./uv-platform-tags)
3941

crates/uv-pep508/Readme.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33
[![Crates.io](https://img.shields.io/crates/v/pep508_rs.svg?logo=rust&style=flat-square)](https://crates.io/crates/pep508_rs)
44
[![PyPI](https://img.shields.io/pypi/v/pep508_rs.svg?logo=python&style=flat-square)](https://pypi.org/project/pep508_rs)
55

6-
A library for python
6+
A library for
77
[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/),
8-
better known as [PEP 508](https://peps.python.org/pep-0508/).
8+
previously known as [PEP 508](https://peps.python.org/pep-0508/).
99

1010
## Usage
1111

crates/uv-pep508/src/lib.rs

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
//! A library for python [dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/)
2-
//! better known as [PEP 508](https://peps.python.org/pep-0508/)
1+
//! A library for [dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/)
2+
//! previously known as [PEP 508](https://peps.python.org/pep-0508/)
33
//!
44
//! ## Usage
55
//!

docs/concepts/dependencies.md

+13-9
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,10 @@ bird-feeder = { path = "./packages/bird-feeder" }
2828
## Project dependencies
2929

3030
The `project.dependencies` table represents the dependencies that are used when uploading to PyPI or
31-
building a wheel. Individual dependencies are specified using [PEP 508](#pep-508) syntax, and the
32-
table follows the [PEP 621](https://packaging.python.org/en/latest/specifications/pyproject-toml/)
33-
standard.
31+
building a wheel. Individual dependencies are specified using
32+
[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/)
33+
syntax, and the table follows the
34+
[PEP 621](https://packaging.python.org/en/latest/specifications/pyproject-toml/) standard.
3435

3536
`project.dependencies` defines the list of packages that are required for the project, along with
3637
the version constraints that should be used when installing them. Each entry includes a dependency
@@ -248,8 +249,8 @@ members = [
248249
### Platform-specific sources
249250

250251
You can limit a source to a given platform or Python version by providing
251-
[PEP 508](https://peps.python.org/pep-0508/#environment-markers)-compatible environment markers for
252-
the source.
252+
[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/)-compatible
253+
environment markers for the source.
253254

254255
For example, to pull `httpx` from GitHub, but only on macOS, use the following:
255256

@@ -320,7 +321,8 @@ installation of Excel parsers and `matplotlib` unless someone explicitly require
320321
requested with the `package[<extra>]` syntax, e.g., `pandas[plot, excel]`.
321322

322323
Optional dependencies are specified in `[project.optional-dependencies]`, a TOML table that maps
323-
from extra name to its dependencies, following [PEP 508](#pep-508) syntax.
324+
from extra name to its dependencies, following
325+
[dependency specifiers](#dependency-specifiers-pep-508) syntax.
324326

325327
Optional dependencies can have entries in `tool.uv.sources` the same as normal dependencies.
326328

@@ -437,10 +439,12 @@ Or, to opt-out of using an editable dependency in a workspace:
437439
$ uv add --no-editable ./path/foo
438440
```
439441

440-
## PEP 508
442+
## Dependency specifiers (PEP 508)
441443

442-
[PEP 508](https://peps.python.org/pep-0508/) defines a syntax for dependency specification. It is
443-
composed of, in order:
444+
uv uses
445+
[dependency specifiers](https://packaging.python.org/en/latest/specifications/dependency-specifiers/),
446+
previously known as [PEP 508](https://peps.python.org/pep-0508/). A dependency specifier is composed
447+
of, in order:
444448

445449
- The dependency name
446450
- The extras you want (optional)

0 commit comments

Comments
 (0)