Add `--find-links` support for `uv pip list` by terror · Pull Request #16103 · astral-sh/uv

terror · 2025-10-02T15:50:07Z

Resolves #16095

This PR fixes uv pip list --outdated so --find-links locations impact the latest-version lookup. This wires flat indexes through the registry client even under --no-index, lets LatestClient::find_latest evaluate the same compatibility filters across both Simple API and flat metadata, and adds an integration test that installs from scripts/links to show the higher local release is reported.

charliermarsh · 2025-10-03T02:04:30Z

    ----- stderr -----
      × No solution found when resolving dependencies:
-      ╰─▶ Because first-local was not found in the provided package locations and second-local==0.1.0 depends on first-local, we can conclude that second-local==0.1.0 cannot be used.
+      ╰─▶ Because first-local was not found in the package registry and second-local==0.1.0 depends on first-local, we can conclude that second-local==0.1.0 cannot be used.


Do you know why these changed?

This path used to short-circuit with ErrorKind::NoIndex, but now since we're considering flat indexes (via --find-links), we end up getting a UnavailablePackage::NotFound rendering as 'not found in the package registry' instead.

I think this wording is actually a bit confusing, this is implying we did a registry lookup (even though we supplied --no-index) as opposed to just looking at the directories/URLs provided by --find-links. Something to address for sure.

terror · 2025-10-03T15:49:01Z

 #[derive(Default, Debug, Clone, PartialEq, Eq)]
 pub struct IndexUrls {
    indexes: Vec<Index>,
+    flat_indexes: Vec<Index>,


Was there a reason why we did not want to include flat_indexes here?

I'm not aware of any

Unfortunately I really can't remember. I'm sure there's a reason for it. Probably because historically we didn't query flat indexes in the registry client? Something like that?

terror · 2025-10-03T15:52:18Z

        }

        if results.is_empty() {
+            if self.index_urls.simple_indexes_disabled() {


This is a tad awkward, but this is here to keep the wording the same for the already_installed_local_path_dependent test.

konstin · 2025-10-16T21:29:26Z

 #[derive(Default, Debug, Clone, PartialEq, Eq)]
 pub struct IndexUrls {
    indexes: Vec<Index>,
+    flat_indexes: Vec<Index>,


I'm not aware of any

Made to address this comment: #16103 (comment) This PR sorts the distributions collected by `FlatIndexClient::read_from_directory` (used for `--find-links`) so results are ordered deterministically by filename and index.

charliermarsh · 2025-10-27T02:21:18Z

It's actually a bit hard for me to reason about how --find-links works now, because we create the FlatIndexClient and pass that around, but we're now also passing the flat_indexes to the registry client... Are they now being indexed twice?

astral-sh-bot · 2026-06-06T04:18:31Z

uv test inventory changes

This PR changes the tests when compared with the latest main baseline.

Added tests: 6
Removed tests: 0
Changed suites: 2

uv-client: +4 / -0

Added:

uv-client::registry_client::tests::no_index_disables_explicit_flat_index
uv-client::registry_client::tests::no_index_disables_explicit_simple_index
uv-client::registry_client::tests::no_index_disables_torch_simple_index
uv-client::registry_client::tests::simple_detail_does_not_fetch_legacy_find_links

Removed: none

uv::it: +2 / -0

Added:

uv::it::pip_install::find_links_multiple
uv::it::pip_list::list_outdated_find_links

Removed: none

Released on 2026-06-10. ### Enhancements - Add `--emit-index-url` and `--emit-find-links` to `uv export` ([#18370](#18370)) - Add `--find-links` support for `uv pip list` ([#16103](#16103)) - Group executable install errors during `uv python install` ([#19691](#19691)) - Use ICF in macOS release builds to reduce binary sizes ([#19615](#19615)) ### Preview features - Add initial hidden `uv upgrade` command ([#19678](#19678)) - Reject Git revisions in `uv upgrade` ([#19742](#19742)) ### Configuration - Recognize `UV_NO_INSTALL_PROJECT`, `UV_NO_INSTALL_WORKSPACE`, `UV_NO_INSTALL_LOCAL` ([#19323](#19323)) ### Performance - Speed up discovery of large workspaces ([#18311](#18311)) ### Bug fixes - Allow unknown preview flags with a warning again ([#19669](#19669)) - Apply dependency exclusions to direct requirements ([#19699](#19699)) - Avoid following external symlinks during cache clean ([#19682](#19682)) - Avoid following symlinks during cache prune ([#19543](#19543)) - Fix Git cache keys for worktrees and packed refs ([#19706](#19706)) - Make resolver error handling iterative to avoid stack overflows ([#19695](#19695)) - Pass `VIRTUAL_ENV` through `cygpath` inside `fish` on Windows ([#19703](#19703)) - Rebuild explicit local directory tool installs ([#19591](#19591)) - Validate egg top-level entries as identifiers ([#19679](#19679)) ### Documentation - Document `--find-links` caching behavior ([#19585](#19585)) - Add a small section for malware checks ([#19680](#19680))

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [ghcr.io/astral-sh/uv](https://github.com/astral-sh/uv) | stage | patch | `0.11.19` → `0.11.20` | --- ### Release Notes <details> <summary>astral-sh/uv (ghcr.io/astral-sh/uv)</summary> ### [`v0.11.20`](https://github.com/astral-sh/uv/blob/HEAD/CHANGELOG.md#01120) Released on 2026-06-10. ##### Enhancements - Add `--emit-index-url` and `--emit-find-links` to `uv export` ([#18370](astral-sh/uv#18370)) - Add `--find-links` support for `uv pip list` ([#16103](astral-sh/uv#16103)) - Group executable install errors during `uv python install` ([#19691](astral-sh/uv#19691)) - Use ICF in macOS release builds to reduce binary sizes ([#19615](astral-sh/uv#19615)) ##### Preview features - Add initial hidden `uv upgrade` command ([#19678](astral-sh/uv#19678)) - Reject Git revisions in `uv upgrade` ([#19742](astral-sh/uv#19742)) ##### Configuration - Recognize `UV_NO_INSTALL_PROJECT`, `UV_NO_INSTALL_WORKSPACE`, `UV_NO_INSTALL_LOCAL` ([#19323](astral-sh/uv#19323)) ##### Performance - Speed up discovery of large workspaces ([#18311](astral-sh/uv#18311)) ##### Bug fixes - Allow unknown preview flags with a warning again ([#19669](astral-sh/uv#19669)) - Apply dependency exclusions to direct requirements ([#19699](astral-sh/uv#19699)) - Avoid following external symlinks during cache clean ([#19682](astral-sh/uv#19682)) - Avoid following symlinks during cache prune ([#19543](astral-sh/uv#19543)) - Fix Git cache keys for worktrees and packed refs ([#19706](astral-sh/uv#19706)) - Make resolver error handling iterative to avoid stack overflows ([#19695](astral-sh/uv#19695)) - Pass `VIRTUAL_ENV` through `cygpath` inside `fish` on Windows ([#19703](astral-sh/uv#19703)) - Rebuild explicit local directory tool installs ([#19591](astral-sh/uv#19591)) - Validate egg top-level entries as identifiers ([#19679](astral-sh/uv#19679)) ##### Documentation - Document `--find-links` caching behavior ([#19585](astral-sh/uv#19585)) - Add a small section for malware checks ([#19680](astral-sh/uv#19680)) </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).  Co-authored-by: Renovate Bot <renovate@bhamm-lab.com> Reviewed-on: https://codeberg.org/blake-hamm/bhamm-lab/pulls/186

terror mentioned this pull request Oct 2, 2025

uv pip list --outdated does not use UV_FIND_LINKS #16095

Closed

charliermarsh reviewed Oct 3, 2025

View reviewed changes

terror commented Oct 3, 2025

View reviewed changes

terror marked this pull request as ready for review October 3, 2025 16:02

zanieb requested a review from charliermarsh October 8, 2025 13:46

konstin reviewed Oct 16, 2025

View reviewed changes

terror mentioned this pull request Oct 25, 2025

Deterministically order --find-links distributions #16446

Merged

charliermarsh approved these changes Oct 27, 2025

View reviewed changes

terror and others added 15 commits June 5, 2026 22:14

Add initial work

92d45bd

Remove result from test signature

e7484fe

Update snapshot

f4a4400

Tweak ordering

a4b8d5e

Sort flat index entries

26befb9

Keep existing message / semantics

22a559c

Combine flat indexes into IndexUrls

7ba1843

Split up functions

1bbffb1

Move the candidate filtering closure into a dedicated helper

4da8895

Drop exclude newer from snapshot tests

00c13b8

Merge candidates from all flat indexes

d2e7717

Honor no-index for simple registry lookups

0c7e74c

Combine candidates from legacy find-links

b142414

Disable explicit flat indexes with no-index

9b796f6

Limit find-links metadata to latest queries

9f36d2b

charliermarsh force-pushed the pip-list-outdated branch from 07ec46b to 9f36d2b Compare June 6, 2026 03:52

Simplify find-links metadata handling

9989be8

Separate find-links metadata fetching

3d0365f

charliermarsh force-pushed the pip-list-outdated branch from a253fd6 to 3d0365f Compare June 6, 2026 11:24

charliermarsh enabled auto-merge (squash) June 6, 2026 11:31

charliermarsh merged commit fd8fcd5 into astral-sh:main Jun 6, 2026
108 of 110 checks passed

konstin added the enhancement New feature or improvement to existing functionality label Jun 10, 2026

konstin mentioned this pull request Jun 10, 2026

Bump version to 0.11.20 #19765

Merged

BrewTestBot mentioned this pull request Jun 10, 2026

uv 0.11.20 Homebrew/homebrew-core#287331

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add `--find-links` support for `uv pip list`#16103

Add `--find-links` support for `uv pip list`#16103
charliermarsh merged 17 commits into
astral-sh:mainfrom
terror:pip-list-outdated

terror commented Oct 2, 2025

Uh oh!

charliermarsh Oct 3, 2025

Uh oh!

terror Oct 3, 2025

Uh oh!

terror Oct 3, 2025

Uh oh!

terror Oct 3, 2025

Uh oh!

konstin Oct 16, 2025

Uh oh!

charliermarsh Oct 16, 2025

Uh oh!

terror Oct 3, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

konstin Oct 16, 2025

Uh oh!

charliermarsh commented Oct 27, 2025

Uh oh!

astral-sh-bot Bot commented Jun 6, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

terror commented Oct 2, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

charliermarsh commented Oct 27, 2025

Uh oh!

astral-sh-bot Bot commented Jun 6, 2026

uv test inventory changes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants