Add --no-install-local option to uv sync, uv add and uv export (#15328)

<!--
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

<!-- What's the purpose of the change? What does it do, and why? -->

Closes #14866. Adds a `no-install-local` flag to the sync and export
commands that excludes locally defined packages from being installed.

This helps with if you're caching your virtual environment. You can
exclude local packages since they're more likely to change between
builds.

## Test Plan

snapshot test: `sync::no_install_local`
CI

## Notes
I made an `InstallOptions` struct to avoid a crate isolation issue I was
running into while implementing.

Thanks for maintaining this project!

Author: xaskii

crates/uv-cli/src/lib.rs

@@ -3435,6 +3435,14 @@ pub struct SyncArgs {
     #[arg(long)]
     pub no_install_workspace: bool,
 
+    /// Do not install local path dependencies
+    ///
+    /// Skips the current project, workspace members, and any other local (path or editable)
+    /// packages. Only remote/indexed dependencies are installed. Useful in Docker builds to cache
+    /// heavy third-party dependencies first and layer local packages separately.
+    #[arg(long)]
+    pub no_install_local: bool,
+
     /// Do not install the given package(s).
     ///
     /// By default, all of the project's dependencies are installed into the environment. The
@@ -3503,6 +3511,7 @@ pub struct SyncArgs {
         conflicts_with = "package",
         conflicts_with = "no_install_project",
         conflicts_with = "no_install_workspace",
+        conflicts_with = "no_install_local",
         conflicts_with = "extra",
         conflicts_with = "all_extras",
         conflicts_with = "no_extra",
@@ -3847,6 +3856,14 @@ pub struct AddArgs {
     /// allows optimal layer caching.
     #[arg(long, conflicts_with = "frozen", conflicts_with = "no_sync")]
     pub no_install_workspace: bool,
+
+    /// Do not install local path dependencies
+    ///
+    /// Skips the current project, workspace members, and any other local (path or editable)
+    /// packages. Only remote/indexed dependencies are installed. Useful in Docker builds to cache
+    /// heavy third-party dependencies first and layer local packages separately.
+    #[arg(long, conflicts_with = "frozen", conflicts_with = "no_sync")]
+    pub no_install_local: bool,
 }
 
 #[derive(Args)]
@@ -4239,6 +4256,14 @@ pub struct ExportArgs {
     #[arg(long, alias = "no-install-workspace")]
     pub no_emit_workspace: bool,
 
+    /// Do not include local path dependencies in the exported requirements.
+    ///
+    /// Omits the current project, workspace members, and any other local (path or editable)
+    /// packages from the export. Only remote/indexed dependencies are written. Useful for Docker
+    /// and CI flows that want to export and cache third-party dependencies first.
+    #[arg(long, alias = "no-install-local")]
+    pub no_emit_local: bool,
+
     /// Do not emit the given package(s).
     ///
     /// By default, all of the project's dependencies are included in the exported requirements

crates/uv-configuration/src/install_options.rs

@@ -4,12 +4,23 @@ use tracing::debug;
 
 use uv_normalize::PackageName;
 
+/// Minimal view of a package used to apply install filters.
+#[derive(Debug, Clone, Copy)]
+pub struct InstallTarget<'a> {
+    /// The package name.
+    pub name: &'a PackageName,
+    /// Whether the package refers to a local source (path, directory, editable, etc.).
+    pub is_local: bool,
+}
+
 #[derive(Debug, Clone, Default)]
 pub struct InstallOptions {
     /// Omit the project itself from the resolution.
     pub no_install_project: bool,
     /// Omit all workspace members (including the project itself) from the resolution.
     pub no_install_workspace: bool,
+    /// Omit all local packages from the resolution.
+    pub no_install_local: bool,
     /// Omit the specified packages from the resolution.
     pub no_install_package: Vec<PackageName>,
 }
@@ -18,27 +29,32 @@ impl InstallOptions {
     pub fn new(
         no_install_project: bool,
         no_install_workspace: bool,
+        no_install_local: bool,
         no_install_package: Vec<PackageName>,
     ) -> Self {
         Self {
             no_install_project,
             no_install_workspace,
+            no_install_local,
             no_install_package,
         }
     }
 
     /// Returns `true` if a package passes the install filters.
     pub fn include_package(
         &self,
-        package: &PackageName,
+        target: InstallTarget<'_>,
         project_name: Option<&PackageName>,
         members: &BTreeSet<PackageName>,
     ) -> bool {
+        let package_name = target.name;
         // If `--no-install-project` is set, remove the project itself.
         if self.no_install_project {
             if let Some(project_name) = project_name {
-                if package == project_name {
-                    debug!("Omitting `{package}` from resolution due to `--no-install-project`");
+                if package_name == project_name {
+                    debug!(
+                        "Omitting `{package_name}` from resolution due to `--no-install-project`"
+                    );
                     return false;
                 }
             }
@@ -51,24 +67,32 @@ impl InstallOptions {
             // is set.)
             if !self.no_install_project {
                 if let Some(project_name) = project_name {
-                    if package == project_name {
+                    if package_name == project_name {
                         debug!(
-                            "Omitting `{package}` from resolution due to `--no-install-workspace`"
+                            "Omitting `{package_name}` from resolution due to `--no-install-workspace`"
                         );
                         return false;
                     }
                 }
             }
 
-            if members.contains(package) {
-                debug!("Omitting `{package}` from resolution due to `--no-install-workspace`");
+            if members.contains(package_name) {
+                debug!("Omitting `{package_name}` from resolution due to `--no-install-workspace`");
+                return false;
+            }
+        }
+
+        // If `--no-install-local` is set, remove local packages.
+        if self.no_install_local {
+            if target.is_local {
+                debug!("Omitting `{package_name}` from resolution due to `--no-install-local`");
                 return false;
             }
         }
 
         // If `--no-install-package` is provided, remove the requested packages.
-        if self.no_install_package.contains(package) {
-            debug!("Omitting `{package}` from resolution due to `--no-install-package`");
+        if self.no_install_package.contains(package_name) {
+            debug!("Omitting `{package_name}` from resolution due to `--no-install-package`");
             return false;
         }
 

crates/uv-resolver/src/lock/export/mod.rs

@@ -303,7 +303,7 @@ impl<'lock> ExportableRequirements<'lock> {
             })
             .filter(|(_index, package)| {
                 install_options.include_package(
-                    &package.id.name,
+                    package.as_install_target(),
                     target.project_name(),
                     target.lock().members(),
                 )

crates/uv-resolver/src/lock/installable.rs

@@ -563,7 +563,7 @@ pub trait Installable<'lock> {
         install_options: &InstallOptions,
     ) -> Result<Node, LockError> {
         if install_options.include_package(
-            package.name(),
+            package.as_install_target(),
             self.project_name(),
             self.lock().members(),
         ) {

crates/uv-resolver/src/lock/mod.rs

@@ -19,7 +19,7 @@ use tracing::debug;
 use url::Url;
 
 use uv_cache_key::RepositoryUrl;
-use uv_configuration::{BuildOptions, Constraints};
+use uv_configuration::{BuildOptions, Constraints, InstallTarget};
 use uv_distribution::{DistributionDatabase, FlatRequiresDist};
 use uv_distribution_filename::{
     BuildTag, DistExtension, ExtensionError, SourceDistExtension, WheelFilename,
@@ -3123,6 +3123,14 @@ impl Package {
     pub fn resolved_dependency_groups(&self) -> &BTreeMap<GroupName, Vec<Dependency>> {
         &self.dependency_groups
     }
+
+    /// Returns an [`InstallTarget`] view for filtering decisions.
+    pub fn as_install_target(&self) -> InstallTarget<'_> {
+        InstallTarget {
+            name: self.name(),
+            is_local: self.id.source.is_local(),
+        }
+    }
 }
 
 /// Attempts to construct a `VerbatimUrl` from the given normalized `Path`.
@@ -3688,6 +3696,14 @@ impl Source {
             }
         }
     }
+
+    /// Check if a package is local by examining its source.
+    pub(crate) fn is_local(&self) -> bool {
+        matches!(
+            self,
+            Self::Path(_) | Self::Directory(_) | Self::Editable(_) | Self::Virtual(_)
+        )
+    }
 }
 
 #[derive(Clone, Debug, serde::Deserialize)]

crates/uv/src/commands/project/add.rs

@@ -71,6 +71,7 @@ pub(crate) async fn add(
     no_sync: bool,
     no_install_project: bool,
     no_install_workspace: bool,
+    no_install_local: bool,
     requirements: Vec<RequirementsSource>,
     constraints: Vec<RequirementsSource>,
     marker: Option<MarkerTree>,
@@ -738,6 +739,7 @@ pub(crate) async fn add(
         locked,
         no_install_project,
         no_install_workspace,
+        no_install_local,
         &defaulted_extras,
         &defaulted_groups,
         raw,
@@ -968,6 +970,7 @@ async fn lock_and_sync(
     locked: bool,
     no_install_project: bool,
     no_install_workspace: bool,
+    no_install_local: bool,
     extras: &ExtrasSpecificationWithDefaults,
     groups: &DependencyGroupsWithDefaults,
     raw: bool,
@@ -1154,7 +1157,12 @@ async fn lock_and_sync(
         extras,
         groups,
         EditableMode::Editable,
-        InstallOptions::new(no_install_project, no_install_workspace, vec![]),
+        InstallOptions::new(
+            no_install_project,
+            no_install_workspace,
+            no_install_local,
+            vec![],
+        ),
         Modifications::Sufficient,
         None,
         settings.into(),

crates/uv/src/lib.rs

@@ -1978,6 +1978,7 @@ async fn run_project(
                 args.no_sync,
                 args.no_install_project,
                 args.no_install_workspace,
+                args.no_install_local,
                 requirements,
                 constraints,
                 args.marker,

crates/uv/src/settings.rs

@@ -1221,6 +1221,7 @@ impl SyncSettings {
             exact,
             no_install_project,
             no_install_workspace,
+            no_install_local,
             no_install_package,
             locked,
             frozen,
@@ -1286,6 +1287,7 @@ impl SyncSettings {
             install_options: InstallOptions::new(
                 no_install_project,
                 no_install_workspace,
+                no_install_local,
                 no_install_package,
             ),
             modifications: if flag(exact, inexact, "inexact").unwrap_or(true) {
@@ -1377,6 +1379,7 @@ pub(crate) struct AddSettings {
     pub(crate) workspace: Option<bool>,
     pub(crate) no_install_project: bool,
     pub(crate) no_install_workspace: bool,
+    pub(crate) no_install_local: bool,
     pub(crate) install_mirrors: PythonInstallMirrors,
     pub(crate) refresh: Refresh,
     pub(crate) indexes: Vec<Index>,
@@ -1418,6 +1421,7 @@ impl AddSettings {
             no_workspace,
             no_install_project,
             no_install_workspace,
+            no_install_local,
         } = args;
 
         let dependency_type = if let Some(extra) = optional {
@@ -1521,6 +1525,7 @@ impl AddSettings {
             workspace: flag(workspace, no_workspace, "workspace"),
             no_install_project,
             no_install_workspace,
+            no_install_local,
             editable: flag(editable, no_editable, "editable"),
             extras: extra.unwrap_or_default(),
             refresh: Refresh::from(refresh),
@@ -1820,6 +1825,7 @@ impl ExportSettings {
             no_emit_project,
             no_emit_workspace,
             no_emit_package,
+            no_emit_local,
             locked,
             frozen,
             resolver,
@@ -1862,6 +1868,7 @@ impl ExportSettings {
             install_options: InstallOptions::new(
                 no_emit_project,
                 no_emit_workspace,
+                no_emit_local,
                 no_emit_package,
             ),
             output_file,