uv-distribution-types 0.0.6

This is an internal component crate of uv
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use std::hash::Hash;

use uv_cache_key::CanonicalUrl;
use uv_normalize::PackageName;
use uv_pep440::Version;

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.
///
/// Note equality and hash operations are only based on the name and canonical version, not the
/// kind.
#[derive(Debug, Clone, Eq)]
#[allow(clippy::large_enum_variant)]
pub enum LocalDist {
    Cached(CachedDist, CanonicalVersion),
    Installed(InstalledDist, CanonicalVersion),
}

impl LocalDist {
    fn canonical_version(&self) -> &CanonicalVersion {
        match self {
            Self::Cached(_, version) => version,
            Self::Installed(_, version) => version,
        }
    }
}

impl Name for LocalDist {
    fn name(&self) -> &PackageName {
        match self {
            Self::Cached(dist, _) => dist.name(),
            Self::Installed(dist, _) => dist.name(),
        }
    }
}

impl InstalledMetadata for LocalDist {
    fn installed_version(&self) -> InstalledVersion<'_> {
        match self {
            Self::Cached(dist, _) => dist.installed_version(),
            Self::Installed(dist, _) => dist.installed_version(),
        }
    }
}

impl From<CachedDist> for LocalDist {
    fn from(dist: CachedDist) -> Self {
        let version = CanonicalVersion::from(dist.installed_version());
        Self::Cached(dist, version)
    }
}

impl From<InstalledDist> for LocalDist {
    fn from(dist: InstalledDist) -> Self {
        let version = CanonicalVersion::from(dist.installed_version());
        Self::Installed(dist, version)
    }
}

impl Hash for LocalDist {
    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
        self.name().hash(state);
        self.canonical_version().hash(state);
    }
}

impl PartialEq for LocalDist {
    fn eq(&self, other: &Self) -> bool {
        self.name() == other.name() && self.canonical_version() == other.canonical_version()
    }
}

/// Like [`InstalledVersion`], but with [`CanonicalUrl`] to ensure robust URL comparisons.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum CanonicalVersion {
    Version(Version),
    Url(CanonicalUrl, Version),
}

impl From<InstalledVersion<'_>> for CanonicalVersion {
    fn from(installed_version: InstalledVersion<'_>) -> Self {
        match installed_version {
            InstalledVersion::Version(version) => Self::Version(version.clone()),
            InstalledVersion::Url(url, version) => {
                Self::Url(CanonicalUrl::new(url), version.clone())
            }
        }
    }
}