Add a preview flag

Author: zsol

crates/uv-preview/src/lib.rs

@@ -26,6 +26,7 @@ bitflags::bitflags! {
         const WORKSPACE_DIR = 1 << 14;
         const WORKSPACE_LIST = 1 << 15;
         const SBOM_EXPORT = 1 << 16;
+        const AUTH_HELPER = 1 << 17;
     }
 }
 
@@ -52,6 +53,7 @@ impl PreviewFeatures {
             Self::WORKSPACE_DIR => "workspace-dir",
             Self::WORKSPACE_LIST => "workspace-list",
             Self::SBOM_EXPORT => "sbom-export",
+            Self::AUTH_HELPER => "auth-helper",
             _ => panic!("`flag_as_str` can only be used for exactly one feature flag"),
         }
     }
@@ -106,6 +108,7 @@ impl FromStr for PreviewFeatures {
                 "workspace-dir" => Self::WORKSPACE_DIR,
                 "workspace-list" => Self::WORKSPACE_LIST,
                 "sbom-export" => Self::SBOM_EXPORT,
+                "auth-helper" => Self::AUTH_HELPER,
                 _ => {
                     warn_user_once!("Unknown preview feature: `{part}`");
                     continue;

crates/uv/src/commands/auth/helper.rs

@@ -8,8 +8,9 @@ use tracing::debug;
 
 use uv_auth::{AuthBackend, Credentials, PyxTokenStore};
 use uv_client::BaseClientBuilder;
-use uv_preview::Preview;
+use uv_preview::{Preview, PreviewFeatures};
 use uv_redacted::DisplaySafeUrl;
+use uv_warnings::warn_user;
 
 use crate::{commands::ExitStatus, printer::Printer, settings::NetworkSettings};
 
@@ -126,6 +127,13 @@ pub(crate) async fn helper(
     network_settings: &NetworkSettings,
     printer: Printer,
 ) -> Result<ExitStatus> {
+    if !preview.is_enabled(PreviewFeatures::AUTH_HELPER) {
+        warn_user!(
+            "The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features {}` to disable this warning",
+            PreviewFeatures::AUTH_HELPER
+        );
+    }
+
     let request = BazelCredentialRequest::from_stdin()?;
 
     // TODO: make this logic generic over the protocol by providing `request.uri` from a

crates/uv/tests/it/auth.rs

@@ -1955,6 +1955,7 @@ fn bazel_helper_basic_auth() {
     {"headers":{"Authorization":["Basic dGVzdHVzZXI6dGVzdHBhc3M="]}}
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     "#
     );
 }
@@ -1988,6 +1989,7 @@ fn bazel_helper_token() {
     {"headers":{"Authorization":["Basic X190b2tlbl9fOm15dG9rZW4xMjM="]}}
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     "#
     );
 }
@@ -2007,6 +2009,7 @@ fn bazel_helper_no_credentials() {
     {"headers":{}}
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     "#
     );
 }
@@ -2026,6 +2029,7 @@ fn bazel_helper_invalid_json() {
     ----- stdout -----
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     error: Failed to parse credential request as JSON
       Caused by: expected ident at line 1 column 2
     "
@@ -2047,6 +2051,7 @@ fn bazel_helper_invalid_uri() {
     ----- stdout -----
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     error: Failed to parse credential request as JSON
       Caused by: relative URL without a base: "not a url" at line 1 column 18
     "#
@@ -2083,6 +2088,7 @@ fn bazel_helper_username_in_uri() {
     {"headers":{"Authorization":["Basic c3BlY2lmaWN1c2VyOnNwZWNpZmljcGFzcw=="]}}
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     "#
     );
 }
@@ -2117,6 +2123,7 @@ fn bazel_helper_unknown_username_in_uri() {
     {"headers":{}}
 
     ----- stderr -----
+    warning: The `uv auth helper` command is experimental and may change without warning. Pass `--preview-features auth-helper` to disable this warning
     "#
     );
 }