docs: add explicit example for opting package out of --exclude-newer (#18803)

<!--
Thank you for contributing to uv! To help us out with reviewing, please
consider the following:

- Does this pull request include a summary of the change? (See below.)
- Does this pull request include a descriptive title?
- Does this pull request include references to any relevant issues?
-->

## Summary

Add the explicit configuration for opting out a package out of
`--exclude-newer`. The docs mention this from
https://github.com/astral-sh/uv/pull/16854, but the actual
pyproject.toml configuration was missing. I found it from
https://github.com/astral-sh/uv/issues/12449#issuecomment-4170155721,
but this should be in the docs.

## Test Plan

uv run --only-group docs mkdocs serve -f mkdocs.yml

---------

Co-authored-by: Zanie Blue <contact@zanie.dev>
This commit is contained in:
Rex Ledesma
2026-04-01 16:40:20 -04:00
committed by GitHub
parent 9191802665
commit 08577895ae
+10 -2
View File
@@ -721,8 +721,16 @@ Values may also be specified for specific packages, e.g.,
exclude-newer-package = { setuptools = "2006-12-02T02:07:43Z" }
```
The same flag also accepts `<package>=false` to opt a package out of the `--exclude-newer`
restriction, e.g., to allow resolving packages from an index that does not publish upload times.
The package option also accepts `<package>=false` to opt a package out of the restriction, e.g.,
`--exclude-newer-package setuptools=false`, or:
```pyproject.toml
[tool.uv]
exclude-newer-package = { setuptools = false }
```
This is useful to temporarily use a newer version of package or to allow resolving a package from an
index that does not publish upload times.
Package-specific values will take precedence over global values.