mirrors/uv
1
0
Fork 0
mirror of https://github.com/astral-sh/uv.git synced 2025-07-07 13:25:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Merge fb7fe63275 into f609e1ddaf

Browse source
This commit is contained in:
Christopher Broderick 2025-07-07 03:25:16 +02:00 • committed by GitHub
commit 11dd1847dd
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 38 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/concepts/projects/sync.md
View file

@ -146,6 +146,34 @@ The `foo` group would not be installed.
See the [development dependencies](./dependencies.md#development-dependencies) documentation for
details on how to manage development dependencies.
### Syncing workspaces
In a workspace setup, using `uv sync` in the project root folder will only sync the project package.
All workspace dependencies will be removed and the workspace packages will not be included in the
python path when running a python program using the `uv run` command. If you use `uv sync` in a
workspace folder, it will only sync the current workspace and the parent project. It will remove all
dependencies from the virtual environment that may have been installed for other workspaces in the
project and only the current workspace source code folder and the project root will be included in
the python path when running a python program using the `uv run` command.
To sync the entire workspace and have all workspace packages added to the python path when using the
`uv run` command, use the `--all-packages` option when running `uv sync` in the project root:
```console
$ uv sync --all-packages
```
To sync only specific packages in the workspace use the `--packages <package name>` option for each
package you wish to sync when running `uv sync` in the project root:
```console
$ uv sync --package beta --package delta
```
To prevent losing installed workspace dependencies when syncing 1 or more specific workspace
packages, use the `--inexact` option. This will also prevent removal of any workspace packages
automatically added to the python path when running a python program using the `uv run` command.
## Upgrading locked package versions
With an existing `uv.lock` file, uv will prefer the previously locked versions of packages when

10
docs/concepts/python-versions.md
View file

@ -229,6 +229,16 @@ project command invocations. The first Python version that is compatible with th
be used, unless a version is otherwise requested, e.g., via a `.python-version` file or the
`--python` flag.
If for some reason you need to change the default python version for your project after it has been
created use the [`uv python pin`](../reference/cli.md/#uv-python-pin) command specifying the desired
version:
```console
$ uv python pin 3.12
```
This will update the `.python-version` file for the project.
## Viewing available Python versions
To list installed and available Python versions: