uv 0.13.6

İyileştirmeler

• Boş bir UV_RUN_RECURSION_DEPTH değeri artık sıfır olarak kabul ediliyor ve geçersiz değerler tutarlı şekilde bildiriliyor.
• uv init, [project] tablosu bulunmayan bir pyproject.toml dosyası tespit ettiğinde proje meta verilerinin nasıl ekleneceğini açıklıyor.
  Python
• CPython 3.11.18, 3.12.16, 3.13.18, 3.14.10 ve 3.15.2 sürümleri eklendi.
  Önizleme Özellikleri
• wheel-variants ile uyumlu wheel varyantları seçilirken NVIDIA GPU yeteneklerinin algılanması sağlandı.
• uv workspace metadata çıktısında her modülün sahipleri artık bir nesne içerisinde gruplandırılıyor.
• Uyumsuz bir wheel varyantının gerektirdiği ancak desteklenmeyen özelliklerin bildirilmesi sağlandı.
  Performans
• Büyük çalışma alanları çözümlenirken en yüksek bellek kullanımı azaltıldı.
• Büyük projeler kilitlenirken veya yükseltilirken en yüksek bellek kullanımı azaltıldı.
• uv export ve uv pip compile komutlarının yönlendirilmiş çıktıları hızlandırıldı.
• Bağımlılığı olmayan PEP 723 betikleri çalıştırılırken önbelleğe alınmış veya etkin ortamların yeniden kullanılması sağlandı.
• Derleme bağımlılıkları ve derleme arka ucu ayarlarının ayrıştırma yükü azaltıldı.
• Proje kaynakları ve çalışma alanı referanslarının ayrıştırma yükü azaltıldı.
• Önbellek, hariç tutma, cutoff ve önizleme ayarlarının ayrıştırma yükü azaltıldı.
• PyPI meta verilerinin ayrıştırma yükü azaltıldı.
• Araç makbuzu gereksinimlerinin ayrıştırılması hızlandırıldı.
  Hata Düzeltmeleri
• uv run --active --script ve uv sync --active --script komutlarının sanal ortam olmayan dizinleri silmesi engellendi.
• x86-64 Windows için çözümleme yapılırken platform_machine değeri olarak AMD64 kullanılması sağlandı.
• uv python upgrade sırasında free-threaded ve diğer varsayılan olmayan varyantların korunması sağlandı.
• UV_INIT_BUILD_BACKEND ayarlanmışken uv init --no-package ve uv init --script komutlarının kullanılabilmesi sağlandı.
• Yerel sürümler içeren containment marker'ları oluşturulurken oluşabilen çökmeler engellendi.
  Dokümantasyon
• Docker rehberi ve yeniden üretim örnekleri uv 0.13.5 sürümünü kullanacak şekilde güncellendi.

​

Önizleme Özellikleri​

• wheel-variants kullanılarak platform-specific resolution’larda gerekli property’si bulunmayan veya PEP 850 static provider’larından gelen property’lere sahip wheel variant’larını seçme ve sıralama desteği eklendi.

Performans​

• Birden fazla environment genelinde dependency resolution yapılırken peak memory kullanımı azaltıldı.
• Dependency graph genelinde activation çözümlemesi yapılarak karmaşık transitive extra’lara sahip export işlemleri hızlandırıldı.
• Ek error formatter’lar inline dışında tutularak uv’nin binary boyutu azaltıldı.
• Custom build cache key’leri parse edilirken oluşan overhead azaltıldı.

Hata Düzeltmeleri​

• Source distribution’ı bulunmayan ve yalnızca Android wheel olarak dağıtılan package’ların lock edilebilmesi sağlandı.
• Transitive extra’lar farklı veya uyumsuz environment path’leri üzerinden etkinleştirildiğinde optional dependency’lerin doğru şekilde export edilmesi sağlandı.
• Geçersiz custom build cache key’lerinde sessizce default değerlere fallback yapmak yerine hata verilmesi sağlandı.

​

Sürüm Notları​

20 Ekim 2026 tarihinde yayınlandı.

Bu sürüm, Web PKI üzerindeki intermediate certificate’ı ele geçirilmiş bir root CA ile ilgili GHSA-hq85-5cpj-mr62 güvenlik açığını gideriyor. Kullanıcıların mümkün olan en kısa sürede güncelleme yapmaları ve bundled CA kullanan diğer tüm yazılımların da düzgün şekilde güncellendiğini doğrulamaları öneriliyor.

Önizleme Özellikleri​

• PEP 825 variant metadata’sı için validation eklendi. wheel-variants kullanılırken geçersiz metadata’ya sahip package version’ları artık kullanılamaz olarak değerlendiriliyor.

Diğer Değişiklikler​

• Bundled Mozilla root certificate’ları webpki-root-certs 1.0.10 kullanılarak güncellendi.

Performans​

• Extras içeren dependency graph’larında uv export işleminin ciddi ölçüde yavaşlaması önlendi.

Sürüm Notları​

14 Ekim 2026 tarihinde yayınlandı.

İyileştirmeler​

• uv pip check ve uv pip install --strict komutlarında Requires-Python upper bound’ları artık resolution davranışıyla tutarlı şekilde göz ardı ediliyor.
• Filesystem cloning ve detailed cache accounting kullanılamadığında fallback uygulanarak Linux SPARC desteği eklendi.
• Resolution error’larında eksik trusted hash’ler artık raporlanıyor.

Python​

• CPython 3.16.0a1 eklendi.

Önizleme Özellikleri​

• tool-install-locks enabled olduğunda uv tool upgrade artık kurulu tool’ları upgrade edebiliyor.
• wheel-variants ile wheel filename’lerindeki PEP 825 variant label’larını parse etmek için preliminary support eklendi.

Performans​

• uv binary boyutu küçültüldü.
• Simple API parsing hızlandırıldı.
• Package metadata parsing overhead azaltıldı.

Hata Düzeltmeleri​

• Tool ve managed Python uninstall işlemlerinin storage directory’lerinin yanındaki ilgisiz file’ları silmesi engellendi.
• Hard link veya tam uzunlukta tar user/group name içeren source distribution’lar için destek geri getirildi.
• uv pip compile veya uv export output destination olarak kullanılan device file ve FIFO’lar artık korunuyor.
• Symlink interpreter’lardan oluşturulan environment’larda sys._base_executable detection düzeltildi.
• Concurrent reader’ların kısmen yazılmış lockfile, Python version file veya managed Python sysconfig file’larını görmesi engellendi.
• Aynı environment’a real ve symlink path’ler üzerinden erişen concurrent project command’ler artık sırayla çalıştırılıyor.
• Install, sync ve environment creation işlemlerinin uv cache clean ile aynı anda çalışması durumunda başarısız olması engellendi.
• Son tool uninstall edilirken concurrent tool installation’ların environment’ı bozması engellendi.
• uv tool upgrade tool version’ını değiştirmese bile değiştirilen upgrade setting’leri artık kalıcı olarak kaydediliyor.
• Full commit hash’e pin’lenmiş Git dependency’lerinin kurulu olduğu environment’lar yeniden resolution yapılmadan tekrar kullanılabiliyor.

Sürüm Notları​

9 Ekim 2026'da yayımlandı.

uv 0.13.0 ile Python 3.15 artık varsayılan stable Python version oldu. Ayrıca correctness, performance ve compatibility’yi geliştirmek amacıyla aşağıda açıklanan çeşitli breaking change’ler de eklendi.

Çoğu kullanıcının herhangi bir değişiklik yapmadan upgrade edebilmesini bekliyoruz.

Breaking change olmasa da bu release, performance’ı artırmak için uv cache entry’lerinin çoğunun formatını da güncelliyor. Upgrade sonrasında uv bazı dependency’leri yeniden download edebilir veya rebuild edebilir, çünkü eski sürümlerden kalan bazı cached entry’ler yeniden kullanılamıyor. Birden fazla uv version yine aynı cache directory’yi güvenli şekilde paylaşabiliyor.

uv build backend configuration’ında breaking change bulunmuyor. [build-system] table içinde uv_build için upper bound kullanıyorsanız, bunu uv_build 0.13’e izin verecek şekilde güncelleyin. Örneğin:

uv_build>=0.13.0,<0.14

Kırıcı Değişiklikler​

• Varsayılan stable version olarak Python 3.15 kullanılıyor
  
  Varsayılan stable Python version 3.14’ten 3.15’e değiştirildi. Bu, herhangi bir version istenmediğinde veya pin edilmediğinde yapılan Python download’larını etkiliyor; örneğin uv python install.
  
  uv, sistemde zaten bulunan compatible Python installation’ları kullanmaya devam ediyor. Örneğin uv venv, kurulu Python 3.14’ü hâlâ kullanabiliyor. Uygun interpreter bulunmuyorsa ve automatic download açıksa uv venv ve uvx python gibi command’lar artık Python 3.15 indirebiliyor.
  
  Bu davranışı devre dışı bırakmak için Python 3.14 açıkça istenebilir:

uv venv --python 3.14
Project’lerde version’ı .python-version içine kaydetmek için:

uv python pin 3.14

• Included constraints file’lar içindeki --require-hashes artık uygulanıyor
  
  Önceden uv, requirements file içinden -c ile include edilen constraints file’lardaki --require-hashes directive’ini yok sayıyordu. Artık bu directive uygulanıyor ve installation içindeki tüm requirement’lar için hash zorunlu tutuluyor. Önceden başarılı olan install’lar eksik hash varsa artık başarısız olabilir.
  
  Directive mevcutken bu davranış devre dışı bırakılamıyor. Eksik hash’leri requirement’lara ekleyin veya hash checking istenmiyorsa included constraints file içindeki --require-hashes directive’ini kaldırın.
• Windows ARM64’te native Python tercih ediliyor
  
  Önceden uv’nin ARM64 build’leri native wheel desteği sınırlı olduğu için emulated x86_64 Python installation’larını tercih ediyordu. Artık uv, tüm Python version’larında native ARM64 (aarch64) interpreter’ları tercih ediyor.
  
  Native interpreter bulunamazsa uv sırasıyla x86_64 ve ardından 32-bit x86 kullanmaya devam ediyor.
  
  Eski davranışı kullanmak için:

UV_PYTHON_ARCH=x86_64
veya explicit architecture belirtilebilir:

cpython-3.14-windows-x86_64
setup-uv kullanıyorsanız python-arch: x86_64 ayarlanabilir.

• Included constraints file’lardaki editable requirement’lar reddediliyor
  
  Önceden uv, requirements file içinden -c ile include edilen constraints file’lardaki editable (-e) requirement’ları sessizce yok sayıyordu. Artık pip davranışıyla uyumlu olarak error veriliyor.
  
  Bu davranış devre dışı bırakılamıyor. Editable requirement’ları -r ile geçirilen bir requirements file’a taşıyın veya doğrudan --editable ile belirtin.
• Python 3.10 ve sonrasında distutils startup patch kaldırıldı
  
  Önceden uv, distutils configuration’ın installation path’lerini değiştirmesini önlemek için her yeni virtual environment’a _virtualenv.py ve _virtualenv.pth ekliyordu. Artık virtualenv 21.6.0 gibi uv de Python 3.10 ve sonrasında bu file’ları eklemiyor; çünkü bu Python version’ları ilgili configuration key’lerini zaten yok sayıyor.
  
  Bu değişiklik Python startup overhead’i azaltıyor. Python 3.9 ve öncesinde patch kullanılmaya devam ediyor.
  
  Bu davranış devre dışı bırakılamıyor. Mevcut virtual environment’lar otomatik olarak değiştirilmez. Patch’i kaldırmak için environment’ı Python 3.10 veya sonrası ile yeniden oluşturun.
  
  Bu değişiklik no-distutils-patch preview feature’ını stable hâle getiriyor.
• Requirement-file option değerleri artık tek path olarak değerlendiriliyor
  
  Önceden uv, --constraint, --override, --exclude ve --build-constraint değerlerini quotation mark içinde olsalar bile space karakterlerinden bölüyordu. Artık her value tek bir path kabul ediliyor; böylece içinde space bulunan file path’leri destekleniyor.
  
  Bu davranış devre dışı bırakılamıyor. Birden fazla file vermek için option’ı tekrarlayın.
  
  Eski:

-c "a.txt b.txt"
Yeni:

-c a.txt -c b.txt
UV_CONSTRAINT, UV_OVERRIDE, UV_EXCLUDE ve UV_BUILD_CONSTRAINT içindeki space-separated list desteği devam ediyor.

• Tar archive’lar için varsayılan olarak tar-codec kullanılıyor
  
  Önceden uv, tar archive extract etmek, uv_build ile source distribution oluşturmak ve uv publish sırasında metadata okumak için astral-tokio-tar kullanıyordu. Artık daha strict archive validation uygulayan tar-codec kullanılıyor.
  
  uv, önceki sürümlerin kabul ettiği hard link veya desteklenmeyen tar extension içeren archive’ları artık reddedebilir. uv_build ile oluşturulan source distribution’ların archive byte ve hash değerleri de değişebilir.
  
  Eski backend’e dönmek için:

UV_LEGACY_TAR_BACKEND=1
Bu değişiklik tar-codec preview feature’ını stable hâle getiriyor.

• uv build --clear, build source içeren output directory’leri reddediyor
  
  Önceden uv build --clear, output directory build source’u içeriyorsa project’i veya input source distribution’ı silebiliyordu. Artık uv, symlink üzerinden erişilen equivalent path’ler dahil olmak üzere bu tür output directory’leri herhangi bir build output temizlemeden önce reddediyor.
  
  Build source içermeyen farklı bir output directory seçin veya --clear kullanmayın.

İyileştirmeler​

• uv cache prune artık orphaned temporary build environment’ları da temizliyor.
• PEP 508 marker operator’ları grouped expression’lardan hemen önce doğrudan kullanılabiliyor.
• Malformed requirements-file option’ları artık kısmen parse edilmek veya yok sayılmak yerine reddediliyor.
• Managed Python uninstall işlemi başarısız olduğunda alttaki filesystem ve registry error’ları gösteriliyor.
• Python mirror error’larında geçersiz source URL artık açıkça belirtiliyor.

Önizleme Özellikleri​

• uv audit report’larında preferred advisory ID’ler gösteriliyor; öncelik sırası PYSEC, GHSA ve ardından CVE.

Yapılandırma​

• GraalPy için custom installation mirror desteği eklendi.
• Pyodide için custom installation mirror desteği eklendi.
• UV_NO_CACHE=false, configuration içindeki no-cache = true değerini override edebiliyor.
• Geçersiz trusted-host port’ları ve preview-feature list entry’leri için daha kesin error location bilgileri gösteriliyor.

Performans​

• Environment oluşturulduktan sonra interpreter cache warm edilerek sonraki command’ların daha hızlı çalışması sağlandı.
• 16 KiB signature page kullanan ARM64 macOS release’lerinde code-signature verification işi azaltıldı.
• Package index ve --find-links page’leri astral-html ile parse edilirken resource limit uygulanıyor.
• Kullanılmayan Zstandard desteği çıkarılarak standalone uv-build executable boyutu %7,5 azaltıldı.
• Configuration deserialization sadeleştirilerek uv binary boyutu yaklaşık 232 KB azaltıldı.
• Python download error formatting kodu ortak formatter kullanacak şekilde küçültüldü.

Hata Düzeltmeleri​

• --no-require-hashes veya require-hashes = false kullanılsa bile sağlanan hash’ler artık doğrulanıyor.
• Script environment oluşturulurken exact managed Python patch pin’leri korunuyor; patch upgrade takip edilmiyor.
• Dependency override ve constraint’lerin, ilgili extra seçilmediğinde optional dependency’leri etkinleştirmesi engellendi.
• Extra yalnızca incompatible environment’larda etkinleşiyorsa optional dependency’ler export’tan çıkarılıyor.
• Explicit uv publish --trusted-publishing değerleri artık configuration’dan daha yüksek önceliğe sahip.
• UV_OFFLINE=false, configuration içindeki offline = true değerini override edebiliyor.
• UV_SYSTEM_CERTS=false, configuration içindeki system-certs = true değerini override edebiliyor.
• uv auth login artık IPv6 loopback address üzerinden çalışabiliyor.
• Git reference içinde # veya % bulunan GitHub dependency’leri doğru şekilde resolve ediliyor.
• Mevcut Pyodide interpreter’lar artık Pyodide Python request’lerini karşılıyor olarak tanınıyor.
• uv version ve uv self version, tek bir --quiet flag ile JSON output’u koruyor.
• Subprocess keyring’lerden dönen password’ların sonundaki space ve tab karakterleri korunuyor.
• WHEEL metadata birden fazla expanded Tag: satırı içerdiğinde wheel incompatibility hint’leri yeniden gösteriliyor.
• Windows’ta wheel-script rename error’ları, cross-drive copy fallback uygulanmadığı sürece korunuyor.
• Workspace root’taki project değiştirildikten sonra workspace-cache assertion failure oluşması engellendi.
• Yok sayılan --keyring-provider seçeneği uv auth help çıktısından gizlendi.
• İsimsiz uv tool requirement’ları resolve edilirken HTTP client setup failure’ları doğrudan raporlanıyor.

Dokümantasyon​

• Docker ve AWS Lambda örnekleri, project manifest olmadan frozen lockfile kullanarak dependency layer cache edecek şekilde güncellendi.
• Rust crate dokümantasyonundaki eski link ve description’lar düzeltildi.
• required-environments dokümantasyonundaki bir yazım hatası düzeltildi.

Python​

• CPython 3.15.0rc3 eklendi.

Önizleme Özellikleri​

• Workspace manifest bulunmadan uv.lock üzerinden senkronizasyon desteği eklendi: frozen-lockfile ile uv sync --frozen.
• Workspace manifest bulunmadan uv.lock üzerinden export desteği eklendi: frozen-lockfile ile uv export --frozen.
• Workspace manifest bulunmadan uv.lock üzerinden dependency tree inceleme desteği eklendi: frozen-lockfile ile uv tree --frozen.
• Workspace manifest bulunmadan uv.lock üzerinden workspace metadata inceleme ve isteğe bağlı olarak environment senkronizasyonu desteği eklendi: frozen-lockfile ile uv workspace metadata --frozen.

Hata Düzeltmeleri​

• Çakışan dependency seçimleri arasında workspace member’ları için alternatif source kullanımının kabul edilmesi engellendi; böylece kurulamayacak lockfile’ların oluşturulması önleniyor.
• Windows ARM64 üzerinde emulation altında çalışan x86-64 Python interpreter’ların, source’tan build etmek yerine uyumlu win_amd64 wheel’leri kurabilmesi sağlandı.

Python​

• CPython 3.10.22, 3.11.17, 3.12.15, 3.13.16 ve 3.14.8 eklendi.

İyileştirmeler​

• Wheel platform tag’lerinde büyük harfli release suffix’leri kabul ediliyor.
• Workspace member’ların varsayılan grupları lockfile’lara kaydediliyor.
• Workspace member dependency-group Python gereksinimleri lockfile’lara kaydediliyor.
• Project olmayan workspace root’ları için varsayılan gruplar lockfile’lara kaydediliyor.
• Project olmayan workspace root’ları için dependency-group Python gereksinimleri lockfile’lara kaydediliyor.
• CLI mesajlarında URL ve path biçimlendirmesi tutarlı hâle getirildi.
• Desteklenmeyen --offline seçeneği uv publish yardımından gizlendi.

Önizleme özellikleri​

• uv audit, --no-default-groups seçeneğine artık uyuyor.
• uv audit veya uv tool audit offline çalıştırıldığında daha açık bir hata gösteriliyor ve desteklenmeyen seçenek yardım metninden gizleniyor.

Yapılandırma​

• Python sürümünden bağımsız olarak interpreter mimarisi seçebilmek için UV_PYTHON_ARCH eklendi.

Performans​

• Gömülü Python indirme metadata’sı sıkıştırılarak uv binary boyutu küçültüldü.

Hata Düzeltmeleri​

• Relock işlemi sırasında değişmemiş gereksinimler mevcut lockfile hash’leriyle doğrulanıyor.
• Project olmayan workspace root’larındaki dependency-group Python gereksinimlerine uyuluyor.
• Frozen sync sırasında seçilen her workspace member’ın kaydedilmiş varsayılan grupları kullanılıyor.
• Gerekli workspace member’lar için oluşan hatalı entry-point uyarıları engellendi.

Diğer Değişiklikler​

• uv derlemek için desteklenen minimum Rust sürümü 1.97’ye yükseltildi ve toolchain Rust 1.99’a güncellendi.

Python​

• CPython, OpenSSL 3.5.9 kullanacak şekilde güncellendi.

İyileştirmeler​

• Yalnızca manifest alt tablolarını içeren lockfile dosyalarındaki boş [manifest] tabloları artık dahil edilmiyor.

Önizleme özellikleri​

• resolution-inputs önizleme özelliğiyle, ön sürümleri içerenler dahil olmak üzere gereksiz çalışma zamanı kısıtlamaları uv.lock dosyasından çıkarılıyor.

Hata düzeltmeleri​

• uv python pin --rm komutunun --global kullanılmadan global .python-versions dosyasını kaldırması engellendi.
• Yüklü paket kontrollerinin, ön sürümlerde özel alt sınırlarla birlikte post-release sürümleri yanlışlıkla uyumsuz olarak raporlaması düzeltildi.