feat: add --no-groups flag

Author: mkniewallner

crates/uv-cli/src/lib.rs

@@ -2707,6 +2707,10 @@ pub struct RunArgs {
     #[arg(long)]
     pub no_group: Vec<GroupName>,
 
+    /// Exclude dependencies from all dependency groups.
+    #[arg(long, conflicts_with_all = ["group", "no_group", "only_group"])]
+    pub no_groups: bool,
+
     /// Only include dependencies from the specified dependency group.
     ///
     /// May be provided multiple times.
@@ -2972,6 +2976,10 @@ pub struct SyncArgs {
     #[arg(long)]
     pub no_group: Vec<GroupName>,
 
+    /// Exclude dependencies from all dependency groups.
+    #[arg(long, conflicts_with_all = ["group", "no_group", "only_group"])]
+    pub no_groups: bool,
+
     /// Only include dependencies from the specified dependency group.
     ///
     /// May be provided multiple times.
@@ -3417,6 +3425,10 @@ pub struct TreeArgs {
     #[arg(long)]
     pub no_group: Vec<GroupName>,
 
+    /// Exclude dependencies from all dependency groups.
+    #[arg(long, conflicts_with_all = ["group", "no_group", "only_group"])]
+    pub no_groups: bool,
+
     /// Only include dependencies from the specified dependency group.
     ///
     /// May be provided multiple times.
@@ -3581,6 +3593,10 @@ pub struct ExportArgs {
     #[arg(long)]
     pub no_group: Vec<GroupName>,
 
+    /// Exclude dependencies from all dependency groups.
+    #[arg(long, conflicts_with_all = ["group", "no_group", "only_group"])]
+    pub no_groups: bool,
+
     /// Only include dependencies from the specified dependency group.
     ///
     /// May be provided multiple times.

crates/uv-configuration/src/dev.rs

@@ -1,5 +1,5 @@
+use either::Either;
 use std::borrow::Cow;
-
 use uv_normalize::{GroupName, DEV_DEPENDENCIES};
 
 #[derive(Debug, Default, Clone, Copy, PartialEq, Eq)]
@@ -73,6 +73,8 @@ pub enum GroupsSpecification {
         include: Vec<GroupName>,
         exclude: Vec<GroupName>,
     },
+    /// Exclude dependencies from all groups.
+    Exclude,
 }
 
 impl GroupsSpecification {
@@ -86,7 +88,7 @@ impl GroupsSpecification {
 
     /// Returns `true` if the specification allows for production dependencies.
     pub fn prod(&self) -> bool {
-        matches!(self, Self::Include { .. })
+        matches!(self, Self::Include { .. } | Self::Exclude)
     }
 
     /// Returns `true` if the specification is limited to a select set of groups.
@@ -118,16 +120,20 @@ impl GroupsSpecification {
                 [group] => Some(Cow::Owned(format!("--only-group {group}"))),
                 [..] => Some(Cow::Borrowed("--only-group")),
             },
+            Self::Exclude => Some(Cow::Borrowed("--no-groups")),
         }
     }
 
     /// Iterate over all groups referenced in the [`DevGroupsSpecification`].
     pub fn names(&self) -> impl Iterator<Item = &GroupName> {
         match self {
             GroupsSpecification::Include { include, exclude } => {
-                include.names().chain(exclude.iter())
+                Either::Left(include.names().chain(exclude.iter()))
+            }
+            GroupsSpecification::Only { include, exclude } => {
+                Either::Left(include.iter().chain(exclude.iter()))
             }
-            GroupsSpecification::Only { include, exclude } => include.iter().chain(exclude.iter()),
+            GroupsSpecification::Exclude => Either::Right(std::iter::empty()),
         }
     }
 
@@ -139,6 +145,7 @@ impl GroupsSpecification {
                 include.contains(group) && !exclude.contains(group)
             }
             GroupsSpecification::Only { include, .. } => include.contains(group),
+            GroupsSpecification::Exclude => false,
         }
     }
 }
@@ -178,6 +185,7 @@ impl DevGroupsSpecification {
         only_dev: bool,
         mut group: Vec<GroupName>,
         no_group: Vec<GroupName>,
+        no_groups: bool,
         mut only_group: Vec<GroupName>,
         all_groups: bool,
     ) -> Self {
@@ -191,7 +199,9 @@ impl DevGroupsSpecification {
             None
         };
 
-        let groups = if all_groups {
+        let groups = if no_groups {
+            Some(GroupsSpecification::Exclude)
+        } else if all_groups {
             Some(GroupsSpecification::Include {
                 include: IncludeGroups::All,
                 exclude: no_group,
@@ -376,6 +386,11 @@ impl DevGroupsManifest {
                     };
                 }
 
+                // If `--no-groups` was provided, exclude all groups.
+                if matches!(self.spec.groups(), Some(GroupsSpecification::Exclude)) {
+                    return false;
+                }
+
                 // If `--no-group` was provided, exclude the group from the list of defaults.
                 if let Some(GroupsSpecification::Include {
                     include: _,

crates/uv/src/settings.rs

@@ -300,6 +300,7 @@ impl RunSettings {
             no_dev,
             group,
             no_group,
+            no_groups,
             only_group,
             all_groups,
             module: _,
@@ -343,7 +344,7 @@ impl RunSettings {
                 extra.unwrap_or_default(),
             ),
             dev: DevGroupsSpecification::from_args(
-                dev, no_dev, only_dev, group, no_group, only_group, all_groups,
+                dev, no_dev, only_dev, group, no_group, no_groups, only_group, all_groups,
             ),
             editable: EditableMode::from_args(no_editable),
             modifications: if flag(exact, inexact).unwrap_or(false) {
@@ -960,6 +961,7 @@ impl SyncSettings {
             only_dev,
             group,
             no_group,
+            no_groups,
             only_group,
             all_groups,
             no_editable,
@@ -996,7 +998,7 @@ impl SyncSettings {
                 extra.unwrap_or_default(),
             ),
             dev: DevGroupsSpecification::from_args(
-                dev, no_dev, only_dev, group, no_group, only_group, all_groups,
+                dev, no_dev, only_dev, group, no_group, no_groups, only_group, all_groups,
             ),
             editable: EditableMode::from_args(no_editable),
             install_options: InstallOptions::new(
@@ -1316,6 +1318,7 @@ impl TreeSettings {
             no_dev,
             group,
             no_group,
+            no_groups,
             only_group,
             all_groups,
             locked,
@@ -1334,7 +1337,7 @@ impl TreeSettings {
 
         Self {
             dev: DevGroupsSpecification::from_args(
-                dev, no_dev, only_dev, group, no_group, only_group, all_groups,
+                dev, no_dev, only_dev, group, no_group, no_groups, only_group, all_groups,
             ),
             locked,
             frozen,
@@ -1397,6 +1400,7 @@ impl ExportSettings {
             only_dev,
             group,
             no_group,
+            no_groups,
             only_group,
             all_groups,
             header,
@@ -1432,7 +1436,7 @@ impl ExportSettings {
                 extra.unwrap_or_default(),
             ),
             dev: DevGroupsSpecification::from_args(
-                dev, no_dev, only_dev, group, no_group, only_group, all_groups,
+                dev, no_dev, only_dev, group, no_group, no_groups, only_group, all_groups,
             ),
             editable: EditableMode::from_args(no_editable),
             hashes: flag(hashes, no_hashes).unwrap_or(true),

crates/uv/tests/it/sync.rs

@@ -1259,6 +1259,20 @@ fn sync_dev() -> Result<()> {
      + sniffio==1.3.1
     "###);
 
+    // Using `--no-groups` should remove dev dependencies
+    uv_snapshot!(context.filters(), context.sync().arg("--no-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 5 packages in [TIME]
+    Uninstalled 3 packages in [TIME]
+     - anyio==4.3.0
+     - idna==3.6
+     - sniffio==1.3.1
+    "###);
+
     Ok(())
 }
 
@@ -1427,6 +1441,42 @@ fn sync_group() -> Result<()> {
     Audited 1 package in [TIME]
     "###);
 
+    uv_snapshot!(context.filters(), context.sync().arg("--all-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 10 packages in [TIME]
+    Installed 8 packages in [TIME]
+     + anyio==4.3.0
+     + certifi==2024.2.2
+     + charset-normalizer==3.3.2
+     + idna==3.6
+     + iniconfig==2.0.0
+     + requests==2.31.0
+     + sniffio==1.3.1
+     + urllib3==2.2.1
+    "###);
+
+    uv_snapshot!(context.filters(), context.sync().arg("--no-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 10 packages in [TIME]
+    Uninstalled 8 packages in [TIME]
+     - anyio==4.3.0
+     - certifi==2024.2.2
+     - charset-normalizer==3.3.2
+     - idna==3.6
+     - iniconfig==2.0.0
+     - requests==2.31.0
+     - sniffio==1.3.1
+     - urllib3==2.2.1
+    "###);
+
     Ok(())
 }
 
@@ -1528,6 +1578,20 @@ fn sync_include_group() -> Result<()> {
      + typing-extensions==4.10.0
     "###);
 
+    uv_snapshot!(context.filters(), context.sync().arg("--no-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 6 packages in [TIME]
+    Uninstalled 4 packages in [TIME]
+     - anyio==4.3.0
+     - idna==3.6
+     - iniconfig==2.0.0
+     - sniffio==1.3.1
+    "###);
+
     Ok(())
 }
 
@@ -1923,6 +1987,43 @@ fn sync_default_groups() -> Result<()> {
      - urllib3==2.2.1
     "###);
 
+    uv_snapshot!(context.filters(), context.sync().arg("--all-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 10 packages in [TIME]
+    Installed 8 packages in [TIME]
+     + anyio==4.3.0
+     + certifi==2024.2.2
+     + charset-normalizer==3.3.2
+     + idna==3.6
+     + requests==2.31.0
+     + sniffio==1.3.1
+     + typing-extensions==4.10.0
+     + urllib3==2.2.1
+    "###);
+
+    // Using `--no-groups` should exclude all groups
+    uv_snapshot!(context.filters(), context.sync().arg("--no-groups"), @r###"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+
+    ----- stderr -----
+    Resolved 10 packages in [TIME]
+    Uninstalled 8 packages in [TIME]
+     - anyio==4.3.0
+     - certifi==2024.2.2
+     - charset-normalizer==3.3.2
+     - idna==3.6
+     - iniconfig==2.0.0
+     - requests==2.31.0
+     - sniffio==1.3.1
+     - urllib3==2.2.1
+    "###);
+
     Ok(())
 }
 

docs/reference/cli.md

@@ -339,6 +339,8 @@ uv run [OPTIONS] [COMMAND]
 
 <p>May be provided multiple times.</p>
 
+</dd><dt><code>--no-groups</code></dt><dd><p>Exclude dependencies from all dependency groups</p>
+
 </dd><dt><code>--no-index</code></dt><dd><p>Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via <code>--find-links</code></p>
 
 </dd><dt><code>--no-progress</code></dt><dd><p>Hide all progress outputs.</p>
@@ -1699,6 +1701,8 @@ uv sync [OPTIONS]
 
 <p>May be provided multiple times.</p>
 
+</dd><dt><code>--no-groups</code></dt><dd><p>Exclude dependencies from all dependency groups</p>
+
 </dd><dt><code>--no-index</code></dt><dd><p>Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via <code>--find-links</code></p>
 
 </dd><dt><code>--no-install-package</code> <i>no-install-package</i></dt><dd><p>Do not install the given package(s).</p>
@@ -2417,6 +2421,8 @@ uv export [OPTIONS]
 
 <p>May be provided multiple times.</p>
 
+</dd><dt><code>--no-groups</code></dt><dd><p>Exclude dependencies from all dependency groups</p>
+
 </dd><dt><code>--no-hashes</code></dt><dd><p>Omit hashes in the generated output</p>
 
 </dd><dt><code>--no-header</code></dt><dd><p>Exclude the comment header at the top of the generated output file</p>
@@ -2773,6 +2779,8 @@ uv tree [OPTIONS]
 
 <p>May be provided multiple times.</p>
 
+</dd><dt><code>--no-groups</code></dt><dd><p>Exclude dependencies from all dependency groups</p>
+
 </dd><dt><code>--no-index</code></dt><dd><p>Ignore the registry index (e.g., PyPI), instead relying on direct URL dependencies and those provided via <code>--find-links</code></p>
 
 </dd><dt><code>--no-progress</code></dt><dd><p>Hide all progress outputs.</p>