iframe-proxy

konstin · 2026-02-03T19:28:54Z

Switch the (preview) default for uv init to a src-package. The package by default has an entrypoint by the name of the package that can be run with uv init foo.

There's effectively three layouts with this change:

package with entrypoint (packaged application, the default)
package without entrypoint (pure lib)
flat main.py application (pure app)

These are selected from among the existing --app/--lib and --package/--no-package flags, as to not cause too much churn. --build-backend still implies --package, with --app --build-backend doesn't change. --bare doesn't add a build system by default.

Testing is a bit awkward, cause there's now all the stable tests and a separate test for the preview behavior, while we'll have to update the stable tests upon stabilization. You can see the effect of stabilization in #19197.

Navigation

There are three branches:

main <- konsti/package-by-default
Package by default: Add in preview #17841
konsti/package-by-default <- konsti/package-by-default-doc-changes
Package by default: Update documentation #19026
konsti/package-by-default <- konsti/package-by-default-stabilize
Package by default: Stabilize preview feature #19197

~~Open~~ Decided design questions

Should the default layout fill out the authors table?
No, the authors field isn't helpful here.
Should --bare also create a (by itself broken) build system by default, without setting --package or --build-backend?
No, we want something that works, and not creating a build backend is very bare. It's slightly inconsistent that effectively --bare is no-package by default, but that's better than the alternatives and explainable as --bare being no-most-things.

codspeed-hq · 2026-03-15T16:53:09Z

Merging this PR will not alter performance

✅ 13 untouched benchmarks

_{Comparing konsti/package-by-default (39c1221) with main (3b8e3ca)}

konstin · 2026-04-27T22:25:28Z

+
+        // Do no fill in `authors` for non-packaged applications unless explicitly requested.
+        let author_from = author_from.unwrap_or_else(|| match self {
+            Self::ApplicationWithLibrary | Self::Library | Self::BareWithBuildBackend => {


Flagging: Should bare with a build backend populate authors?

zsol

overall LGTM but there are a few things we should address in here

zsol · 2026-05-29T13:24:37Z

+    ApplicationOld,
+    // TODO(konsti): Remove when stabilizing.
+    /// Initialize a Python library.
+    LibraryOld,


nit: don't use Old/New, they quickly become confusing :) I'd go with ApplicationWithPackageInitOff and LibraryWithPackageInitOff

This should only be temporary, https://github.com/astral-sh/uv/pull/19197/changes removes the nomenclature entirely, the idea is more like <style>ToBeRemoved and <style>ToBecomeTheDefault

zsol · 2026-05-29T13:29:30Z

+        // Do no fill in `authors` for non-packaged applications unless explicitly requested.
+        let author_from = author_from.unwrap_or_else(|| match self {
+            Self::ApplicationWithLibrary | Self::Library | Self::BareWithBuildSystem => {
+                AuthorFrom::default()
+            }
+            Self::Application | Self::Bare => AuthorFrom::None,
+            Self::ApplicationOld | Self::LibraryOld => unreachable!(),
+        });


I realize this is what you highlight as a question in the PR summary, so let's discuss: What's the downside of filling this out by default?

It's more metadata to maintain, especially since it's filled with whatever name and mail the person who did uv init had configured. We can't infer actual team information, and if it's not distributed as a package, there doesn't seem to much use in the package authors field. It's also taking a lesson from Cargo, which wanted to deprecate the authors field entirely but eventually settled on making it optional and not filling it by default: https://rust-lang.github.io/rfcs/3052-optional-authors-field.html. Python didn't make this same decision, but the considerations of the RFC apply to Python equally.

Sounds good to me!

zsol · 2026-05-29T13:39:50Z

+                let build_backend = build_backend.unwrap_or(ProjectBuildBackend::Uv);
+                pyproject.push('\n');
+                pyproject.push_str(&pyproject_build_system(name, build_backend));
+                pyproject_build_backend_prerequisites(name, path, build_backend)?;


we don't call this in BareWithBuildSystem, which will probably result in a broken configuration with e.g. maturin or scikit. Is that intentional? If so, maybe capture that somewhere?

Edit: I now realize this is another thing you call out, so my opinion is that we shouldn't generate broken configuration if we can help it

Does this mean we should error for uv init --lib --bare or uv init --package --bare? (Given that we shouldn't ignore --lib/--package)

Do you think it's possible to generate something that's not broken? If not, then erroring out would be fine

There's two aspects here:

Stable already allows uv init --bare --package, which creates a [build-system] table without the associated files. Not supporting this anymore would be a regression.

It seems fine to not create a build system with --bare by default, as --bare doesn't create most things we usually create.

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [ghcr.io/astral-sh/uv](https://github.com/astral-sh/uv) | stage | patch | `0.11.20` → `0.11.21` | --- > ⚠️ **Warning** > > Some dependencies could not be looked up. Check the [Dependency Dashboard](issues/155) for more information. --- ### Release Notes <details> <summary>astral-sh/uv (ghcr.io/astral-sh/uv)</summary> ### [`v0.11.21`](https://github.com/astral-sh/uv/blob/HEAD/CHANGELOG.md#01121) [Compare Source](astral-sh/uv@0.11.20...0.11.21) Released on 2026-06-11. ##### Python - Add CPython 3.13.14 and 3.14.6 ([#19787](astral-sh/uv#19787)) ##### Preview features - Add `environment.root` to `uv workspace metadata --sync` ([#19760](astral-sh/uv#19760)) - Allow `uv upgrade` to update a single dependency constraint ([#19738](astral-sh/uv#19738)) - Compute and pass `uv workspace metadata` payload in `ty check` ([#19763](astral-sh/uv#19763)) - Make packaged applications the default for `uv init` ([#17841](astral-sh/uv#17841)) ##### Performance - Add parallel discovery of Python versions for `uv python list` ([#18684](astral-sh/uv#18684)) - Avoid normalizing source distribution names twice ([#19784](astral-sh/uv#19784)) ##### Bug fixes - Improve cache robustness and pruning behavior - Allow CI cache pruning without an sdist bucket ([#19802](astral-sh/uv#19802)) - Avoid overflow when reading malformed cache entries ([#19799](astral-sh/uv#19799)) - Preserve cached Python downloads during cache pruning ([#19795](astral-sh/uv#19795)) - Reject running inside the cache ([#19659](astral-sh/uv#19659)) - Fix Python discovery and version request edge cases - Avoid panics for Unicode Python version requests ([#19797](astral-sh/uv#19797)) - Fix handling of non-critical errors in `uv python list` with path requests ([#19774](astral-sh/uv#19774)) - Fix stop-discovery-at regression ([#19769](astral-sh/uv#19769)) - Harden parsing and validation for package metadata, requirements, markers, URLs, and conflict sets - Allow trailing commas in version specifiers ([#19806](astral-sh/uv#19806)) - Avoid panics for invalid UTF-8 URL credentials ([#19800](astral-sh/uv#19800)) - Avoid panics for malformed source distribution filenames ([#19776](astral-sh/uv#19776)) - Avoid panics for trailing extra separators ([#19779](astral-sh/uv#19779)) - Avoid stack overflow for recursive requirements path aliases ([#19777](astral-sh/uv#19777)) - Ignore reversed string compatible-release markers ([#19782](astral-sh/uv#19782)) - Reject duplicate entries in conflict sets ([#19801](astral-sh/uv#19801)) - Reject malformed hash options in requirements files ([#19783](astral-sh/uv#19783)) - Reject source distribution filenames without a separator ([#19803](astral-sh/uv#19803)) - Use UTF-8 lengths for requirement errors ([#19781](astral-sh/uv#19781)) - Use UTF-8 lengths for trailing marker errors ([#19796](astral-sh/uv#19796)) - Use byte offsets when peeking over requirements ([#19780](astral-sh/uv#19780)) - Validate GraalPy ABI suffixes ([#19805](astral-sh/uv#19805)) - Improve wheel entry-point error handling and virtual environment activation quoting - Propagate errors when reading wheel entry points ([#19794](astral-sh/uv#19794)) - Quote virtual environment activation paths with shell metacharacters ([#19798](astral-sh/uv#19798)) </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).  Co-authored-by: Renovate Bot <renovate@bhamm-lab.com> Reviewed-on: https://codeberg.org/blake-hamm/bhamm-lab/pulls/194

This PR contains the following updates: | Package | Update | Change | |---|---|---| | [uv](https://github.com/astral-sh/uv) | patch | `0.11.19` → `0.11.21` | --- ### Release Notes <details> <summary>astral-sh/uv (uv)</summary> ### [`v0.11.21`](https://github.com/astral-sh/uv/blob/HEAD/CHANGELOG.md#01121) [Compare Source](astral-sh/uv@0.11.20...0.11.21) Released on 2026-06-11. ##### Python - Add CPython 3.13.14 and 3.14.6 ([#19787](astral-sh/uv#19787)) ##### Preview features - Add `environment.root` to `uv workspace metadata --sync` ([#19760](astral-sh/uv#19760)) - Allow `uv upgrade` to update a single dependency constraint ([#19738](astral-sh/uv#19738)) - Compute and pass `uv workspace metadata` payload in `ty check` ([#19763](astral-sh/uv#19763)) - Make packaged applications the default for `uv init` ([#17841](astral-sh/uv#17841)) ##### Performance - Add parallel discovery of Python versions for `uv python list` ([#18684](astral-sh/uv#18684)) - Avoid normalizing source distribution names twice ([#19784](astral-sh/uv#19784)) ##### Bug fixes - Improve cache robustness and pruning behavior - Allow CI cache pruning without an sdist bucket ([#19802](astral-sh/uv#19802)) - Avoid overflow when reading malformed cache entries ([#19799](astral-sh/uv#19799)) - Preserve cached Python downloads during cache pruning ([#19795](astral-sh/uv#19795)) - Reject running inside the cache ([#19659](astral-sh/uv#19659)) - Fix Python discovery and version request edge cases - Avoid panics for Unicode Python version requests ([#19797](astral-sh/uv#19797)) - Fix handling of non-critical errors in `uv python list` with path requests ([#19774](astral-sh/uv#19774)) - Fix stop-discovery-at regression ([#19769](astral-sh/uv#19769)) - Harden parsing and validation for package metadata, requirements, markers, URLs, and conflict sets - Allow trailing commas in version specifiers ([#19806](astral-sh/uv#19806)) - Avoid panics for invalid UTF-8 URL credentials ([#19800](astral-sh/uv#19800)) - Avoid panics for malformed source distribution filenames ([#19776](astral-sh/uv#19776)) - Avoid panics for trailing extra separators ([#19779](astral-sh/uv#19779)) - Avoid stack overflow for recursive requirements path aliases ([#19777](astral-sh/uv#19777)) - Ignore reversed string compatible-release markers ([#19782](astral-sh/uv#19782)) - Reject duplicate entries in conflict sets ([#19801](astral-sh/uv#19801)) - Reject malformed hash options in requirements files ([#19783](astral-sh/uv#19783)) - Reject source distribution filenames without a separator ([#19803](astral-sh/uv#19803)) - Use UTF-8 lengths for requirement errors ([#19781](astral-sh/uv#19781)) - Use UTF-8 lengths for trailing marker errors ([#19796](astral-sh/uv#19796)) - Use byte offsets when peeking over requirements ([#19780](astral-sh/uv#19780)) - Validate GraalPy ABI suffixes ([#19805](astral-sh/uv#19805)) - Improve wheel entry-point error handling and virtual environment activation quoting - Propagate errors when reading wheel entry points ([#19794](astral-sh/uv#19794)) - Quote virtual environment activation paths with shell metacharacters ([#19798](astral-sh/uv#19798)) ### [`v0.11.20`](https://github.com/astral-sh/uv/blob/HEAD/CHANGELOG.md#01120) [Compare Source](astral-sh/uv@0.11.19...0.11.20) Released on 2026-06-10. ##### Enhancements - Add `--emit-index-url` and `--emit-find-links` to `uv export` ([#18370](astral-sh/uv#18370)) - Add `--find-links` support for `uv pip list` ([#16103](astral-sh/uv#16103)) - Group executable install errors during `uv python install` ([#19691](astral-sh/uv#19691)) - Use ICF in macOS release builds to reduce binary sizes ([#19615](astral-sh/uv#19615)) ##### Preview features - Add initial hidden `uv upgrade` command ([#19678](astral-sh/uv#19678)) - Reject Git revisions in `uv upgrade` ([#19742](astral-sh/uv#19742)) ##### Configuration - Recognize `UV_NO_INSTALL_PROJECT`, `UV_NO_INSTALL_WORKSPACE`, `UV_NO_INSTALL_LOCAL` ([#19323](astral-sh/uv#19323)) ##### Performance - Speed up discovery of large workspaces ([#18311](astral-sh/uv#18311)) ##### Bug fixes - Allow unknown preview flags with a warning again ([#19669](astral-sh/uv#19669)) - Apply dependency exclusions to direct requirements ([#19699](astral-sh/uv#19699)) - Avoid following external symlinks during cache clean ([#19682](astral-sh/uv#19682)) - Avoid following symlinks during cache prune ([#19543](astral-sh/uv#19543)) - Fix Git cache keys for worktrees and packed refs ([#19706](astral-sh/uv#19706)) - Make resolver error handling iterative to avoid stack overflows ([#19695](astral-sh/uv#19695)) - Pass `VIRTUAL_ENV` through `cygpath` inside `fish` on Windows ([#19703](astral-sh/uv#19703)) - Rebuild explicit local directory tool installs ([#19591](astral-sh/uv#19591)) - Validate egg top-level entries as identifiers ([#19679](astral-sh/uv#19679)) ##### Documentation - Document `--find-links` caching behavior ([#19585](astral-sh/uv#19585)) - Add a small section for malware checks ([#19680](astral-sh/uv#19680)) </details> --- ### Configuration 📅 **Schedule**: (in timezone Europe/London) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).  Reviewed-on: https://forgejo.hayden.moe/hayden/phoebe/pulls/92

konstin force-pushed the konsti/package-by-default branch 5 times, most recently from d24977d to 41931f4 Compare February 20, 2026 14:15

konstin force-pushed the konsti/package-by-default branch from 41931f4 to 63b394e Compare March 26, 2026 12:02

konstin added preview Experimental behavior enhancement New feature or improvement to existing functionality labels Mar 26, 2026

konstin force-pushed the konsti/package-by-default branch 2 times, most recently from 96ad72e to 986e822 Compare March 26, 2026 16:10

konstin force-pushed the konsti/package-by-default branch 4 times, most recently from e389a8a to a3cbb2d Compare April 16, 2026 13:54

konstin force-pushed the konsti/package-by-default branch from a3cbb2d to 8e7f3b9 Compare April 27, 2026 20:33

konstin changed the title ~~Package by default~~ Package by default: Add preview feature Apr 27, 2026

konstin changed the title ~~Package by default: Add preview feature~~ Package by default: Add in preview Apr 27, 2026

konstin commented Apr 27, 2026

View reviewed changes

konstin force-pushed the konsti/package-by-default branch from 77ed055 to e44f8c1 Compare April 27, 2026 23:20

konstin marked this pull request as ready for review April 28, 2026 00:36

konstin requested a review from zanieb April 28, 2026 00:38

konstin force-pushed the konsti/package-by-default branch from e44f8c1 to 9ee4139 Compare May 16, 2026 20:38

zsol approved these changes May 29, 2026

View reviewed changes

zsol reviewed May 29, 2026

View reviewed changes

Comment thread crates/uv/src/settings.rs

Comment thread crates/uv/src/settings.rs

konstin force-pushed the konsti/package-by-default branch from 386eac8 to b6c5328 Compare June 1, 2026 11:01

zsol mentioned this pull request Jun 3, 2026

uv init --package generates an invalid layout for -stubs packages #19663

Open

zsol approved these changes Jun 3, 2026

View reviewed changes

konstin force-pushed the konsti/package-by-default branch from 57d3b49 to f7dd196 Compare June 9, 2026 08:21

Package by default

682293c

konstin added 2 commits June 9, 2026 16:20

review

a4b736b

Detect --virtual conflicts

39c1221

konstin force-pushed the konsti/package-by-default branch from f7dd196 to 39c1221 Compare June 9, 2026 14:20

konstin merged commit ab62196 into main Jun 10, 2026
56 checks passed

konstin deleted the konsti/package-by-default branch June 10, 2026 08:26

BrewTestBot mentioned this pull request Jun 11, 2026

uv 0.11.21 Homebrew/homebrew-core#287514

Merged

kind	package	template
(default)	(default)	entrypoint + package exposing `hello()`
(default)	`--package`	entrypoint + package exposing `hello()`
(default)	`--no-package`	`main.py` with `main()`
`--app`	(default)	`main.py` with `main()`
`--app`	`--package`	entrypoint + package exposing `hello()`
`--app`	`--no-package`	`main.py` with `main()`
`--lib`	(default)	package exposing `hello()`
`--lib`	`--package`	package exposing `hello()`
`--lib`	`--no-package`	Error: libraries are always packaged

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

Conversation

konstin commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codspeed-hq Bot commented Mar 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will not alter performance

Uh oh!

Choose a reason for hiding this comment

Uh oh!

zsol left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

konstin Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

konstin commented Feb 3, 2026 •

edited

Loading

codspeed-hq Bot commented Mar 15, 2026 •

edited

Loading

konstin Jun 1, 2026 •

edited

Loading