astral-sh/uv · error · anyhow::Error

pip's `debug` is unsupported (consider using `uvx pip debug`

Error message

pip's `debug` is unsupported (consider using `uvx pip debug` instead)

What it means

Error "pip's `debug` is unsupported (consider using `uvx pip debug` instead)" thrown in astral-sh/uv.

Source

Thrown at crates/uv/src/lib.rs:1294

            show_settings!(args);

            // Initialize the cache.
            let cache = cache.init().await?;

            commands::pip_check(
                args.settings.python.as_deref(),
                args.settings.system,
                args.settings.python_version.as_ref(),
                args.settings.python_platform.as_ref(),
                &args.settings.dependency_metadata,
                &cache,
                printer,
            )
        }
        Commands::Pip(PipNamespace {
            command: PipCommand::Debug(_),
            ..
        }) => Err(anyhow!(
            "pip's `debug` is unsupported (consider using `uvx pip debug` instead)"
        )),
        Commands::Cache(CacheNamespace {
            command: CacheCommand::Clean(args),
        })
        | Commands::Clean(args) => {
            show_settings!(args);
            commands::cache_clean(&args.package, args.force, cache, printer, globals.preview).await
        }
        Commands::Cache(CacheNamespace {
            command: CacheCommand::Prune(args),
        }) => {
            show_settings!(args);
            commands::cache_prune(args.ci, args.force, cache, printer, globals.preview).await
        }
        Commands::Cache(CacheNamespace {
            command: CacheCommand::Dir,
        }) => commands::cache_dir(&cache, printer),

View on GitHub (pinned to f1a42680ff)

When it happens

Trigger: Thrown at crates/uv/src/lib.rs:1294 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of astral-sh/uv@f1a42680ff (2026-08-16). Data as JSON: /api/errors/a317290c931c884e. Report an issue: GitHub.