Skip to content

feat(manifest): deprecate the top-level exclude-newer tables - #7248

Merged
lucascolley merged 8 commits into
mainfrom
exclude-newer-exemptions-4-deprecate
Oct 26, 2026
Merged

lucascolley merged 8 commits into
mainfrom
exclude-newer-exemptions-4-deprecate

Conversation

@pavelzw

@pavelzw pavelzw commented Oct 13, 2026 •

Copy link
Copy Markdown
Collaborator

Description

The top-level [exclude-newer] and [pypi-exclude-newer] tables of
per-package cutoffs keep working but emit a deprecation warning.

A zero cutoff such as "0d" lifts the cutoff for every release of the
package, which is exactly what the wildcard exemption "*" does, so the
warning suggests the matching exemptions. Other per-package cutoffs
have no replacement, and the warning says they stop working once the
tables are removed. Since conda exemptions require a cutoff, a
workspace without one is told to set a cutoff first instead of being
shown an invalid replacement.

Part of #7179 and #6479.

Stack (review and merge in order):

  1. feat(spec): support exemptions in the resolved exclude-newer config #7250
  2. feat(manifest): read exemptions from exclude-newer in [workspace] #7246
  3. feat(lock): honor exclude-newer exemptions in satisfiability #7247
  4. feat(manifest): deprecate the top-level exclude-newer tables #7248 👈 this PR
  5. feat(global): use match spec exemptions in exclude-newer #7249
  6. docs: document exclude-newer exemptions #7251
  7. chore: update rattler and rattler-build crates #7267

How Has This Been Tested?

cargo test -p pixi_manifest. Adds snapshot tests for the warnings: a table with a zero cutoff, which gets a suggested exemption, and a table with only non-zero cutoffs, which only gets a removal notice.

AI Disclosure

  • This PR contains AI-generated content.
    • I have tested any AI-generated content in my PR.
    • I take responsibility for any AI-generated content in my PR.

Tools: Claude Code

Checklist:

  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added sufficient tests to cover my changes.
  • I have verified that changes that would impact the JSON schema have been made in schema/model.py.

@pavelzw pavelzw changed the title feat(global): support exemptions in [global.exclude-newer] feat(manifest): deprecate the top-level exclude-newer tables Oct 13, 2026
@pavelzw
pavelzw added this pull request to stack #7252 October 13, 2026 09:02
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 80ae3dc to 78f4aab Compare October 13, 2026 10:57
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 78f4aab to 7568029 Compare October 13, 2026 11:37
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 7568029 to 1a20e98 Compare October 13, 2026 13:20
@pavelzw
pavelzw marked this pull request as ready for review October 13, 2026 13:23
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 1a20e98 to 00b1f24 Compare October 13, 2026 13:43
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 00b1f24 to 5121377 Compare October 13, 2026 13:56
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch from 5121377 to 94197a4 Compare October 13, 2026 20:49
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch 2 times, most recently from f10bb98 to f0acaaf Compare October 14, 2026 21:30
@lucascolley
lucascolley force-pushed the exclude-newer-exemptions-4-deprecate branch from f0acaaf to ac63a5a Compare October 15, 2026 09:40
@pavelzw
pavelzw force-pushed the exclude-newer-exemptions-4-deprecate branch 2 times, most recently from 4ed049b to a68f1c4 Compare October 24, 2026 12:19
Base automatically changed from exclude-newer-exemptions-3-lock-file to main October 26, 2026 09:59
The top-level `[exclude-newer]` and `[pypi-exclude-newer]` tables of
per-package cutoffs keep working but emit a deprecation warning.

A zero cutoff such as `"0d"` lifts the cutoff for every release of the
package, which is exactly what the wildcard exemption `"*"` does, so the
warning suggests the matching `exemptions`. Other per-package cutoffs
have no replacement, and the warning says they stop working once the
tables are removed.
@lucascolley
lucascolley force-pushed the exclude-newer-exemptions-4-deprecate branch from a68f1c4 to 2867df0 Compare October 26, 2026 09:59
@lucascolley
lucascolley removed the request for review from Hofer-Julian October 26, 2026 11:22
The suggested `cutoff` used the `Display` of the timestamp, such as
`2025-01-02 00:00:00 UTC`, which pixi rejects as a cutoff. It is now
written as RFC 3339.
Package names that are not bare TOML keys, such as `ruamel.yaml`, were
written unquoted in the suggested `exemptions`, which TOML reads as
dotted keys of nested tables.
Without any cutoff, a zero per-package cutoff lifts nothing, yet the
help for `[exclude-newer]` suggested setting a workspace cutoff, which
would exclude packages that were not excluded before. The help now says
to remove such entries. With channel cutoffs only, it still suggests a
cutoff but warns that it applies to the other channels too.
The suggested `[workspace.exclude-newer]` table listed only the new
exemptions, so pasting it dropped the existing ones, and next to a bare
`exclude-newer` key it duplicated that key. The example now merges the
existing exemptions and says that it replaces the current value.
In a `pyproject.toml` and in script manifests the deprecated tables live
under `tool.pixi`, but the warning and its example named them as in a
`pixi.toml`, so the suggested `[workspace.exclude-newer]` could not be
pasted as is. The manifest now passes its table prefix to the warning.
Script manifest warnings were logged with their message only, which
dropped the help, and for the `exclude-newer` deprecation that is where
the suggested replacement lives. They are now rendered as diagnostics.
Their spans point into the parsed metadata rather than the script, so
they are still shown without a source snippet.

@lucascolley lucascolley left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pushed 6 commits for you to check @pavelzw, also one question

@pavelzw

pavelzw commented Oct 26, 2026

Copy link
Copy Markdown
Collaborator Author

your changes look good to me, thanks! happy to merge if you are happy

@lucascolley lucascolley left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks, yep let's merge it!

@lucascolley
lucascolley enabled stacked auto-merge (squash) October 26, 2026 14:12
@lucascolley
lucascolley merged commit 3ff8d87 into main Oct 26, 2026
35 checks passed
@lucascolley
lucascolley deleted the exclude-newer-exemptions-4-deprecate branch October 26, 2026 14:27
tenzinplatter added a commit to greenroom-robotics/pixi that referenced this pull request Nov 10, 2026
* feat(lock): honor exclude-newer exemptions in satisfiability (prefix-dev#7247)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor(core): add `Cause` wrapper, type the lock-file load, write and prefix errors (prefix-dev#7314)

* feat(manifest): deprecate the top-level `exclude-newer` tables (prefix-dev#7248)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor(global): type the trampoline, install and completions errors (prefix-dev#7357)

* feat(global): use match spec exemptions in `exclude-newer` (prefix-dev#7249)

* docs: document exclude-newer exemptions (prefix-dev#7251)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor(global): type the global directory and conda-meta errors (prefix-dev#7359)

* chore(ci): Update cargo patches (prefix-dev#7361)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update GitHub Actions (prefix-dev#7362)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update Rust crate rstest to 0.28.0 (prefix-dev#7366)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update Rust crate lzma-rust2 to 0.23 (prefix-dev#7365)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* docs: add `release` scope to automated release commit messages (prefix-dev#7360)

* chore: update rattler and rattler-build crates (prefix-dev#7267)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* chore(ci): Update rattler (prefix-dev#7317)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* feat(cli): add exclude-newer commands for workspaces and pixi global (prefix-dev#7356)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* chore(ci): Update uv to 0.0.92 (prefix-dev#7318)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* chore(ci): Update Swatinem/rust-cache action to v2.9.3 (prefix-dev#7371)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore: add Cargo.lock from pixi-build example (prefix-dev#7372)

* feat: add cutoffs to exclude-newer exemptions (prefix-dev#7363)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* chore(ci): Update uv to 0.0.96 (prefix-dev#7376)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* test: cover cache-name collision for zero-component versions (prefix-dev#7373)

* fix(publish): keep Artifactory context path when uploading (prefix-dev#7388)

* chore(ci): Upgrade Pixi dependencies (prefix-dev#7331)

Co-authored-by: Hofer-Julian <30049909+Hofer-Julian@users.noreply.github.com>

* fix: keep PyPI releases without an upload time for exempted packages (prefix-dev#7374)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* feat(pixi_api): Expose run and shell (prefix-dev#7354)

* feat: per-index exclude-newer for PyPI extra indexes (prefix-dev#7382)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* chore: revamp contributor docs and PR template (prefix-dev#7323)

Co-authored-by: Julian Hofer <julianhofer@gnome.org>
Co-authored-by: Hofer-Julian <30049909+Hofer-Julian@users.noreply.github.com>
Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* feat: add nanobind-dev and python3-typing-extensions as in rosdistro (prefix-dev#7379)

* fix: reuse the build backend environment with a relative exclude-newer (prefix-dev#7384)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* feat(info): show effective TLS root certificates (prefix-dev#7336)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor(global): type the global manifest errors (prefix-dev#7358)

* fix(cli): honour colour settings in help and argument errors (prefix-dev#7396)

* ci: enforce vouching for pull requests (prefix-dev#7390)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor(global): type the project discovery and list errors (prefix-dev#7397)

* refactor(global): type the install and sync errors (prefix-dev#7399)

* feat(pixi-build-backend): let backends generate multi-output recipes (prefix-dev#7381)

* docs: adapt vouch request (prefix-dev#7403)

* docs: clarify how to ping us (prefix-dev#7404)

* refactor(pixi_api): type the shell errors (prefix-dev#7407)

* fix(cache): use xxh3 for all on-disk cache names (prefix-dev#7408)

* feat: add sha256 to workspace explicit export (prefix-dev#7185)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* feat(publish): no `publish = true` required if explicit `--path` option is given (prefix-dev#7355)

* fix: skip system CA store for pypi mapping middleware client (prefix-dev#6936)

Co-authored-by: Bas Zalmstra <4995967+baszalmstra@users.noreply.github.com>

* fix(config)!: make a config file that fails to parse a hard error (prefix-dev#7409)

* refactor(api): type the init errors (prefix-dev#7410)

* chore(pixi-build-ros): add tqdm (prefix-dev#7307)

* fix(global): remove packages with custom exposed names (prefix-dev#7313)

* fix(pixi-build-ros): support cross-compiling `ament_python` packages (prefix-dev#7345)

* chore: fix missing `InitError::Config` (prefix-dev#7413)

* chore: remove duplicate `InitError::Config` (prefix-dev#7415)

* refactor(api): type the workspace setter errors (prefix-dev#7414)

* docs(setup-pixi): Mention setup-pixi being pre-v1 (prefix-dev#7419)

* docs(setup-pixi): Document configuration input and bump to v0.11.3 (prefix-dev#7421)

* docs: Fix PowerShell custom shell example for GitHub Actions (prefix-dev#7423)

* docs(setup-pixi): Fix instructions for enabling debug logging (prefix-dev#7422)

* refactor(api): type the add errors (prefix-dev#7416)

* ci: require approval before publishing releases (prefix-dev#6766)

* refactor(api): type the task errors (prefix-dev#7426)

* chore: add AGENTS.md (prefix-dev#7412)

* fix(tasks): fix various bugs (prefix-dev#7434)

* feat(pixi_api): add GlobalContext with pixi global list (prefix-dev#7387)

* chore(lock): never install the conda prefix in the PyPI satisfiability check (prefix-dev#7427)

* fix(exclude-newer): resolve relative cutoffs once per workspace load (prefix-dev#7435)

* feat(config): add `exclude-newer` (prefix-dev#7385)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* feat(publish): build with the exclude-newer of the workspace (prefix-dev#7386)

* chore(ci): Update GitHub Actions (prefix-dev#7440)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update cargo patches (prefix-dev#7439)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update Rust crate parking_lot to 0.13.0 (prefix-dev#7444)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(release): bump version to v0.84.0 (prefix-dev#7446)

* feat: integrate conda-pypi wheels using released rattler (prefix-dev#7392)

* chore(ci): Update Rust crate lzma-rust2 to 0.24 (prefix-dev#7443)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(ci): Update Rust crate tokio to v1.54.1 (prefix-dev#7445)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* fix(cli): fix multiple reporters problems (prefix-dev#7429)

* chore(ci): Update uv to 0.0.98 (prefix-dev#7442)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* fix(export): honour `--ignore-source-errors` in conda explicit export (prefix-dev#7425)

* feat(pixi-build-ros): rtklib (prefix-dev#7461)

* chore(ci): Upgrade Pixi dependencies (prefix-dev#7468)

Co-authored-by: Hofer-Julian <30049909+Hofer-Julian@users.noreply.github.com>

* chore: adapt to new `exclude-newer` design (prefix-dev#7470)

* ci: publish dev release builds of main via octo-sts (prefix-dev#7193)

* fix(run): detect only the installed environment's host (prefix-dev#7462)

* fix(reporters): hide the repodata bar on clear with downloads in flight (prefix-dev#7459)

Co-authored-by: Hofer-Julian <30049909+Hofer-Julian@users.noreply.github.com>

* refactor(pixi_api): type the run errors (prefix-dev#7463)

* chore(release): bump version to v0.84.1 (prefix-dev#7472)

* feat(pixi_api): add global install and uninstall to GlobalContext (prefix-dev#7447)

* feat: derive PyPI purls for the conda-pypi channel (prefix-dev#7477)

* feat(pixi-build-mojo): add explicit CPU and AMD GPU variants (prefix-dev#7431)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* docs: Add CPU and AMD GPU Mojo package tutorial (prefix-dev#7432)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* refactor: keep miette reports out of library crates (prefix-dev#7465)

* docs: Added documentation for publishing to Artifactory (prefix-dev#7481)

* ci: publish nightly releases from CI build artifacts (prefix-dev#7474)

* ci: cross-compile the linux aarch64 build with cargo-zigbuild (prefix-dev#7482)

* feat: add `pixi self-update --nightly` (prefix-dev#7473)

* fix(cli): reject several exclude-newer exemption specs of one package (prefix-dev#7467)

Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>

* docs: add a virtual package detector example (prefix-dev#7428)

* chore(ci): Update cargo patches (prefix-dev#7495)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

---------

Co-authored-by: Pavel Zwerschke <pavelzw@gmail.com>
Co-authored-by: Lucas Colley <lucas.colley8@gmail.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Wolf Vollprecht <w.vollprecht@gmail.com>
Co-authored-by: prefix-dev-pixi-upgrades[bot] <326415524+prefix-dev-pixi-upgrades[bot]@users.noreply.github.com>
Co-authored-by: Hofer-Julian <30049909+Hofer-Julian@users.noreply.github.com>
Co-authored-by: Felix Häcker <felix@prefix.dev>
Co-authored-by: Bas Zalmstra <4995967+baszalmstra@users.noreply.github.com>
Co-authored-by: Julian Hofer <julianhofer@gnome.org>
Co-authored-by: Ezra Brooks <ezra@brooks.cx>
Co-authored-by: Nicholas Bollweg <nick.bollweg@gmail.com>
Co-authored-by: Tim Clephas <tim.clephas@nobleo.nl>
Co-authored-by: Zhaoqi Xu <lzy00419@outlook.com>
Co-authored-by: Yannik Tausch <dev@ytausch.de>
Co-authored-by: NichMor <nmorkotilo@gmail.com>
Co-authored-by: lldash <michiel.jacobs@vito.be>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants