Skip to content

Commit

Permalink
docs(configuration): clarify uv.toml precedence
Browse files Browse the repository at this point in the history
  • Loading branch information
mkniewallner committed Sep 3, 2024
1 parent 8403a6d commit 333f8ec
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions docs/configuration/files.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,12 @@ uv will also search for `uv.toml` files, which follow an identical structure, bu
index-url = "https://test.pypi.org/simple"
```

!!! note

`uv.toml` files take precedence over `pyproject.toml` ones, so if both `uv.toml` and
`pyproject.toml` files are used in a directory, configuration will be read from `uv.toml`, and
`[tool.uv]` section in `pyproject.toml` will be ignored.

uv will also discover user-level configuration at `~/.config/uv/uv.toml` (or
`$XDG_CONFIG_HOME/uv/uv.toml`) on macOS and Linux, or `%APPDATA%\uv\uv.toml` on Windows. User-level
configuration must use the `uv.toml` format, rather than the `pyproject.toml` format, as a
Expand Down

0 comments on commit 333f8ec

Please sign in to comment.