From 333f8eca731bd8aced7762521e06da1923683e26 Mon Sep 17 00:00:00 2001 From: Mathieu Kniewallner Date: Wed, 4 Sep 2024 00:59:06 +0200 Subject: [PATCH] docs(configuration): clarify `uv.toml` precedence --- docs/configuration/files.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/configuration/files.md b/docs/configuration/files.md index 122f251d5a34..ce90ba855aa1 100644 --- a/docs/configuration/files.md +++ b/docs/configuration/files.md @@ -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