pioduino/uv
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Clarify that uv run uses inexact syncing by default (#17366)

Browse Source 
Closes #14230

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Zanie Blue
2026-01-09 07:20:42 -06:00
committed by GitHub
parent 85dedc8051
commit 21f76e8a2a
3 changed files with 22 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/concepts/projects/sync.md
+12 -4
View File
@@ -89,17 +89,25 @@ To opt-out of this behavior, use the `--no-editable` option.
If the project does not define a build system, it will not be installed.
See the [build systems](./config.md#build-systems) documentation for details.
### Retaining extraneous packages
### Handling of extraneous packages
Syncing is "exact" by default, which means it will remove any packages that are not present in the
lockfile.
`uv sync` performs "exact" syncing by default, which means it will remove any packages that are not
present in the lockfile.
To retain extraneous packages, use the `--inexact` option:
To retain extraneous packages, use the `--inexact` flag:
```console
$ uv sync --inexact
```
In contrast, `uv run` uses "inexact" syncing by default, ensuring that all required packages are
installed but not removing extraneous packages. To enable exact syncing with `uv run`, use the
`--exact` flag:
```console
$ uv run --exact ...
```
### Syncing optional dependencies
uv reads optional dependencies from the `[project.optional-dependencies]` table. These are