astral-sh/uv

uv errors if the `pyproject.toml` is a directory

Open

#14,584 opened on Jul 13, 2025

View on GitHub
 (9 comments) (0 reactions) (0 assignees)Rust (3,111 forks)batch import
error messageshelp wanted

Repository metrics

Stars
 (84,934 stars)
PR merge metrics
 (Avg merge 6d 16h) (222 merged PRs in 30d)

Description

Summary

Any uv commands that I executed always return:

error: failed to read from file `/pyproject.toml`: Is a directory (os error 21)

Adding -v to all commands does not return other helpful error messages.

What I have tried:

  1. Remove cache
  2. Uninstall (includes removing python and tool dirs) and reinstall
  3. Remove cache, uninstall (including removing python and tool dirs), and reinstall

Could this be a duplicate issue? If yes, could you provide me the link? Appreciate the help.

Image

Platform

Pop!_OS jammy 22.04 x86_64

Version

uv 0.7.20

Python version

Python 3.12

Contributor guide

Research direction
The issue occurs when uv attempts to read `/pyproject.toml` but finds a directory. The error originates from file reading logic. To fix, add validation to check if the path is a regular file before reading, and emit a clear error message if it's a directory. Look in the configuration loading code, likely in `crates/uv/src/config.rs` or similar. Check the issue comments for any maintainer guidance or proposed approaches.
Tech stack
rust
Domain
clitooling
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70