Add --no-project alias for uv python pin --no-workspace

crates/uv-cli/src/lib.rs

@@ -3060,13 +3060,13 @@ pub struct PythonPinArgs {
  #[arg(long, overrides_with("no_resolved"), hide = true)]
  pub no_resolved: bool,
 
- /// Avoid validating the Python pin is compatible with the workspace.
+ /// Avoid validating the Python pin is compatible with the project or workspace.
  ///
- /// By default, a workspace is discovered in the current directory or any parent
- /// directory. If a workspace is found, the Python pin is validated against
- /// the workspace's `requires-python` constraint.
- #[arg(long)]
- pub no_workspace: bool,
+ /// By default, a project or workspace is discovered in the current directory or any parent
+ /// directory. If a workspace is found, the Python pin is validated against the workspace's
+ /// `requires-python` constraint.
+ #[arg(long, alias = "no-workspace")]
+ pub no_project: bool,
 }
 
 #[derive(Args)]

crates/uv/src/commands/python/pin.rs

@@ -22,11 +22,11 @@ pub(crate) async fn pin(
  request: Option<String>,
  resolved: bool,
  python_preference: PythonPreference,
- no_workspace: bool,
+ no_project: bool,
  cache: &Cache,
  printer: Printer,
 ) -> Result<ExitStatus> {
- let virtual_project = if no_workspace {
+ let virtual_project = if no_project {
  None
  } else {
  match VirtualProject::discover(&CWD, &DiscoveryOptions::default()).await {

crates/uv/src/lib.rs

@@ -944,7 +944,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
  args.request,
  args.resolved,
  globals.python_preference,
- args.no_workspace,
+ args.no_project,
  &cache,
  printer,
  )

crates/uv/src/settings.rs

@@ -590,7 +590,7 @@ impl PythonFindSettings {
 pub(crate) struct PythonPinSettings {
  pub(crate) request: Option<String>,
  pub(crate) resolved: bool,
- pub(crate) no_workspace: bool,
+ pub(crate) no_project: bool,
 }
 
 impl PythonPinSettings {
@@ -601,13 +601,13 @@ impl PythonPinSettings {
  request,
  no_resolved,
  resolved,
- no_workspace,
+ no_project,
  } = args;
 
  Self {
  request,
  resolved: flag(resolved, no_resolved).unwrap_or(false),
- no_workspace,
+ no_project,
  }
  }
 }

crates/uv/tests/python_pin.rs

@@ -264,17 +264,38 @@ fn python_pin_compatible_with_requires_python() -> anyhow::Result<()> {
  error: The requested Python version `[email protected]` is incompatible with the project `requires-python` value of `>=3.11`.
  "###);
 
+ // Request an incompatible version with project discovery turned off
+ uv_snapshot!(context.filters(), context.python_pin().arg("[email protected]").arg("--no-project"), @r###"
+ success: true
+ exit_code: 0
+ ----- stdout -----
+ Pinned `.python-version` to `[email protected]`
+
+ ----- stderr -----
+ "###);
+
+ // And, as an alias, workspace discovery
+ uv_snapshot!(context.filters(), context.python_pin().arg("[email protected]").arg("--no-workspace"), @r###"
+ success: true
+ exit_code: 0
+ ----- stdout -----
+ Pinned `.python-version` to `[email protected]`
+
+ ----- stderr -----
+ "###);
+
  // Request a complex version range that resolves to an incompatible version
  uv_snapshot!(context.filters(), context.python_pin().arg(">3.8,<3.11"), @r###"
  success: true
  exit_code: 0
  ----- stdout -----
- Pinned `.python-version` to `>3.8, <3.11`
+ Updated `.python-version` from `[email protected]` -> `>3.8, <3.11`
 
  ----- stderr -----
  warning: The requested Python version `>3.8, <3.11` resolves to `3.10.[X]` which is incompatible with the project `requires-python` value of `>=3.11`.
  "###);
 
+ // Request a version that is compatible
  uv_snapshot!(context.filters(), context.python_pin().arg("3.11"), @r###"
  success: true
  exit_code: 0

docs/reference/cli.md

@@ -3293,11 +3293,11 @@ uv python pin [OPTIONS] [REQUEST]
 
 <p>For example, spinners or progress bars.</p>
 
-</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python.</p>
+</dd><dt><code>--no-project</code></dt><dd><p>Avoid validating the Python pin is compatible with the project or workspace.</p>
 
-</dd><dt><code>--no-workspace</code></dt><dd><p>Avoid validating the Python pin is compatible with the workspace.</p>
+<p>By default, a project or workspace is discovered in the current directory or any parent directory. If a workspace is found, the Python pin is validated against the workspace&#8217;s <code>requires-python</code> constraint.</p>
 
-<p>By default, a workspace is discovered in the current directory or any parent directory. If a workspace is found, the Python pin is validated against the workspace&#8217;s <code>requires-python</code> constraint.</p>
+</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python.</p>
 
 </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>