295 commits

Author	SHA1	Message	Date
Samay Kapadia	d9243cee7e	[docs] Add shebang section for scripts (#11553) ... <!-- 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 Documentation only. Adds a section in scripts.md about running uv scripts with a shebang line ## Test Plan n/a --------- Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-04-16 15:20:27 +00:00
Deividas / Dunixas	df35919d5a	teeny gramatical error in docs (#12908) ... <!-- 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? --> Incorrect use of the indefinite article- 'an project' instead of 'a project' ## Test Plan <!-- How was it tested? --> Was not tested due to it being a small change to docs wording without change in formatting.	2025-04-15 16:13:51 -05:00
Charlie Marsh	039b3c5dda	Refine lack of musl distributions to ARM-only (#12825)	2025-04-10 16:35:41 -05:00
johnthagen	719bab307c	Replace --frozen with --locked in Docker integration guide (#12818) ... ## Summary Replace `--frozen` with `--locked` in Docker integration guide. `--locked` additionally validates that `uv.lock` is "fresh"/up to date, which will catch errors if the user accidentally updated `pyproject.toml` but did not run `uv lock` before building the container. This is probably a better/safer default to recommend to users to avoid surprising/incorrect behavior. ## References - External guides already recommend using `--locked` instead of `--frozen` - https://hynek.me/articles/docker-uv/ - @zanieb seemed to indicate they might agree that `--locked` would be better to avoid surprises - https://github.com/astral-sh/uv/issues/10793#issuecomment-2743956736 ## Test Plan Used `--locked` in `uv` Python projects using Docker and validated that it works as expected.	2025-04-10 15:47:48 -04:00
johnthagen	59220ca507	Add --locked to uv sync in GitHub Actions guide (#12819) ... ## Summary Closes #10793 As requested by @konstin in - https://github.com/astral-sh/uv/issues/10793#issuecomment-2603869549	2025-04-10 15:47:00 -04:00
Zanie Blue	a4cec56dca	Bump to 0.6.14 (#12786)	2025-04-09 16:29:25 -05:00
Zanie Blue	1cca93c099	Bump version to 0.6.13 (#12725)	2025-04-07 13:44:32 -05:00
Zanie Blue	4a9dd27179	Bump to 0.6.12 (#12637)	2025-04-02 15:22:15 -05:00
Charlie Marsh	fe7fc323dd	Bump version to v0.6.11 (#12535)	2025-03-30 15:35:42 -04:00
Charlie Marsh	f2a2d982b8	Bump version to v0.6.10 (#12430)	2025-03-25 20:43:41 -04:00
Shlomo	20e7dcd366	docs: update dependency-bots.md (#12454) ... https://github.com/renovatebot/renovate/issues/30909 has already been resolved and released	2025-03-24 19:08:58 -04:00
Maxime	ec997b6fd2	Update PyTorch/Python version tip (#12402) ... PyTorch 2.6.0 supports Python 3.13, and publishes wheels for it. Update the tip to reflect this. ## Summary Clarify docs. ## Test Plan Look for "cp313" at the following URLs: - [x] https://download.pytorch.org/whl/cu124/torch/ - [x] https://download.pytorch.org/whl/torch/	2025-03-23 17:23:08 -04:00
Zanie Blue	3d94602784	Bump version to 0.6.9 (#12347)	2025-03-20 15:46:26 -05:00
Charlie Marsh	bf12cdbd37	Add experimental --torch-backend to the PyTorch guide (#12317)	2025-03-19 12:52:01 -04:00
Charlie Marsh	f7d9b0e2fa	Fix #keyring-provider references in alternative index docs (#12315) ... ## Summary I think editors auto-complete to this because of the way the Markdown is structured, but it's not quite right.	2025-03-19 16:40:22 +00:00
Zanie Blue	c1ef48276f	Bump version to 0.6.8 (#12297)	2025-03-18 14:18:27 -05:00
John Mumm	f66ce58a09	Simplify managed Python flags (#12246) ... Currently, for users to specify at the command line whether to use uv-managed or system Python interpreters, they use the `--python-preference` parameter, which takes four possible values. This is more complex than necessary since the normal case is to either say "only managed" or "not managed". This PR hides the old `--python-preference` parameter from help and documentation and adds two new flags: `--managed-python` and `--no-managed-python` to capture the "only managed" and "not managed" cases. I have successfully tested this locally but currently cannot add snapshot tests because of problems with distinguishing managed vs. system interpreters in CI (and non-determinism when run on different developers' machines). The `--python-preference` test in `tool-install.rs` is currently ignored for this reason. See #5144 and #7473. --------- Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-03-18 18:13:14 +01:00
Zanie Blue	6b733bdb3d	Bump version to 0.6.7 (#12250)	2025-03-17 18:18:21 -05:00
Charlie Marsh	040a5bbe5d	Add support for -c constraints in uv add (#12209) ... ## Summary Closes https://github.com/astral-sh/uv/issues/11986.	2025-03-17 21:27:33 +00:00
Charlie Marsh	3188d99f39	Use consistent commas around i.e. and e.g. (#12157) ... ## Summary Only in user-facing docs -- I didn't bother with the rustdoc. (This is in the style guide already.)	2025-03-13 23:42:10 +00:00
Eric Johnson	f5f712d75a	Make testpypi index explicit in example snippet (#12148) ... <!-- 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 Update this example snippet adding test.pypi.org as a publishing index to mark the index with `explicit = true`. This will help prevent users from unexpected behavior if no other indices are defined and users don't select a different index selection algorithm (with `--index-strategy`). When `test.pypi.org` is the selected index for package management, packages resolve to odd versions like 0.0.1 and `uv` spits out lots of errors. <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan N/A, documentation only change <!-- How was it tested? -->	2025-03-13 19:23:08 -04:00
Zanie Blue	c1a0bb85ea	Bump version to 0.6.6 (#12125)	2025-03-12 00:02:48 +00:00
samypr100	e096ab2411	Add support for Windows legacy scripts via uv tool run (#12079) ... ## Summary Follow up to https://github.com/astral-sh/uv/pull/11888 with added support for uv tool run. Changes * Added functionality for running windows scripts in previous PR was moved from run.rs to uv_shell::runnable. * EXE was added as a supported type, this simplified integration across both uv run and uvx while retaining a backwards compatible behavior and properly prioritizing .exe over others. Name was adjusted to runnable as a result to better represent intent. ## Test Plan New tests added. ## Documentation Added new documentation.	2025-03-11 09:02:17 -05:00
Zanie Blue	bcbcd0a1e5	Bump version to 0.6.5 (#12018)	2025-03-06 14:39:23 -06:00
Zanie Blue	f0ec9fd44a	Bump version to 0.6.4 (#11934)	2025-03-03 16:04:11 -06:00
Charlie Marsh	a1690203cf	Avoid fallback to PyPI in mixed CPU/CUDA example (#11115) ... ## Summary This is roughly equivalent, but gets the non-`+cpu` macOS build from the PyTorch index rather than PyPI. It seems a bit simpler? Though up for debate.	2025-03-02 22:35:32 -05:00
Mathieu Kniewallner	368f9a82d9	docs: rework alternative indexes documentation (#10826) ... ## Summary Closes #9867. Update alternative indexes documentation to use `[[tool.uv.index]]` and the associated environment variables instead of `UV_INDEX`. This also globally reworks the documentation by: - adding AWS CodeArtifact keyring example - adding packages publishing examples for all providers - making it more consistent for all providers It might be best to show how to publish packages only once for all providers, but the publish URL usually being different than the URL used to retrieve packages, even if this duplicates things, it might still be more straightforward for users to see exactly what is needed for each provider. ## Test Plan Manually tested retrieving packages from AWS CodeArtifact and GCP Artifact Registry using both token and keyring. Could not test: - Publishing packages - Azure Artifacts (not using it at all) --------- Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-02-26 09:52:44 -06:00
Aria Desires	a0b9f22a21	Bump version to 0.6.3 (#11759)	2025-02-24 17:25:01 -05:00
Zanie Blue	6d3614eece	Bump version to 0.6.2 (#11630)	2025-02-19 13:11:11 -06:00
FishAlchemist	555bf89b38	Add document for specifying Python interpreter in tool installation and upgrade commands. (#11598) ... <!-- 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 Just to add the section for installing and upgrading uv tool, specifying the Python version, in the document. Originally, it was planned to add a markdown block (header) for representation, but it was felt to be a bit redundant, so it ended up being like this. close https://github.com/astral-sh/uv/issues/11536 ## Test Plan Run doc server with strict mode in local. (``mkdocs serve -f mkdocs.public.yml --strict``)  <!-- How was it tested? --> --------- Signed-off-by: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com> Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-02-18 11:45:58 -06:00
Zanie Blue	c91ee82a82	Bump version to 0.6.1 (#11580)	2025-02-17 11:57:47 -06:00
Zanie Blue	591f38c25e	Bump version to v0.6.0 (#11496) ... Co-authored-by: Charlie Marsh <charlie.r.marsh@gmail.com>	2025-02-14 11:55:54 -06:00
Aria Desires	9138b35c66	Create main.py instead of hello.py in uv init (#10369) ... Initially it seemed like `app.py` might be slightly more desirable but people seem to overwhelmingly favour `main.py` as a good "generic" name. Fixes #7782	2025-02-13 16:17:49 -06:00
Zanie Blue	e38ac4900d	Bump version to 0.5.31 (#11459)	2025-02-12 14:45:22 -06:00
Lewis	0b4a349173	Update scripts docs with package indexes (#11443) ... ## Summary The [current scripts docs page](https://docs.astral.sh/uv/guides/scripts/) doesn't include detail on how to use a custom package index when setting up a script. I believe this might be because it didn't use to work (see #6688 ) but it now does (thanks for that, by the way! 😄) Given it's a useful feature, I suggest adding a quick example to the scripts page, with the details of authentication, etc. left to the main `indexes.md` doc. I'd also suggests that this closes #6688, though it doesn't actually add that feature - that appears to have already been done :) ## Test Plan No testing is needed, I think! --------- Co-authored-by: Zanie Blue <contact@zanie.dev>	2025-02-12 07:52:22 -06:00
Valentin Oliver Loftsson	5e15881dcc	Update alternative-indexes.md to use UV_INDEX instead of UV_EXTRA_INDEX_URL (#11381) ... <!-- 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 Use `UV_INDEX` instead of the deprecated `UV_EXTRA_INDEX_URL`. <!-- What's the purpose of the change? What does it do, and why? --> ## Test Plan It is a minor documentation change. <!-- How was it tested? -->	2025-02-11 09:19:20 -05:00
Charlie Marsh	ca49495e4b	Bump version to v0.5.30 (#11405)	2025-02-10 21:42:31 +00:00
Zanie Blue	ca73c47543	Bump version to 0.5.29 (#11267)	2025-02-05 19:59:29 -05:00
Zanie Blue	c64965273f	Misc. improvements to the documentation (#11255)	2025-02-05 17:22:09 -06:00
Zanie Blue	2105b8a89d	Minor touchups to the Docker provenance docs (#11252)	2025-02-05 17:09:15 +00:00
Charlie Marsh	fea00dcdd5	Bump version to v0.5.28 (#11228)	2025-02-04 20:28:43 -05:00
Martijn Pieters	04374b03cc	Docs on how to verify uv docker image attestations (#11140) ... As [requested by @zanieb](https://github.com/astral-sh/uv/pull/8685#issuecomment-2627556992).	2025-02-04 15:38:19 -06:00
Zanie Blue	73e9928d40	Bump version to 0.5.27 (#11201)	2025-02-03 16:55:36 -06:00
Charlie Marsh	2dfeafbaa4	Set UV_PYTHON in Jupyter kernels (#11155) ... ## Summary It turns out activating the kernel does not change `VIRTUAL_ENV`, so we still install into the environment the Jupyter environment, rather than the project environment. Unfortunately, after this change, we do still show a warning on `uv add`: ``` warning: `VIRTUAL_ENV=/Users/crmarsh/.cache/uv/archive-v0/3bddKDdYXuX2w57Fu6itL` does not match the project environment path `.venv` and will be ignored ``` `uv pip install` works without warning. Closes #11154.	2025-02-01 16:54:34 -05:00
Zanie Blue	5ef3d51390	Bump version to 0.5.26 (#11119)	2025-01-30 15:37:00 -06:00
Zanie Blue	e0a19be825	Touch-ups to the Python install guide (#11116)	2025-01-30 13:56:53 -06:00
Charlie Marsh	7531bb8669	Upgrade PyTorch version in documentation (#11114) ... ## Summary PyTorch 2.6.0 is now GA!	2025-01-30 14:05:13 -05:00
Charlie Marsh	658ca89fb1	Use sys_platform in lieu of platform_system in PyTorch docs (#11113) ... ## Summary This is what we use in the lockfile. I believe it's preferable, and it's also more concise.	2025-01-30 19:01:52 +00:00
Charlie Marsh	9f8cd92bd3	Use positive (rather than negative) markers in PyTorch examples (#11112) ... ## Summary Maybe slightly controversial because it's more verbose, but we really want to limit these indexes to Linux and Windows, rather than ignoring them on Darwin. E.g., we'd also want to ignore them on other platforms. Further down, I use markers that look like this in the more complete examples, so this feels more consistent.	2025-01-30 14:00:35 -05:00
Charlie Marsh	70507b7898	Add PyTorch XPU instructions to the PyTorch guide (#11109) ... ## Summary Closes https://github.com/astral-sh/uv/issues/11079.	2025-01-30 13:48:52 -05:00