Changelog 0.1.x

0.1.1

Bug fixes

Fix bug where python3 is not found in the global path (#1351)

Documentation

Fix diagram alignment (#1354)
Grammar nit (#1345)

0.1.2

Enhancements

Add --upgrade support to pip install (#1379)
Add -U/-P short flags for --upgrade/--upgrade-package (#1394)
Add UV_NO_CACHE environment variable (#1383)
uv-cache: Add hidden alias for --no-cache-dir (#1380)

Bug fixes

Add fix-up for invalid star comparison with major-only version (#1410)
Add fix-up for trailing comma with trailing space (#1409)
Allow empty fragments in HTML parser (#1443)
Fix search for python.exe on Windows (#1381)
Ignore invalid extra named .none (#1428)
Parse -r and -c entries as relative to containing file (#1421)
Avoid import contextlib in _virtualenv (#1406)
Decode HTML escapes when extracting SHA (#1440)
Fix broken URLs parsed from relative paths in registries (#1413)
Improve error message for invalid sdist archives (#1389)

Documentation

Re-add license badge to the README (#1333)
Replace "novel" in README (#1365)
Tweak some grammar in the README (#1387)
Update README.md to include venv activate (#1411)
Update wording and add alt tag (#1423)

0.1.3

Enhancements

Add support for UV_EXTRA_INDEX_URL (#1515)
Use the system trust store for HTTPS requests (#1512)
Automatically detect virtual environments when used via python -m uv (#1504)
Add warning for empty requirements files (#1519)
Support MD5 hashes (#1556)

Bug fixes

Add support for extras in editable requirements (#1531)
Apply percent-decoding to file-based URLs (#1541)
Apply percent-decoding to filepaths in HTML find-links (#1544)
Avoid attempting rename in copy fallback path (#1546)
Fix list rendering in venv --help output (#1459)
Fix trailing commas on Requires-Python in HTML indexes (#1507)
Read from /bin/sh if /bin/ls cannot be found when determining libc path (#1433)
Remove URL encoding when determining file name (#1555)
Support recursive extras (#1435)
Use comparable representation for PackageId (#1543)
fix OS detection for Alpine Linux (#1545)
only parse /bin/sh (not /bin/ls) (#1493)
pypi-types: fix lenient requirement parsing (#1529)
Loosen package script regexp to match spec (#1482)
Use string display instead of debug for url parse trace (#1498)

Documentation

Provide example of file based package install. (#1424)
Adjust link (#1434)
Add troubleshooting section to benchmarks guide (#1485)
infra: source github templates (#1425)

0.1.4

Enhancements

Add CMD support (#1523)
Improve tracing when encountering invalid requires-python values (#1568)

Bug fixes

Add graceful fallback for Artifactory indexes (#1574)
Allow URL requirements in editable installs (#1614)
Allow repeated dependencies when installing (#1558)
Always run get_requires_for_build_wheel (#1590)
Avoid propagating top-level options to sub-resolutions (#1607)
Consistent use of BIN_NAME in activation scripts (#1577)
Enforce URL constraints for non-URL dependencies (#1565)
Allow non-nested archives for hexdump and others (#1564)
Avoid using white coloring in terminal output (#1576)
Bump simple metadata cache version (#1617)
Better error messages on expect failures in resolver (#1583)

Documentation

Add license to activator scripts (#1610)

0.1.5

Enhancements

Add CACHEDIR.TAG to uv-created virtualenvs (#1653)

Bug fixes

Build source distributions in the cache directory instead of the global temporary directory (#1628)
Do not remove uv itself on pip sync (#1649)
Ensure we retain existing environment variables during python -m uv (#1667)
Add yank warnings at end of messages (#1669)

Documentation

Add brew to readme (#1629)
Document RUST_LOG=trace for additional logging verbosity (#1670)
Document local testing instructions (#1672)
Minimal markdown nits (#1664)
Use --override rather than -o to specify overrides in README.md (#1668)
Remove setuptools & wheel from seed packages on Python 3.12+ ( #1602) (#1613)

0.1.6

Enhancements

Expose find_uv_bin and declare typing support (#1728)
Implement uv cache dir (#1734)
Support venv --prompt (#1570)
Print activation instructions for a venv after one has been created (#1580)

CLI

Add shell completions generation (#1675)
Move uv clean to uv cache clean (#1733)
Allow -f alias for --find-links (#1735)

Configuration

Control pip timeout duration via environment variable (#1694)

Bug fixes

Add support for absolute paths on Windows (#1725)
Don't preserve timestamp in streaming unzip (#1749)
Ensure extras trigger an install (#1727)
Only preserve the executable bit (#1743)
Preserve trailing slash for --find-links URLs (#1720)
Respect --index-url provided via requirements.txt (#1719)
Set index URLs for seeding venv (#1755)
Support dotted function paths for script entrypoints (#1622)
Support recursive extras for URL dependencies (#1729)
Better error message for missing space before semicolon in requirements (#1746)
Add warning when dependencies are empty with Poetry metadata (#1650)
Ignore invalid extras from PyPI (#1731)
Improve Poetry warning (#1730)
Remove uv version from uv pip compile header (#1716)
Fix handling of range requests on servers that return "Method not allowed" (#1713)
re-introduce cache healing when we see an invalid cache entry (#1707)

Documentation

Clarify Windows install command in README.md (#1751)
Add instructions for installing on Arch Linux (#1765)

Rust API

Allow passing in a custom reqwest Client (#1745)

0.1.7

Enhancements

Stream zip archive when fetching non-range-request metadata (#1792)
Support setting request timeout with UV_HTTP_TIMEOUT and HTTP_TIMEOUT (#1780)
Improve error message when git ref cannot be fetched (#1826)

Configuration

Implement --annotation-style parameter for uv pip compile (#1679)

Bug fixes

Add fixup for prefect<1.0.0 (#1825)
Add support for >dev specifier (#1776)
Avoid enforcing URL correctness for installed distributions (#1793)
Don't expect pinned packages for editables with non-existent extras (#1847)
Linker copies files as a fallback when ref-linking fails (#1773)
Move conflicting dependencies into PubGrub (#1796)
Normalize VIRTUAL_ENV path in activation scripts (#1817)
Preserve executable bit when untarring archives (#1790)
Retain passwords in Git URLs (#1717)
Sort output when installing seed packages (#1822)
Treat ARM wheels as higher-priority than universal (#1843)
Use git command to fetch repositories instead of libgit2 for robust SSH support (#1781)
Use redirected URL as base for relative paths (#1816)
Use the right marker for the implementation field of pyvenv.cfg (#1785)
Wait for distribution metadata with --no-deps (#1812)
platform-host: check /bin/sh, then /bin/dash and then /bin/ls (#1818)
Ensure that builds within the cache aren't considered Git repositories (#1782)
Strip trailing + from version number of local Python builds (#1771)

Documentation

Add docs for git authentication (#1844)
Update venv activation for windows (#1836)
Update README.md to include extras example (#1806)

0.1.8

Bug fixes

Allow duplicate URLs that resolve to the same canonical URL (#1877)
Retain authentication attached to URLs when making requests to the same host (#1874)
Win Trampoline: Use Python executable path encoded in binary (#1803)
Expose types to implement custom ResolverProvider (#1862)
Search PATH when python can't be found with py (#1711)
Avoid displaying "root" package when formatting terms (#1871)

Documentation

Use more universal windows install instructions (#1811)

Rust API

Expose types to implement custom ResolverProvider (#1862)

0.1.9

Enhancements

Add support for config_settings in PEP 517 hooks (#1833)
feat: allow passing extra config k,v pairs for pyvenv.cfg when creating a venv (#1852)

Bug fixes

Ensure authentication is passed from the index url to distribution files (#1886)
Use rustls-tls-native-roots in uv crate (#1888)
pep440: fix version ordering (#1883)
Hide index URLs from header if not emitted (#1835)

Documentation

Add changelog (#1881)

0.1.10

Enhancements

Omit --find-links from annotation header unless requested (#1898)
Write to stdout when --output-file is present (#1892)

Bug fixes

Retain authentication when making range requests (#1902)
Fix uv-created venv detection (#1908)
Fix Windows py failure from spurious stderr (#1885)
Ignore Python 2 installations when querying for interpreters (#1905)

0.1.11

Enhancements

Add support for pip-compile's --unsafe-package flag (#1889)
Improve interpreter discovery logging (#1909)
Implement uv pip list (#1662)
Allow round-trip via freeze command (#1936)
Don't write pip compile output to stdout with -q (#1962)
Add long-form version output (#1930)

Compatibility

Accept single string for backend-path (#1969)
Add compatibility for deprecated python_implementation marker (#1933)
Generate versioned pip launchers (#1918)

Bug fixes

Avoid erroring for source distributions with symlinks in archive (#1944)
Expand scope of archive timestamping (#1960)
Gracefully handle virtual environments with conflicting packages (#1893)
Invalidate dependencies when editables are updated (#1955)
Make < exclusive for non-pre-release markers (#1878)
Properly apply constraints in venv audit (#1956)
Re-sync editables on-change (#1959)
Remove current directory from PATH in PEP 517 hooks (#1975)
Remove --upgrade and --quiet flags from generated output files (#1873)
Use full python version in pyvenv.cfg (#1979)

Performance

fix uv pip install handling of gzip'd response and PEP 691 (#1978)
Remove spawn_blocking from version map (#1966)

Documentation

Clarify lowest vs. lowest-direct resolution strategies (#1954)
Improve error message for network timeouts (#1961)

0.1.12

CLI

Add a --python flag to allow installation into arbitrary Python interpreters (#2000)
Add a --system flag for opt-in non-virtualenv installs (#2046)

Enhancements

Add a --pre alias for --prerelease=allow (#2049)
Enable freeze and list to introspect non-virtualenv Pythons (#2033)
Support environment variables in index URLs in requirements files (#2036)
Add --exclude-editable and --exclude args to uv pip list (#1985)
Always remove color codes from output file (#2018)
Support recursive extras in direct pyproject.toml files (#1990)
Un-cache editable requirements with dynamic metadata (#2029)
Use a non-local lockfile for locking system interpreters (#2045)
Surface the EXTERNALLY-MANAGED message to users (#2032)

0.1.13

Bug fixes

Prioritize PATH over py --list-paths in Windows selection (#2057). This fixes an issue in which the --system flag would not work correctly on Windows in GitHub Actions.
Avoid canonicalizing user-provided interpreters (#2072). This fixes an issue in which the --python flag would not work correctly with pyenv and other interpreters.
Allow pre-releases for requirements in constraints files (#2069)
Avoid truncating EXTERNALLY-MANAGED error message (#2073)
Extend activation highlighting to entire venv command (#2070)
Reverse the order of --index-url and --extra-index-url priority (#2083)
Avoid assuming RECORD file is in platlib (#2091)

0.1.14

Enhancements

Add support for --system-site-packages in uv venv (#2101)
Add support for Python installed from Windows Store (#2122)
Expand environment variables in -r and -c subfile paths (#2143)
Treat empty index URL strings as null instead of erroring (#2137)
Use space as delimiter for UV_EXTRA_INDEX_URL (#2140)
Report line and column numbers in requirements.txt parser errors (#2100)
Improve error messages when uv is offline (#2110)

Bug fixes

Future-proof the pip entrypoints special-case (#1982)
Allow empty extras in pep508-rs and add more corner case to tests (#2128)
Adjust base Python lookup logic for Windows to respect Windows Store (#2121)
Consider editable dependencies to be 'direct' for --resolution (#2114)
Preserve environment variables in resolved Git dependencies (#2125)
Use prefix instead of base_prefix for environment root (#2117)
Wrap unsafe script shebangs in /bin/sh (#2097)
Make WHEEL parsing error line numbers one indexed (#2151)
Determine site-packages path based on implementation name (#2094)

Documentation

Add caveats on --system support to the README (#2131)
Add instructions for SSL_CERT_FILE env var (#2124)

0.1.15

Enhancements

Add a --compile option to install to enable bytecode compilation (#2086)
Expose the --exclude-newer flag to limit candidate packages based on date (#2166)
Add uv version to user agent (#2136)

Bug fixes

Set .metadata suffix on URL path (#2123)
Fallback to non-range requests when HEAD returns 404 (#2186)
Allow direct URLs in optional dependencies in editables (#2206)
Allow empty values in WHEEL files (#2170)
Avoid Windows Store shims in --python python3-like invocations (#2212)
Expand Windows shim detection to include python3.12.exe (#2209)
HTML-decode URLs in HTML indexes (#2215)
Make direct dependency detection respect markers (#2207)
Respect py --list-paths fallback in --python python3 invocations on Windows (#2214)
Respect local freshness when auditing installed environment (#2169)
Respect markers on URL dependencies in editables (#2176)
Respect nested editable requirements in parser (#2204)
Run Windows against Python 3.13 (#2171)
Error when editables don't match Requires-Python (#2194)

0.1.16

Enhancements

Add support for --no-build-isolation (#2258)
Add support for --break-system-packages (#2249)
Add support for .netrc authentication (#2241)
Add support for --format=freeze and --format=json in uv pip list (#1998)
Add support for remote https:// requirements files (#1332) (#2081)
Implement uv pip show (#2115)
Allow UV_PRERELEASE to be set via environment variable (#2240)
Include exit code for build failures (#2108)
Query interpreter to determine correct virtualenv paths, enabling uv venv with PyPy and others (#2188)
Respect non-sysconfig-based system Pythons, enabling --system installs on Debian and others (#2193)

Bug fixes

Fallback to fresh request on non-validating 304 (#2218)
Add .stdout() and .stderr() outputs to Printer (#2227)
Close RECORD after reading entries during uninstall (#2259)
Fix Conda Python detection on Windows (#2279)
Fix parsing requirement where a variable follows an operator without a space (#2273)
Prefer more recent minor versions in wheel tags (#2263)
Retry on Python interpreter launch failures during --compile (#2278)
Show appropriate activation command based on shell detection (#2221)
Escape Windows paths with spaces in venv activation command (#2223)
Add specialized activation message for cmd.exe (#2226)
Cache wheel metadata in no-PEP 658 fallback (#2255)
Use reparse points to detect Windows installer shims (#2284)

Documentation

Add PIP_COMPATIBILITY.md to document known deviations from pip (#2244)

0.1.17

Enhancements

Allow more-precise Git URLs to override less-precise Git URLs (#2285)
Add support for Metadata 2.2 (#2293)
Added ability to select bytecode invalidation mode of generated .pyc files (#2297)
Add Seek fallback for zip files with data descriptors (#2320)

Bug fixes

Support reading UTF-16 requirements files (#2283)
Trim rows in pip list (#2298)
Avoid using setuptools shim of distutils (#2305)
Communicate PEP 517 hook results via files (#2314)
Increase default buffer size for wheel and source downloads (#2319)
Add Accept-Encoding: identity to remaining stream paths (#2321)
Avoid duplicating authorization header with netrc (#2325)
Remove duplicate INSTALLER in RECORD (#2336)

Documentation

Add a custom suggestion to install wheel into the build environment (#2307)
Document the environment variables that uv respects (#2318)

0.1.18

Breaking changes

Users that rely on native root certificates (or the SSL_CERT_FILE) environment variable must now pass the --native-tls command-line flag to enable this behavior.

Enable TLS native root toggling at runtime (#2362)

Enhancements

Add --dry-run flag to uv pip install (#1436)
Implement "Requires" field in pip show (#2347)
Remove wheel from default PEP 517 backend (#2341)
Add UV_SYSTEM_PYTHON environment variable as alias to --system (#2354)
Add a -vv log level and make -v more readable (#2301)

Bug fixes

Expand environment variables prior to detecting scheme (#2394)
Fix bug where --no-binary :all: prevented build of editable packages (#2393)
Ignore inverse dependencies when building graph (#2360)
Skip prefetching when --no-deps is specified (#2373)
Trim injected python_version marker to (major, minor) (#2395)
Wait for request stream to flush before returning resolution (#2374)
Write relative paths for scripts in data directory (#2348)
Add dedicated error message for direct filesystem paths in requirements (#2369)

0.1.19

Configuration

Add UV_NATIVE_TLS environment variable (#2412)
Allow SSL_CERT_FILE without requiring --native-tls (#2401)
Add support for retrieving credentials from keyring (#2254)

Bug fixes

Add backoff for transient Windows failures (#2419)
Move architecture and operating system probing to Python (#2381)
Respect --native-tls in venv (#2433)
Treat non-existent site-packages as empty (#2413)

Documentation

Document HTTP authentication (#2425)

Performance

Improve performance of version range operations (#2421)

0.1.20

Bug fixes

Add in-URL credentials to store prior to creating requests (#2446)
Error when direct URL requirements don't match Requires-Python (#2196)

0.1.21

Enhancements

Loosen .dist-info validation to accept arbitrary versions (#2441)

Bug fixes

Fix macOS architecture detection on i386 machines (#2454)

0.1.22

Enhancements

Add support for PyTorch-style local version semantics (#2430)
Add support for Hatch's {root:uri} paths in editable installs (#2492)
Implement uv pip check (#2397)
Add pip-like linehaul information to user agent (#2493)
Add additional ARM targets to release (#2417)

Bug fixes

Allow direct file path requirements to include fragments (#2502)
Avoid panicking on cannot-be-a-base URLs (#2461)
Drop macosx_10_0 from compatible wheel tags on aarch64 (#2496)
Fix operating system detection on *BSD (#2505)
Fix priority of ABI tags (#2489)
Fix priority of platform tags for manylinux (#2483)
Make > operator exclude post and local releases (#2471)
Re-add support for pyenv shims (#2503)
Validate required package names against wheel package names (#2516)

0.1.23

Enhancements

Implement --no-strip-extras to preserve extras in compilation (#2555)
Preserve hashes for pinned packages when compiling without --upgrade (#2532)
Add a uv self update command (#2228)
Use relative paths for user-facing messages (#2559)
Add CUSTOM_COMPILE_COMMAND support to uv pip compile (#2554)
Add SHA384 and SHA512 hash algorithms (#2534)
Treat uninstallable packages as warnings, rather than errors (#2557)

Bug fixes

Allow VIRTUAL_ENV to take precedence over CONDA_PREFIX (#2574)
Ensure mtime of site packages is updated during wheel installation (#2545)
Re-test validity after every lenient parsing change (#2550)
Run interpreter discovery under -I mode (#2552)
Search in both purelib and platlib for site-packages population (#2537)
Fix wheel builds and uploads for musl ARM (#2518)

Documentation

Add --link-mode defaults to CLI (#2549)
Add an example workflow for compiling the current environment's packages (#1968)
Add uv pip check diagnostics to PIP_COMPATIBILITY.md (#2544)

0.1.24

Breaking changes

uv pip uninstall no longer supports specifying targets with the -e / --editable flag (#2577)

Enhancements

Add a garbage collection mechanism to the CLI (#1217)
Add progress reporting for named requirement resolution (#2605)
Add support for parsing unnamed URL requirements (#2567)
Add support for unnamed local directory requirements (#2571)
Enable PEP 517 builds for unnamed requirements (#2600)
Enable install audits without resolving named requirements (#2575)
Enable unnamed requirements for direct URLs (#2569)
Respect HTTP client options when reading remote requirements files (#2434)
Use PEP 517 build hooks to resolve unnamed requirements (#2604)
Use c-string literals and update trampolines (#2590)
Support unnamed requirements directly in uv pip uninstall (#2577)
Add support for unnamed Git and HTTP requirements (#2578)
Make self-update an opt-in Cargo feature (#2606)
Update minimum rust version (cargo) to 1.76 (#2618)

Bug fixes

Fix self-updates on Windows (#2598)
Fix authentication with usernames that contain @ characters (#2592)
Do not error when there are warnings on Python interpreter stderr (#2599)
Prevent discovery of cache gitignore when building distributions (#2615)

Rust API

Make InstallDist.direct_url public (#2584)
Make AllowedYanks public (#2608)

Documentation

Fix badge to current CI status (#2612)

0.1.25

Breaking changes

Limit overrides and constraints to requirements.txt format (#2632)

Enhancements

Accept setup.py and setup.cfg files in compile (#2634)
Add --no-binary and --only-binary support to requirements.txt (#2680)
Allow pre-releases, locals, and URLs in non-editable path requirements (#2671)
Use PEP 517 to extract dynamic pyproject.toml metadata (#2633)
Add Editable project location and Required-by to pip show (#2589)
Avoid prepare_metadata_for_build_wheel calls for Hatch packages with dynamic dependencies (#2645)
Fall back to PEP 517 hooks for non-compliant PEP 621 metadata (#2662)
Support file://localhost/ schemes (#2657)
Use normal resolver in pip sync (#2696)

CLI

Disallow pyproject.toml from pip uninstall -r (#2663)
Unhide --emit-index-url and --emit-find-links (#2691)
Use dense formatting for requirement version specifiers in diagnostics (#2601)

Performance

Add an in-memory cache for Git references (#2682)
Do not force-recompile .pyc files (#2642)
Read package metadata from pyproject.toml when it is statically defined (#2676)

Bug fixes

Don't error on multiple matching index URLs (#2627)
Extract local versions from direct URL requirements (#2624)
Respect --no-index with --find-links in pip sync (#2692)
Use Scripts folder for virtualenv activation prompt (#2690)

0.1.26

Bug fixes

Bump simple cache version (#2712)

0.1.27

Enhancements

Add --exclude-editable support to pip-freeze (#2740)
Add pyproject.toml et al to list of prompted packages (#2746)
Consider installed packages during resolution (#2596)
Recursively allow URL requirements for local dependencies (#2702)

Configuration

Add UV_RESOLUTION environment variable for --resolution (#2720)

Bug fixes

Respect overrides in all direct-dependency iterators (#2742)
Respect subdirectories when reading static metadata (#2728)

0.1.28

Enhancements

Recursively resolve direct URL references upfront (#2684)

Performance

Populate the in-memory index when resolving lookahead URLs (#2761)

Bug fixes

Detect Fish via FISH_VERSION (#2781)
Exclude installed distributions with multiple versions from consideration in the resolver (#2779)
Resolve non-deterministic behavior in preferences due to site-packages ordering (#2780)
Use canonical URL to key redirect map (#2764)
Use distribution database and index for all pre-resolution phases (#2766)
Fix uv self update on Linux (#2783)

0.1.29

Enhancements

Allow conflicting Git URLs that refer to the same commit SHA (#2769)
Allow package lookups across multiple indexes via explicit opt-in (--index-strategy unsafe-any-match) (#2815)
Allow no-op --no-compile flag on CLI (#2816)
Upgrade rs-async-zip to support data descriptors (#2809)

Bug fixes

Avoid unused extras check in pip install for source trees (#2811)
Deduplicate editables during install commands (#2820)
Fix windows lock race: lock exclusive after all try lock errors (#2800)
Preserve .git suffixes and casing in Git dependencies (#2789)
Respect Git tags and branches that look like short commits (#2795)
Enable virtualenv creation on Windows with cpython-x86 (#2707)

Documentation

Document that uv is safe to run concurrently (#2818)

0.1.30

Enhancements

Show resolution diagnostics after pip install (#2829)

Performance

Speed up cold-cache urllib3-boto3-botocore performance with batched prefetching (#2452)

Bug fixes

Backtrack on distributions with invalid metadata (#2834)
Include LICENSE files in source distribution (#2855)
Respect --no-build and --no-binary in --find-links (#2826)
Respect cached local --find-links in install plan (#2907)
Avoid panic with multiple confirmation handlers (#2903)
Use scheme parsing to determine absolute vs. relative URLs (#2904)
Remove additional 'because' in resolution failure messages (#2849)
Use miette when printing pip sync resolution failures (#2848)

0.1.31

Bug fixes

Ignore direct URL distributions in prefetcher (#2943)

0.1.32

Enhancements

Add a --require-hashes command-line setting (#2824)
Add hash-checking support to install and sync (#2945)
Add support for URL requirements in --generate-hashes (#2952)
Allow unnamed requirements for overrides (#2999)
Enforce and backtrack on invalid versions in source metadata (#2954)
Fall back to distributions without hashes in resolver (#2949)
Implement --emit-index-annotation to annotate source index for each package (#2926)
Log hard-link failures (#3015)
Support free-threaded Python (#2805)
Support unnamed requirements in --require-hashes (#2993)
Respect link mode for builds, in uv pip compile and for uv venv seed packages (#3016)
Force color for build error messages (#3032)
Surface invalid metadata as hints in error reports (#2850)

Configuration

Add UV_BREAK_SYSTEM_PACKAGES environment variable (#2995)

CLI

Remove some restrictions in argument groups (#3001)

Bug fixes

Add --find-links source distributions to the registry cache (#2986)
Allow comments after all requirements.txt entries (#3018)
Avoid cache invalidation on credentials renewal (#3010)
Avoid calling normalize_path with relative paths that extend beyond the current directory (#3013)
Deduplicate symbolic links between purelib and platlib (#3002)
Remove unused --output-file from pip install (#2975)
Strip query string when parsing filename from HTML index (#2961)
Update hashes without --upgrade if not present (#2966)

0.1.33

Breaking changes

Using the keyring requires a username to be provided on index URLs now. Previously, the username oauth2accesstoken was assumed. This will affect Google Artifact Registry users using --keyring-provider subprocess and an index URL without a username. The suggested fix is to add the required username to index URLs, e.g., https://oauth2accesstoken@<url>.

See #2976 for details.

Enhancements

Allow passing a virtual environment path to uv pip --python (#3064)
Add compatibility argument for pip list --outdated (#3055)

CLI

Enable auto-wrapping of --help output (#3058)
Show --require-hashes CLI argument in help (#3093)

Performance

Incorporate heuristics to improve package prioritization (#3087)

Bug fixes

Fix HTTP authentication when the password includes percent encoded characters (e.g., with Google Artifact Registry) (#2822)
Use usernames from URLs when looking for credentials in netrc files and the keyring #2563)
Skip HEAD requests for indexes that return 403 (e.g., PyPICloud) (#3070)
Use kebab-case consistently (#3080)
Show package name in no version for direct dependency error (#3056)
Avoid erroring when encountering .tar.bz2 source distributions (#3069)

0.1.34

CLI

Allow --python and --system on pip compile (#3115)
Remove Option<bool> for --no-cache (#3129)
Rename --compile to --compile-bytecode (#3102)
Accept 0, 1, and similar values for Boolean environment variables (#3113)

Configuration

Add UV_REQUIRE_HASHES environment variable (#3125)
Add negation flags to the CLI (#3050)

Bug fixes

Avoid fetching unnecessary extra versions during resolution (#3100)
Avoid deprioritizing recursive editables (#3133)
Avoid treating localhost URLs as local file paths (#3132)
Hide password in the index printed via --emit-index-annotation (#3112)
Restore seeding of authentication cache from index URLs (#3124)

0.1.35

Enhancements

Add a --python-platform argument to enable resolving against a target platform (#3111)
Enforce HTTP timeouts on a per-read (rather than per-request) basis (#3144)

Bug fixes

Avoid preferring constrained over unconstrained packages (#3148)
Allow UV_SYSTEM_PYTHON=1 in addition to UV_SYSTEM_PYTHON=true (#3136)

0.1.36

Enhancements

Add support for embedded Python on Windows (#3161)
Add Docker image publishing to release pipeline (#3155)

Configuration

Add UV_CONSTRAINT environment variable to provide value for --constraint (#3162)

Bug fixes

Avoid waiting for metadata for --no-deps editables (#3188)
Fix venvlauncher.exe reference in venv creation (#3160)
Fix authentication for URLs with a shared realm (#3130)
Restrict observed requirements to direct when --no-deps is specified (#3191)

Documentation

Add a versioning policy to the README (#3151)

0.1.37

Enhancements

Change default HTTP read timeout to 30s (#3182)
Add --python-platform to sync and install commands (#3154)
Add ticks around error messages more consistently (#3004)
Fix Docker publish permissions in release pipeline (#3195)
Improve tracing for keyring provider (#3207)

Performance

Update keyring provider to be async (#3089)

Bug fixes

Fix fetch of credentials when cache is seeded with username (#3206)

Documentation

Improve --python-platform documentation (#3202)

0.1.38

Enhancements

Add alternate manylinux targets to --python-platform (#3229)
An enum and backticks for lookahead error (#3216)
Upgrade macOS target to 12.0 (#3228)
Add keyring logs for URL and host fetches (#3212)
Combine unresolvable error dependency clauses with the same root (#3225)

CLI

Gave a better name to the --color placeholder (#3226)
Warn when an unsupported Python version is encountered (#3250)

Configuration

Use directory instead of file when searching for uv.toml file (#3203)

Performance

Only perform fetches of credentials for a realm and username combination once (#3237)
Unroll self-dependencies via extras (#3230)
Use read-write locks instead of mutexes in authentication handling (#3210)

Bug fixes

Avoid removing quotes from requirements markers (#3214)
Avoid adding extras when expanding constraints (#3232)
Reinstall package when editable label is removed (#3219)

Documentation

Add RAYON_NUM_THREADS to environment variable docs (#3223)
Document support for HTTP proxy variables (#3247)
Fix documentation for --python-platform (#3220)

0.1.39

Enhancements

Add --target support to sync and install (#3257)
Implement --index-strategy unsafe-best-match (#3138)

Bug fixes

Fix platform_machine tag for --python-platform on macOS ARM (#3267)

Release

Build a separate ARM wheel for macOS (#3268)
Use macos-12 to build release wheels (#3264)

0.1.40

Enhancements

Add --allow-existing to overwrite existing virtualenv (#2548)
Respect and enable uninstalls of legacy editables (.egg-link) (#3415)
Respect and enable uninstalls of existing .egg-info packages (#3380)

CLI

Accept --no-upgrade, --no-refresh, etc. on the CLI (#3328)

Configuration

Expose UV_NO_BUILD_ISOLATION as environment variable (#3318)
Expose UV_PYTHON as an environment variable (#3284)
Expose UV_LINK_MODE as environment variable (#3315)
Add UV_CUSTOM_COMPILE_COMMAND to environment variable docs (#3382)

Bug fixes

Ignore 401 HTTP responses with multiple indexes (#3292)
Avoid panic for file URLs (#3306)
Quote version parse errors consistently (#3325)
Detect current environment when uv is invoked from within a virtualenv (#3379)
Unset target when creating virtual environments (#3362)
Update activation scripts from virtualenv (#3376)
Use canonical URLs in satisfaction check (#3373)

Preview features

Add basic tool.uv.sources support (#3263)
Improve non-git error message (#3403)
Preserve given for tool.uv.sources paths (#3412)
Restore verbatim in error message (#3402)
Use preview mode for tool.uv.sources (#3277)
Use top-level --isolated for uv run (#3431)
add basic "install from lock file" operation (#3340)
uv-resolver: add initial version of universal lock file format (#3314)

0.1.41

Bug fixes

Remove unconstrained version error from requirements (#3443)

0.1.42

This release includes stabilized support for persistent configuration in uv.

uv will now read project configuration from a pyproject.toml or uv.toml file in the current directory or any parent directory, along with user configuration at ~/.config/uv/uv.toml (or $XDG_CONFIG_HOME/uv/uv.toml) on macOS and Linux, and %APPDATA%\uv\uv.toml on Windows.

See: Persistent Configuration for more.

Enhancements

Respect MACOSX_DEPLOYMENT_TARGET in --python-platform (#3470)

Configuration

Add documentation for persistent configuration (#3467)
Add JSON Schema export to SchemaStore (#3461)
Merge user and workspace settings (#3462)

Bug fixes

Use Metadata10 to parse PKG-INFO of legacy editable (#3450)
Apply normcase to line from easy-install.pth (#3451)
Upgrade async_http_range_reader to v0.8.0 to respect redirects in range requests (#3460)
Use last non-EOL version for --python-platform macOS (#3469)

Preview features

Use environment layering for uv run --with (#3447)
Warn when missing minimal bounds when using tool.uv.sources (#3452)

0.1.43

Enhancements

Annotate sources of requirements in pip compile output (#3269)
Track origin for setup.py files and friends (#3481)

Configuration

Consolidate concurrency limits and expose as environment variables (#3493)

Release

Use manylinux: auto to enable musllinux_1_2 aarch64 builds (#3444)
Enable musllinux_1_1 wheels (#3523)

Bug fixes

Avoid keyword arguments for PEP 517 build hooks (#3517)
Apply advisory locks when building source distributions (#3525)
Avoid attempting to build editables when fetching metadata (#3563)
Clone individual files on windows ReFS (#3551)
Filter irrelevant requirements from source annotations (#3479)
Make cache clearing robust to directories without read permissions (#3524)
Respect constraints on editable dependencies (#3554)
Skip Python 2 versions when locating Python (#3476)
Make --isolated a global argument (#3558)
Allow unknown pyproject.toml fields (#3511)
Change error value detection for glibc (#3487)

Preview features

Create virtualenv if it doesn't exist in project API (#3499)
Discover uv run projects hierarchically (#3494)
Read and write uv.lock based on project root (#3497)
Read package name from pyproject.toml in uv run (#3496)
Rebrand workspace API as project API (#3489)

0.1.44

Release

Reverts "Use manylinux: auto to enable musllinux_1_2 aarch64 builds (#3444)"

The manylinux change appeared to introduce SSL errors when building aarch64 Docker images, e.g.,

invalid peer certificate: BadSignature

The v0.1.42 behavior for aarch64 manylinux builds is restored in this release.

See #3576

0.1.45

Enhancements

Parse and store extras on editable requirements (#3629)
Allow local versions in wheel filenames (#3596)
Create lib64 symlink for 64-bit, non-macOS, POSIX environments (#3584)

Configuration

Add UV_CONCURRENT_INSTALLS variable in favor of RAYON_NUM_THREADS (#3646)
Add serialization and deserialization for --find-links (#3619)
Apply combination logic to merge CLI and persistent configuration (#3618)

Performance

Parallelize resolver (#3627)

Bug fixes

Reduce sensitivity of unknown option error to discard Python 2 interpreters (#3580)
Respect installed packages in uv run (#3603)
Separate cache construction from initialization (#3607)
Add missing "directory" branch in source match (#3608)
Fix source annotation in pip compile annotation-style=line output (#3637)
Run cargo update to pull in h2 (#3638)
URL-decode hashes in HTML fragments (#3655)
Always print JSON output with --format json (#3671)

Documentation

Add UV_CONFIG_FILE environment variable to documentation (#3653)
Explicitly mention --user in compatibility guide (#3666)

Release

Add musl ppc64le support (#3537)
Retag musl aarch64 for manylinux2014 (#3624)

Preview features

Add direct URL conversion to lockfile (#3633)
Add hashes and versions to all distributions (#3589)
Add local path conversions from lockfile (#3609)
Add missing "directory" branch in source match (#3608)
Add registry file size to lockfile (#3652)
Add registry source distribution support to lockfile (#3649)
Refactor editables for supporting them in bluejay commands (#3639)
Rename sourcedist to sdist in lockfile (#3590)
Respect installed packages in uv run (#3603)
Support lossless serialization for Git dependencies in lockfile (#3630)