Skip to content

feat!: Allow multiple versions of an extension in an ExtensionRegistry#3005

Merged
aborgna-q merged 2 commits intomainfrom
ab/multi-ext-registry-py
Apr 1, 2026
Merged

feat!: Allow multiple versions of an extension in an ExtensionRegistry#3005
aborgna-q merged 2 commits intomainfrom
ab/multi-ext-registry-py

Conversation

@aborgna-q
Copy link
Copy Markdown
Collaborator

Breaking part of #3000 for the python interface:

Allows ExtensionRegistryes to contain multiple versions of the same registry.
Since the extensions attribute was public changing this was a breaking change.

This PR replaces it with a versioned_extensions: dict[ExtensionId, ExtensionVersions], where ExtensionVersions contains multiple versions of the same extension.
It also modifies a couple methods to expose the new behaviour.

We are not actually exploiting the multi-version capability yet. That will be done in a PR actually addressing #3000.

BREAKING CHANGE: ExtensionRegistry may now contain multiple versions of the same extension. .extensions is now an iterator of the latest versions instead of a dictionary. .register_updated and .add_extension have been replaced with a singular .register.

@aborgna-q aborgna-q requested a review from a team as a code owner April 1, 2026 10:25
@aborgna-q aborgna-q requested a review from cqc-alec April 1, 2026 10:25
@aborgna-q aborgna-q added this to the hugr-py 0.16.0 milestone Apr 1, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 1, 2026

Codecov Report

❌ Patch coverage is 87.50000% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 81.30%. Comparing base (6b9aba6) to head (60b7cf8).
⚠️ Report is 3 commits behind head on main.

Files with missing lines Patch % Lines
hugr-py/src/hugr/ext.py 85.48% 9 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #3005      +/-   ##
==========================================
- Coverage   81.30%   81.30%   -0.01%     
==========================================
  Files         240      240              
  Lines       45356    45392      +36     
  Branches    39160    39160              
==========================================
+ Hits        36876    36905      +29     
- Misses       6490     6497       +7     
  Partials     1990     1990              
Flag Coverage Δ
python 88.89% <87.50%> (-0.05%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

"""

id: ExtensionId
latest_version: Version
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Maybe id and latest_version could be underscored as well?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Made them hidden, and added an id(self) getter. The latest version can be accessed via .latest.version

@aborgna-q aborgna-q added this pull request to the merge queue Apr 1, 2026
Merged via the queue into main with commit ee90cd1 Apr 1, 2026
29 checks passed
@aborgna-q aborgna-q deleted the ab/multi-ext-registry-py branch April 1, 2026 11:17
github-merge-queue bot pushed a commit that referenced this pull request Apr 1, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.16.0](hugr-py-v0.15.4...hugr-py-v0.16.0)
(2026-04-01)

This release changes the default text serialization format from JSON to
`MODEL_WITH_EXTS` (the JSON format is now deprecated).
It also adds the ability to link packages and modules from Python,
renders operation type arguments in HUGR visualizations, introduces a
new `debug_info` module for attaching source-level debug metadata to
nodes,
and introduces multi-version support in `ExtensionRegistry`, allowing
different versions of the same extension to coexist in the same
registry.


### ⚠ BREAKING CHANGES

* `ExtensionRegistry` may now contain multiple versions of the same
extension. `.extensions` is now an iterator of the latest versions
instead of a dictionary. `.register_updated` and `.add_extension` have
been replaced with a singular `.register`.
* Default `EnvelopeConfig` changed from `EnvelopeFormat.JSON` to
`EnvelopeFormat.MODEL_WITH_EXTS`.
* Substituted `hugr-py/src/hugr/tys.py::_type_str` with
`hugr-py/src/hugr/utils.py::name_w_args`.

### Features

* Add debug info metadata specification in `hugr-py`
([#2971](#2971))
([a4da8ef](a4da8ef))
* Allow multiple versions of an extension in an ExtensionRegistry
([#3005](#3005))
([ee90cd1](ee90cd1))
* Deprecate JSON serialization format
([#2991](#2991))
([0f7a880](0f7a880))
* Operation parameter rendering in HUGR visualizations
([#2995](#2995))
([d619148](d619148))
* Allow linking packages and modules from Python
([#2947](#2947))
([329c243](329c243))
* Make `_composable_pass` and `_scope` public modules
([#2962](#2962))
([1d6af9a](1d6af9a)),
closes [#2961](#2961)
* Allow missing ext versions ExtensionDesc metadata
([#2979](#2979))
([bc1c445](bc1c445))
* Allow dfg conversion in to TrackedDfg
([#2993](#2993))
([3bd7a88](3bd7a88))


### Bug Fixes

* Allow both _composable_pass and composable_pass imports
([#2965](#2965))
([0a5664d](0a5664d))
* Allow both _scope and scope imports
([#3003](#3003))
([de0458c](de0458c))
* Always do extension resolution when loading packages and hugrs
([#2953](#2953))
([0086d2a](0086d2a))
* Correct pyo3 module definitions and add missing exception class export
([#2964](#2964))
([3df73f4](3df73f4))
* Include extensions during link serialization
([#2992](#2992))
([9236e89](9236e89))
* Prefix names with underscores during serialization
([#2989](#2989))
([8aab636](8aab636))
* Use valid identifiers when constructing AST model
([#2973](#2973))
([8750a6b](8750a6b))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: Agustín Borgna <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants