Add uv python pin --rm to remove .python-version pins

Author: zanieb

crates/uv-cli/src/lib.rs

@@ -5032,6 +5032,10 @@ pub struct PythonPinArgs {
     /// directory, this version will be used instead.
     #[arg(long)]
     pub global: bool,
+
+    /// Remove the Python version pin.
+    #[arg(long, conflicts_with = "request", conflicts_with = "resolved")]
+    pub rm: bool,
 }
 
 #[derive(Args)]

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

@@ -27,6 +27,7 @@ pub(crate) async fn pin(
     python_preference: PythonPreference,
     no_project: bool,
     global: bool,
+    rm: bool,
     cache: &Cache,
     printer: Printer,
 ) -> Result<ExitStatus> {
@@ -56,6 +57,20 @@ pub(crate) async fn pin(
         PythonVersionFile::discover(project_dir, &VersionFileDiscoveryOptions::default()).await
     };
 
+    if rm {
+        if let Some(file) = version_file? {
+            fs_err::tokio::remove_file(file.path()).await?;
+            writeln!(
+                printer.stdout(),
+                "Removed Python version file at `{}`",
+                file.path().user_display()
+            )?;
+            return Ok(ExitStatus::Success);
+        } else {
+            bail!("No Python version file found");
+        }
+    }
+
     let Some(request) = request else {
         // Display the current pinned Python version
         if let Some(file) = version_file? {

crates/uv/src/lib.rs

@@ -1466,6 +1466,7 @@ async fn run(mut cli: Cli) -> Result<ExitStatus> {
                 globals.python_preference,
                 args.no_project,
                 args.global,
+                args.rm,
                 &cache,
                 printer,
             )

crates/uv/src/settings.rs

@@ -1056,6 +1056,7 @@ pub(crate) struct PythonPinSettings {
     pub(crate) resolved: bool,
     pub(crate) no_project: bool,
     pub(crate) global: bool,
+    pub(crate) rm: bool,
 }
 
 impl PythonPinSettings {
@@ -1068,13 +1069,15 @@ impl PythonPinSettings {
             resolved,
             no_project,
             global,
+            rm,
         } = args;
 
         Self {
             request,
             resolved: flag(resolved, no_resolved).unwrap_or(false),
             no_project,
             global,
+            rm,
         }
     }
 }

crates/uv/tests/it/python_pin.rs

@@ -2,6 +2,7 @@ use std::path::PathBuf;
 
 use crate::common::{TestContext, uv_snapshot};
 use anyhow::Result;
+use assert_cmd::assert::OutputAssertExt;
 use assert_fs::fixture::{FileWriteStr, PathChild, PathCreateDir};
 use insta::assert_snapshot;
 use uv_python::{
@@ -814,3 +815,63 @@ fn python_pin_with_comments() -> Result<()> {
 
     Ok(())
 }
+
+#[test]
+fn python_pin_rm() {
+    let context: TestContext = TestContext::new_with_versions(&["3.12"]);
+
+    uv_snapshot!(context.filters(), context.python_pin().arg("--rm"), @r"
+    success: false
+    exit_code: 2
+    ----- stdout -----
+
+    ----- stderr -----
+    error: No Python version file found
+    ");
+
+    // Remove the local pin
+    context.python_pin().arg("3.12").assert().success();
+    uv_snapshot!(context.filters(), context.python_pin().arg("--rm"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    Removed Python version file at `.python-version`
+
+    ----- stderr -----
+    ");
+
+    uv_snapshot!(context.filters(), context.python_pin().arg("--rm").arg("--global"), @r"
+    success: false
+    exit_code: 2
+    ----- stdout -----
+
+    ----- stderr -----
+    error: No Python version file found
+    ");
+
+    // Global does not detect the local pin
+    context.python_pin().arg("3.12").assert().success();
+    uv_snapshot!(context.filters(), context.python_pin().arg("--rm").arg("--global"), @r"
+    success: false
+    exit_code: 2
+    ----- stdout -----
+
+    ----- stderr -----
+    error: No Python version file found
+    ");
+
+    context
+        .python_pin()
+        .arg("3.12")
+        .arg("--global")
+        .assert()
+        .success();
+    uv_snapshot!(context.filters(), context.python_pin().arg("--rm").arg("--global"), @r"
+    success: true
+    exit_code: 0
+    ----- stdout -----
+    Removed Python version file at `[UV_USER_CONFIG_DIR]/.python-version`
+
+    ----- stderr -----
+    ");
+}