Special-case reinstalls in environment update summaries

crates/distribution-types/src/any.rs

@@ -1,18 +1,22 @@
+use std::hash::Hash;
+
 use uv_normalize::PackageName;
 
 use crate::cached::CachedDist;
 use crate::installed::InstalledDist;
 use crate::{InstalledMetadata, InstalledVersion, Name};
 
 /// A distribution which is either installable, is a wheel in our cache or is already installed.
-#[derive(Debug, Clone)]
+///
+/// Note equality and hash operations are only based on the name and version, not the kind.
+#[derive(Debug, Clone, Eq)]
 #[allow(clippy::large_enum_variant)]
-pub enum LocalDist<'a> {
-    Cached(&'a CachedDist),
-    Installed(&'a InstalledDist),
+pub enum LocalDist {
+    Cached(CachedDist),
+    Installed(InstalledDist),
 }
 
-impl Name for LocalDist<'_> {
+impl Name for LocalDist {
     fn name(&self) -> &PackageName {
         match self {
             Self::Cached(dist) => dist.name(),
@@ -21,7 +25,7 @@ impl Name for LocalDist<'_> {
     }
 }
 
-impl InstalledMetadata for LocalDist<'_> {
+impl InstalledMetadata for LocalDist {
     fn installed_version(&self) -> InstalledVersion {
         match self {
             Self::Cached(dist) => dist.installed_version(),
@@ -30,14 +34,27 @@ impl InstalledMetadata for LocalDist<'_> {
     }
 }
 
-impl<'a> From<&'a CachedDist> for LocalDist<'a> {
-    fn from(dist: &'a CachedDist) -> Self {
+impl From<CachedDist> for LocalDist {
+    fn from(dist: CachedDist) -> Self {
         Self::Cached(dist)
     }
 }
 
-impl<'a> From<&'a InstalledDist> for LocalDist<'a> {
-    fn from(dist: &'a InstalledDist) -> Self {
+impl From<InstalledDist> for LocalDist {
+    fn from(dist: InstalledDist) -> Self {
         Self::Installed(dist)
     }
 }
+
+impl Hash for LocalDist {
+    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
+        self.name().hash(state);
+        self.installed_version().hash(state);
+    }
+}
+
+impl PartialEq for LocalDist {
+    fn eq(&self, other: &Self) -> bool {
+        self.name() == other.name() && self.installed_version() == other.installed_version()
+    }
+}

crates/distribution-types/src/cached.rs

@@ -13,22 +13,22 @@ use crate::{
 };
 
 /// A built distribution (wheel) that exists in the local cache.
-#[derive(Debug, Clone)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub enum CachedDist {
     /// The distribution exists in a registry, like `PyPI`.
     Registry(CachedRegistryDist),
     /// The distribution exists at an arbitrary URL.
     Url(CachedDirectUrlDist),
 }
 
-#[derive(Debug, Clone)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct CachedRegistryDist {
     pub filename: WheelFilename,
     pub path: PathBuf,
     pub hashes: Vec<HashDigest>,
 }
 
-#[derive(Debug, Clone)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct CachedDirectUrlDist {
     pub filename: WheelFilename,
     pub url: VerbatimUrl,

crates/distribution-types/src/installed.rs

@@ -16,7 +16,7 @@ use uv_normalize::PackageName;
 use crate::{DistributionMetadata, InstalledMetadata, InstalledVersion, Name, VersionOrUrlRef};
 
 /// A built distribution (wheel) that is installed in a virtual environment.
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub enum InstalledDist {
     /// The distribution was derived from a registry, like `PyPI`.
     Registry(InstalledRegistryDist),
@@ -30,14 +30,14 @@ pub enum InstalledDist {
     LegacyEditable(InstalledLegacyEditable),
 }
 
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct InstalledRegistryDist {
     pub name: PackageName,
     pub version: Version,
     pub path: PathBuf,
 }
 
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct InstalledDirectUrlDist {
     pub name: PackageName,
     pub version: Version,
@@ -47,21 +47,21 @@ pub struct InstalledDirectUrlDist {
     pub path: PathBuf,
 }
 
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct InstalledEggInfoFile {
     pub name: PackageName,
     pub version: Version,
     pub path: PathBuf,
 }
 
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct InstalledEggInfoDirectory {
     pub name: PackageName,
     pub version: Version,
     pub path: PathBuf,
 }
 
-#[derive(Debug, Clone, Hash)]
+#[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub struct InstalledLegacyEditable {
     pub name: PackageName,
     pub version: Version,

crates/distribution-types/src/lib.rs

@@ -115,7 +115,7 @@ impl std::fmt::Display for VersionOrUrlRef<'_> {
     }
 }
 
-#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
+#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub enum InstalledVersion<'a> {
     /// A PEP 440 version specifier, used to identify a distribution in a registry.
     Version(&'a Version),

crates/distribution-types/src/traits.rs

@@ -117,7 +117,7 @@ impl<T: DistributionMetadata> Verbatim for T {
 }
 
 // Implement `Display` for all known types that implement `Metadata`.
-impl std::fmt::Display for LocalDist<'_> {
+impl std::fmt::Display for LocalDist {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         write!(f, "{}{}", self.name(), self.installed_version())
     }

crates/uv/src/commands/mod.rs

@@ -113,11 +113,13 @@ pub(super) enum ChangeEventKind {
     Removed,
     /// The package was added to the environment.
     Added,
+    /// The package was reinstalled without changing versions.
+    Reinstalled,
 }
 
 #[derive(Debug)]
-pub(super) struct ChangeEvent<T: InstalledMetadata> {
-    dist: T,
+pub(super) struct ChangeEvent<'a, T: InstalledMetadata> {
+    dist: &'a T,
     kind: ChangeEventKind,
 }
 

crates/uv/src/commands/pip/loggers.rs

@@ -6,7 +6,7 @@ use itertools::Itertools;
 use owo_colors::OwoColorize;
 use rustc_hash::{FxBuildHasher, FxHashMap};
 
-use distribution_types::{InstalledMetadata, LocalDist, Name};
+use distribution_types::{InstalledMetadata, Name};
 use pep440_rs::Version;
 use uv_normalize::PackageName;
 
@@ -108,13 +108,22 @@ impl InstallLogger for DefaultInstallLogger {
             .uninstalled
             .iter()
             .map(|distribution| ChangeEvent {
-                dist: LocalDist::from(distribution),
+                dist: distribution,
                 kind: ChangeEventKind::Removed,
             })
             .chain(changelog.installed.iter().map(|distribution| ChangeEvent {
-                dist: LocalDist::from(distribution),
+                dist: distribution,
                 kind: ChangeEventKind::Added,
             }))
+            .chain(
+                changelog
+                    .reinstalled
+                    .iter()
+                    .map(|distribution| ChangeEvent {
+                        dist: distribution,
+                        kind: ChangeEventKind::Reinstalled,
+                    }),
+            )
             .sorted_unstable_by(|a, b| {
                 a.dist
                     .name()
@@ -142,6 +151,15 @@ impl InstallLogger for DefaultInstallLogger {
                         event.dist.installed_version().dimmed()
                     )?;
                 }
+                ChangeEventKind::Reinstalled => {
+                    writeln!(
+                        printer.stderr(),
+                        " {} {}{}",
+                        "~".yellow(),
+                        event.dist.name().bold(),
+                        event.dist.installed_version().dimmed()
+                    )?;
+                }
             }
         }
         Ok(())

crates/uv/src/commands/pip/operations.rs

@@ -3,13 +3,14 @@
 use anyhow::{anyhow, Context};
 use itertools::Itertools;
 use owo_colors::OwoColorize;
-use std::collections::BTreeSet;
+use std::collections::{BTreeSet, HashSet};
 use std::fmt::Write;
 use std::path::PathBuf;
 use tracing::debug;
 
 use distribution_types::{
-    CachedDist, Diagnostic, InstalledDist, ResolutionDiagnostic, UnresolvedRequirementSpecification,
+    CachedDist, Diagnostic, InstalledDist, LocalDist, ResolutionDiagnostic,
+    UnresolvedRequirementSpecification,
 };
 use distribution_types::{
     DistributionMetadata, IndexLocations, InstalledMetadata, Name, Resolution,
@@ -289,17 +290,38 @@ pub(crate) enum Modifications {
 #[derive(Debug, Clone, Default)]
 pub(crate) struct Changelog {
     /// The distributions that were installed.
-    pub(crate) installed: Vec<CachedDist>,
+    pub(crate) installed: HashSet<LocalDist>,
     /// The distributions that were uninstalled.
-    pub(crate) uninstalled: Vec<InstalledDist>,
+    pub(crate) uninstalled: HashSet<LocalDist>,
+    /// The distributions that were reinstalled.
+    pub(crate) reinstalled: HashSet<LocalDist>,
 }
 
 impl Changelog {
+    /// Create a [`Changelog`] from a list of installed and uninstalled distributions.
+    pub(crate) fn new(installed: Vec<CachedDist>, uninstalled: Vec<InstalledDist>) -> Self {
+        let mut uninstalled: HashSet<_> = uninstalled.into_iter().map(LocalDist::from).collect();
+
+        let (reinstalled, installed): (HashSet<_>, HashSet<_>) = installed
+            .into_iter()
+            .map(LocalDist::from)
+            .partition(|dist| uninstalled.contains(dist));
+
+        uninstalled.retain(|dist| !reinstalled.contains(dist));
+
+        Self {
+            installed,
+            uninstalled,
+            reinstalled,
+        }
+    }
+
     /// Create a [`Changelog`] from a list of installed distributions.
     pub(crate) fn from_installed(installed: Vec<CachedDist>) -> Self {
         Self {
-            installed,
-            uninstalled: vec![],
+            installed: installed.into_iter().map(LocalDist::from).collect(),
+            uninstalled: HashSet::default(),
+            reinstalled: HashSet::default(),
         }
     }
 
@@ -474,10 +496,7 @@ pub(crate) async fn install(
     }
 
     // Construct a summary of the changes made to the environment.
-    let changelog = Changelog {
-        installed: installs,
-        uninstalled: uninstalls,
-    };
+    let changelog = Changelog::new(installs, uninstalls);
 
     // Notify the user of any environment modifications.
     logger.on_complete(&changelog, printer)?;
@@ -619,6 +638,15 @@ fn report_dry_run(
                     event.version.dimmed()
                 )?;
             }
+            ChangeEventKind::Reinstalled => {
+                writeln!(
+                    printer.stderr(),
+                    " {} {}{}",
+                    "~".yellow(),
+                    event.name.bold(),
+                    event.version.dimmed()
+                )?;
+            }
         }
     }
 

crates/uv/tests/cache_prune.rs

@@ -224,8 +224,7 @@ fn prune_unzipped() -> Result<()> {
     Uninstalled 2 packages in [TIME]
     Installed 1 package in [TIME]
      - iniconfig==2.0.0
-     - source-distribution==0.0.1
-     + source-distribution==0.0.1
+     ~ source-distribution==0.0.1
     "###);
 
     requirements_txt.write_str(indoc! { r"