docs: add docs to uv python pin without a REQUEST argument (#9631)

Co-authored-by: Zanie Blue <contact@zanie.dev>
2025-08-04 19:08:04 +00:00 · 2024-12-04 20:27:49 +02:00 · 2024-12-04 20:27:49 +02:00 · 231504b1d0
commit 231504b1d0
parent e85319e164
2 changed files with 13 additions and 3 deletions
--- a/crates/uv-cli/src/lib.rs
+++ b/crates/uv-cli/src/lib.rs
@ -4159,8 +4159,12 @@ pub enum PythonCommand {

    /// Pin to a specific Python version.
    ///
-    /// Writes the pinned version to a `.python-version` file, which is then
-    /// read by other uv commands when determining the required Python version.
+    /// Writes the pinned Python version to a `.python-version` file, which is used by other uv
+    /// commands to determine the required Python version.
+    ///
+    /// If no version is provided, uv will look for an existing `.python-version` file and display
+    /// the currently pinned version. If no `.python-version` file is found, uv will exit with an
+    /// error.
    ///
    /// See `uv help python` to view supported request formats.
    Pin(PythonPinArgs),
@ -4339,6 +4343,8 @@ pub struct PythonPinArgs {
    /// files, i.e., `pyenv`. If compatibility with those tools is needed, only
    /// use version numbers instead of complex requests such as `cpython@3.10`.
    ///
+    /// If no request is provided, the currently pinned version will be shown.
+    ///
    /// See `uv help python` to view supported request formats.
    pub request: Option<String>,