astral-sh/uv · error

The {directory_description} (`{directory_name}`) is not a va

Error message

The {directory_description} (`{directory_name}`) is not a valid package name. Please provide a package name with `--name`.

What it means

Error "The {directory_description} (`{directory_name}`) is not a valid package name. Please provide a package name with `--name`." thrown in astral-sh/uv.

Source

Thrown at crates/uv/src/commands/project/init.rs:134

                Some(name) => name,
                None => {
                    let directory_name = path
                        .file_name()
                        .and_then(|path| path.to_str())
                        .context("Missing directory name")?;

                    // Pre-normalize the package name by removing any leading or trailing
                    // whitespace, and replacing any internal whitespace with hyphens.
                    let candidate = directory_name.trim().replace(' ', "-");
                    match PackageName::from_owned(candidate) {
                        Ok(name) => name,
                        Err(_) => {
                            let directory_description = if explicit_path.is_some() {
                                "target directory"
                            } else {
                                "current directory"
                            };
                            anyhow::bail!(
                                "The {directory_description} (`{directory_name}`) is not a valid package name. Please provide a package name with `--name`."
                            );
                        }
                    }
                }
            };

            Box::pin(init_project(
                &path,
                &name,
                project_kind,
                bare,
                description,
                no_description,
                vcs,
                build_backend,
                no_readme,
                author_from,

View on GitHub (pinned to f1a42680ff)

When it happens

Trigger: Thrown at crates/uv/src/commands/project/init.rs:134 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/6eb84a9fbee6fd50. Report an issue: GitHub.