Add uv lock --script to the docs (#10414)

This commit is contained in:
Charlie Marsh 2025-01-08 19:33:55 -05:00 committed by GitHub
parent 5551f9f3da
commit 58a81f7c47
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -210,11 +210,30 @@ print(Point)
is not installed — see the documentation on [Python versions](../concepts/python-versions.md) for
more details.
## Locking dependencies
uv supports locking dependencies for PEP 723 scripts using the `uv.lock` file format. Unlike with
projects, scripts must be explicitly locked using `uv lock`:
```console
$ uv lock --script example.py
```
Running `uv lock --script` will create a `.lock` file adjacent to the script (e.g.,
`example.py.lock`).
Once locked, subsequent operations like `uv run --script`, `uv add --script`, `uv export --script`,
and `uv tree --script` will reuse the locked dependencies, updating the lockfile if necessary.
If no such lockfile is present, commands like `uv export --script` will still function as expected,
but will not create a lockfile.
## Improving reproducibility
uv supports an `exclude-newer` field in the `tool.uv` section of inline script metadata to limit uv
to only considering distributions released before a specific date. This is useful for improving the
reproducibility of your script when run at a later point in time.
In addition to locking dependencies, uv supports an `exclude-newer` field in the `tool.uv` section
of inline script metadata to limit uv to only considering distributions released before a specific
date. This is useful for improving the reproducibility of your script when run at a later point in
time.
The date must be specified as an [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html) timestamp
(e.g., `2006-12-02T02:07:43Z`).