uv 0.11.25

A Python package and project manager
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

use anyhow::Result;

use uv_configuration::{
    BuildOptions, DependencyGroupsWithDefaults, ExtrasSpecification, InstallOptions,
};
use uv_distribution_types::Resolution;
use uv_normalize::{DefaultExtras, GroupName, PackageName};
use uv_python::Interpreter;
use uv_resolver::{Lock, Package};
use uv_workspace::VirtualProject;

use crate::commands::pip::{resolution_markers, resolution_tags};

/// A locked package selected for use as a project tool.
pub(crate) struct LockedTool<'lock> {
    package: &'lock Package,
    requires_separate_environment: bool,
}

impl<'lock> LockedTool<'lock> {
    pub(crate) fn package(&self) -> &'lock Package {
        self.package
    }

    /// Returns `true` if the tool must be installed outside the selected project environment.
    pub(crate) fn requires_separate_environment(&self) -> bool {
        self.requires_separate_environment
    }
}

/// Find a tool in a dependency group, falling back to the current project's production
/// dependencies.
pub(crate) fn find_locked_tool<'lock>(
    project: &VirtualProject,
    lock: &'lock Lock,
    interpreter: &Interpreter,
    package_name: &PackageName,
    dependency_group: &GroupName,
    groups: &DependencyGroupsWithDefaults,
) -> Result<Option<LockedTool<'lock>>> {
    let marker_environment = interpreter.resolver_marker_environment();
    let selection = lock
        .dependency_selection(
            project.project_name(),
            package_name,
            marker_environment.markers(),
        )
        .map_err(anyhow::Error::msg)?;
    let (package, installed) = if let Some(package) = selection.group(dependency_group) {
        (package, groups.contains(dependency_group))
    } else if let Some(package) = selection.production() {
        (package, groups.prod())
    } else {
        return Ok(None);
    };

    Ok(Some(LockedTool {
        package,
        requires_separate_environment: !installed,
    }))
}

/// Materialize the exact dependency subgraph rooted at a locked package.
pub(crate) fn resolution_from_lock(
    project: &VirtualProject,
    lock: &Lock,
    package: &Package,
    interpreter: &Interpreter,
    build_options: &BuildOptions,
) -> Result<Resolution> {
    let marker_environment = resolution_markers(None, None, interpreter);
    let tags = resolution_tags(None, None, interpreter)?;
    let extras = ExtrasSpecification::default().with_defaults(DefaultExtras::default());
    let groups = DependencyGroupsWithDefaults::none();
    Ok(lock.to_resolution(
        project.workspace().install_path(),
        [package],
        project.project_name(),
        &marker_environment,
        &tags,
        &extras,
        &groups,
        build_options,
        &InstallOptions::default(),
    )?)
}