695 commits

Author	SHA1	Message	Date
Zanie Blue	33446091d2	Improve the styling of collapsible nav items (#10692) ... I've been a bit unhappy with the collapsible project section. I think it feels a little crowded and consequently hard to read. Here, we tweak the styling to decrease the font size a little and increase the margins. I aimed for a subtle change — we can change it more drastically later if we want. Before <img width="1414" alt="Screenshot 2025-01-16 at 12 35 38 PM" src="https://github.com/user-attachments/assets/820b87c6-2988-4170-87ae-cec9a0f3b4fb" /> After <img width="1414" alt="Screenshot 2025-01-16 at 12 35 16 PM" src="https://github.com/user-attachments/assets/0d0cdb6b-a6c6-4fe1-a7f2-48f6fd70d5bc" />	2025-01-16 15:02:43 -06:00
Mathieu Kniewallner	b46c6db317	docs: fix a few typos (#10675) ... ## Summary Fixing a few typos found in the documentation and in comments.	2025-01-16 09:53:59 -05:00
Charlie Marsh	1c17662b37	Bump version to v0.5.20 (#10659)	2025-01-15 23:18:06 +00:00
Zanie Blue	a7f13e0e0b	Bump version to 0.5.19 (#10643)	2025-01-15 20:56:43 +00:00
FishAlchemist	9736868908	Add meta titles to documents in guides, excluding integration documents. (#10539) ... ## Summary Add meta titles to documents in guides, excluding integration documents. <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan ``uvx --with-requirements docs/requirements.txt -- mkdocs build --strict -f mkdocs.public.yml`` <details> <summary>Build Result</summary> * ``guides/install-python`` ```html ... <meta name="description" content="Guide to install specific Python versions, manage existing installations, and automate downloads with uv."> ... <title>Install and Manage Python | uv</title> ... ``` * ``guides/projects`` ```html ... <meta name="description" content="Guide to create, manage, and build Python projects with uv, including dependencies and distributions."> ... <title>Working on projects | uv</title> ... ``` * ``guides/publish`` ```html ... <meta name="description" content="Guide to build and publish Python packages using uv"> ... <title>Publishing a package | uv</title> ... ``` * ``guides/scripts`` ```html ... <meta name="description" content="Run Python scripts quickly and manage dependencies efficiently using uv. Learn about inline metadata and more."> ... <title>Run Scripts | uv</title> ... ``` * ``guides/tools`` ```html ... <meta name="description" content="Guide to run, install, and upgrade Python tools using uv."> ... <title>Using tools | uv</title> ... ``` </details> --------- Co-authored-by: Charles Tapley Hoyt <cthoyt@gmail.com> Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-01-15 14:12:55 -06:00
Mel Massadian	66e47345cb	docs(workspaces): remove build-system (#10636) ... ## Summary Unless I'm doing something wrong, specifying `hatchling` as a build system here results in `ValueError: Unable to determine which files to ship` ## Test Plan Following the instructions of the document. ## Additional Don't hesitate to discard	2025-01-15 11:46:35 -06:00
Aria Desires	80ac8db7db	Always spawn a main2 thread to normalize main stack size issues (#10479) ... Also removes UV_STACK_SIZE and uses RUST_MIN_STACK instead, tweaking docs to reflect the differences. Fixes #10367	2025-01-14 22:35:17 -05:00
Aria Desires	692171c718	add --output-format=json flag to uv python list (#10596) ... <!-- Thank you for contributing to uv! To help us out with reviewing, please consider the following: - Does this pull request include a summary of the change? (See below.) - Does this pull request include a descriptive title? - Does this pull request include references to any relevant issues? --> ## Summary I use `uv` for automation on remote hosts and it would be useful to have it be able to tell me the supported versions of python (for the remote machine) in a machine readable manner so I do not need to parse `uv python list`. This change adds `--format (json|text)` to `uv python list` to make it's output machine readable Loosely related: - https://github.com/astral-sh/uv/issues/411 ## Test Plan Manually tested via ``` # quick inspection without pretty print cargo run -- python list --format json ``` ### Short example of output (trimmed down) Cmd: `cargo run -- python list --format json | jq '.[:2]'` ```json [ { "key": "cpython-3.13.1+freethreaded-linux-x86_64-gnu", "version": "3.13.1", "version_parts": { "major": 3, "minor": 13, "patch": 1 }, "path": null, "symlink": null, "url": "20241219/cpython-3.13.1%2B20241219-x86_64-unknown-linux-gnu-freethreaded%2Bpgo%2Blto-full.tar.zst", "os": "linux", "variant": "freethreaded", "implementation": "cpython", "arch": "x86_64", "libc": "gnu" }, { "key": "cpython-3.13.1-linux-x86_64-gnu", "version": "3.13.1", "version_parts": { "major": 3, "minor": 13, "patch": 1 }, "path": "/usr/bin/python3.13", "symlink": null, "url": null, "os": "linux", "variant": "default", "implementation": "cpython", "arch": "x86_64", "libc": "gnu" } ] ``` --------- Co-authored-by: John Zlotek <jzlotek@gmail.com>	2025-01-14 11:47:49 -05:00
Eric Mark Martin	f261c65bdd	Implement pip freeze --path (#10488) ... ## Summary Resolves #5952 Add a `--path` option to `uv pip freeze` to be compatible with `pip freeze` ## Test Plan New snapshot tests --------- Co-authored-by: Charlie Marsh <charlie.r.marsh@gmail.com>	2025-01-13 22:50:04 +00:00
Sydney Duckworth	97c1877f6f	Add Git LFS support to uv-git crate (#10335) ... ## Summary Closes #3312. This PR adds Git LFS support to the `uv-git` crate by using the `git-lfs` CLI to fetch required LFS objects for a revision following the call to `git fetch`. The LFS fetch step is disabled by default and only enabled if the environment variable `UV_GIT_LFS` is set. When enabled, the LFS fetch step is run for all repositories regardless of whether they have associated LFS objects. The step is skipped if the `git-lfs` CLI tool isn't installed. ## Test Plan I verified that the minimal example in the linked issue passes, i.e. this command now succeeds: ```sh UV_GIT_LFS=1 uv pip install git+https://github.com/grebnetiew/lfs-py.git ``` I also verified that non-LFS repositories still work, with or without `git-lfs` installed. ### To Replicate Attempt to use uv to install a Git dependency that contains LFS objects (e.g. `uv pip install git+https://github.com/grebnetiew/lfs-py.git`). This should fail with a smudge filter error. Re-run the same command with the added environment variable `UV_GIT_LFS=1`. The install should now succeed. ## Potential Changes / Improvements ~With this change LFS objects in a given revision will always be downloaded if the user has Git LFS installed, which may not always be desired behavior. It might be helpful to add a field to the `uv` settings and/or an environment variable so that the LFS step can be disabled if needed.~ Enabling/disabled via environment variable has now been implemented. --------- Co-authored-by: Sydney Duckworth <sydduckworth@users.noreply.github.com> Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-01-13 21:48:06 +00:00
sergue1	15e20501d1	typo (#10538) ... fix typo in docs	2025-01-12 09:07:04 -06:00
Charlie Marsh	27d1bad550	Bump version to v0.5.18 (#10499)	2025-01-11 14:38:26 +00:00
Charlie Marsh	c198e2233e	Bump version to v0.5.17 (#10480)	2025-01-10 15:52:56 -05:00
Charlie Marsh	129a75e2d0	Add meta descriptions for remaining guides (#10450) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10418.	2025-01-09 17:39:00 -05:00
Charlie Marsh	d77598a08c	Use Windows-specific instructions in Jupyter guide (#10446) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10407.	2025-01-09 16:43:09 -05:00
FishAlchemist	201726cda5	docs: Clarify build system specific features usage. (#10261) ... ## Summary Since there are occasional inquiries about how to configure UV for build-system specific features, I want to raise awareness that users should refer to the documentation of the build system they are using for relevant settings. ## Test Plan Run docs service in local. 9821d58d35  --------- Signed-off-by: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com> Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-01-09 11:41:04 -06:00
Charlie Marsh	19589e0614	Add meta descriptions for some guides (#10421) ... ## Summary Part of: https://github.com/astral-sh/uv/issues/10418.	2025-01-09 15:50:16 +00:00
Charlie Marsh	58a81f7c47	Add uv lock --script to the docs (#10414)	2025-01-08 19:33:55 -05:00
Charlie Marsh	2e0d7429ef	Add Lambda layer instructions to AWS Lambda guide (#10411) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10406.	2025-01-08 22:12:52 +00:00
Charlie Marsh	18b53c5b45	Add --script support to uv export for PEP 723 scripts (#10160) ... ## Summary You can now run `uv export --script main.py` to show the dependency tree for a given script. If a lockfile doesn't exist, it will create one. Closes https://github.com/astral-sh/uv/issues/8609. Closes https://github.com/astral-sh/uv/issues/9657.	2025-01-08 21:48:53 +00:00
Charlie Marsh	9d5779b68c	Add --script support to uv tree for PEP 723 scripts (#10159) ... ## Summary You can now run `uv tree --script main.py` to show the dependency tree for a given script. If a lockfile doesn't exist, it will create one. Closes https://github.com/astral-sh/uv/issues/7328.	2025-01-08 21:32:46 +00:00
Charlie Marsh	5d33b94c42	Add support for locking PEP 723 scripts (#10135) ... ## Summary You can now run `uv lock --script main.py` to lock a given script (though as of this PR, the script itself isn't used anywhere). Closes https://github.com/astral-sh/uv/issues/6318.	2025-01-08 18:36:53 +00:00
Charlie Marsh	333f03f112	Bump version to v0.5.16 (#10395)	2025-01-08 10:29:32 -05:00
Charlie Marsh	4c0922ee1b	Add AWS Lambda integration guide (#10278) ... ## Summary This includes instructions to: - Deploy a standalone application. - Deploy an application that depends on local libraries (a workspace). - Deploy via Docker. - Deploy via zip. There's an accompanying Git repository here: https://github.com/astral-sh/uv-aws-lambda-example. Closes https://github.com/astral-sh/uv/issues/8935.	2025-01-07 13:50:31 -05:00
Kevin Marchais	a2a2662d43	Fix ruff linting warnings from generated template files for extension modules (#10371) ... ## Summary This PR fixes two ruff linting issues in the generated template files when using: `uv init --build-backend` for extension modules. 1. Removes unnecessary `from __future__ import annotations` imports from generated .pyi files ([PYI044](https://docs.astral.sh/ruff/rules/future-annotations-in-stub/)) 2. Adds missing blank line after `hello_from_bin` import to comply with isort formatting ([I001](https://docs.astral.sh/ruff/rules/unsorted-imports/)) ## Test Plan ```bash cargo run -- init --build-backend scikit-build-core example-ext uvx ruff check example-ext --select ALL cargo run -- init --build-backend maturin example-ext uvx ruff check example-ext --select ALL ``` ## Remaining warnings There are still warnings remainings in the generated `__init__.py` files: - [D104](https://docs.astral.sh/ruff/rules/undocumented-public-package/) Missing docstring in public package - [D103](https://docs.astral.sh/ruff/rules/undocumented-public-function/) Missing docstring in public function - [T201](https://docs.astral.sh/ruff/rules/print/) `print` found	2025-01-07 17:07:44 +00:00
csteiner	788df24460	docs: github actions example: remove unneeded install step (#10356) ... * Previously had uv python install, then uv sync --all-extras --dev * If we are going to use sync for dev dependencies, then the install step is unneccessary <!-- Thank you for contributing to uv! To help us out with reviewing, please consider the following: - Does this pull request include a summary of the change? (See below.) - Does this pull request include a descriptive title? - Does this pull request include references to any relevant issues? --> ## Summary <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan <!-- How was it tested? -->	2025-01-07 08:46:44 -05:00
Zanie Blue	eb6ad9a4fa	Bump version to 0.5.15 (#10337)	2025-01-06 18:04:25 -06:00
Olav Rønnestad Birkeland	1b34859d7e	docs: installation.md add info about installing with Scoop (#10332) ... <!-- Thank you for contributing to uv! To help us out with reviewing, please consider the following: - Does this pull request include a summary of the change? (See below.) - Does this pull request include a descriptive title? - Does this pull request include references to any relevant issues? --> ## Summary Add info about uv being available in Scoop. ## Test Plan `uvx --with-requirements .\docs\requirements.txt mkdocs serve --config-file mkdocs.public.yml` worked.	2025-01-06 13:18:01 -06:00
Charlie Marsh	09de67039b	Tweak script --no-project comment (#10331)	2025-01-06 13:41:44 -05:00
Trevor Manz	54b9e8ff82	Clarify exclude-newer only allows full timestamps in settings docs (#9135) ... <!-- Thank you for contributing to uv! To help us out with reviewing, please consider the following: - Does this pull request include a summary of the change? (See below.) - Does this pull request include a descriptive title? - Does this pull request include references to any relevant issues? --> ## Summary Follow up to #8553 Clarifies that the `exclude-newer` setting must be a full timestamp and not a date. <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan N/A <!-- How was it tested? -->	2025-01-06 10:03:21 -05:00
vladislav doster	523b88edf0	docs(tools.md): remove hyphenation for consistency (#10321)	2025-01-06 09:33:46 -05:00
vladislav doster	27bc8dd3dc	docs(python-versions.md): fix spelling (#10322) ... ## Summary Correct misspelling of `interopability` to `interoperability`. ## Test Plan N/A	2025-01-06 07:41:48 +00:00
Charlie Marsh	f7fc85f4e9	Respect FORCE_COLOR environment variable (#10315) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10303.	2025-01-06 02:18:16 +00:00
Charlie Marsh	9f1ba2b967	Bump version to v0.5.14 (#10279)	2025-01-02 14:31:04 -05:00
Savannah Ostrowski	a65aebb4f1	Fix small typo in editable packages docs (#10257) ... ## Summary Was reading through some of the docs and noticed this small typo in https://docs.astral.sh/uv/pip/packages/#editable-packages ## Test Plan Not applicable	2024-12-31 22:23:07 -05:00
Charlie Marsh	c77aa5820b	Add a required version setting to uv (#10248) ... ## Summary This follows Ruff's design exactly: you can provide a version specifier (like `>=0.5`), and we'll enforce it at runtime. Closes https://github.com/astral-sh/uv/issues/8605.	2024-12-31 15:37:46 +00:00
Charlie Marsh	4b5a89dbff	Add manylinux2014 aliases for --python-platform (#10217) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10210.	2024-12-29 01:36:02 +00:00
Arnav Gupta	3733008e6c	Add support for optional --description in uv init (#10209) ... ## Summary Closes #7913 by adding an optional `--description` argument to `uv init` that fills the description field in the pyproject.toml with the supplied arg value. Updated `uv init` docs to describe this new optional argument. <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan Added snapshot tests in `uv/crates/uv/tests/it/init.rs` to test this functionality. <!-- How was it tested? --> --------- Co-authored-by: Charlie Marsh <charlie.r.marsh@gmail.com>	2024-12-28 00:06:51 +00:00
Charlie Marsh	1fb7f352b1	Add --outdated support to uv pip tree (#10199) ... ## Summary Closes https://github.com/astral-sh/uv/issues/10181.	2024-12-27 17:03:06 +00:00
Charlie Marsh	49a2b6f85c	Add --exact flag to uv run (#10198) ... ## Summary `uv run --exact` will remove any unnecessary packages prior to running the given command. (By default, `uv run` uses "inexact" semantics.) Closes https://github.com/astral-sh/uv/issues/7838.	2024-12-27 16:43:30 +00:00
Charlie Marsh	4c49683f7b	Bump version to v0.5.13 (#10188)	2024-12-26 23:58:13 +00:00
Charlie Marsh	351d602d86	Bump version to v0.5.12 (#10175)	2024-12-26 14:16:19 -05:00
Charlie Marsh	0b5c0220b5	Allow environment variables to be included in cache keys (#10170) ... ## Summary Closes https://github.com/astral-sh/uv/issues/8130.	2024-12-26 15:31:49 +00:00
Mathieu Kniewallner	b24fb774b1	docs: fix invalid syntax in some sources examples (#10127) ... ## Summary TOML 1.0 doesn't support multi-line for inline tables, so those examples are invalid.	2024-12-23 16:12:45 -05:00
renovate[bot]	dae551d8d8	Update documentation references to astral-sh/setup-uv to v5 (#10117)	2024-12-23 08:47:28 -05:00
Charlie Marsh	2c68dfd4a9	Backtrack to non-local versions when wheels are missing platform support (#10046) ... ## Summary This is yet another variation on https://github.com/astral-sh/uv/pull/9928, with a few minor changes: 1. It only applies to local versions (e.g., `2.5.1+cpu`). 2. It only _considers_ the non-local version as an alternative (e.g., `2.5.1`). 3. It only _considers_ the non-local alternative if it _does_ support the unsupported platform. 4. Instead of failing, it falls back to using the local version. So, this is far less strict, and is effectively designed to solve PyTorch but nothing else. It's also not user-configurable, except by way of using `environments` to exclude platforms.	2024-12-20 19:11:27 +00:00
Zanie Blue	c4d0caaee5	Bump version to 0.5.11 (#10044)	2024-12-19 18:01:45 -06:00
Zanie Blue	8908e26de7	Add uv python install --preview to the documentation (#10010)	2024-12-19 16:07:46 -06:00
Charlie Marsh	2b0f8ffdee	Remove remaining references to deprecated first-match (#10038) ... ## Summary Missed these in https://github.com/astral-sh/uv/pull/10036.	2024-12-19 14:37:27 -05:00
Charlie Marsh	5a3826d9ff	Remove references to deprecated first-match (#10036) ... ## Summary This is a backwards-compatible alias for `first-index`. Closes https://github.com/astral-sh/uv/issues/10031.	2024-12-19 12:40:14 -05:00