Skip to content

[docs] Document Python callback handle wrapping fix in Aspire 13.6 - #1614

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-19870-33807223921-1-735f49b2061487c3
Draft

[docs] Document Python callback handle wrapping fix in Aspire 13.6#1614
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-19870-33807223921-1-735f49b2061487c3

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#19870

@sebastienros

Targeting release/13.6 based on the source PR milestone 13.6 (exact match on microsoft/aspire.dev).

Why

PR #19870 fixed a bug where typed integration callbacks exported as Action<IResourceBuilder<T>> (for example, configure_container passed to WithRedisCommander) received a raw, unwrapped Handle in Python guest code. .NET marshalled the callback argument using the generic builder ATS type ID, while the generated Python wrapper registry looked it up by the concrete resource type ID, so calls like with_host_port failed at runtime. Generated callback registrations now carry their concrete handle parameter type IDs, and the Python runtime falls back to that metadata only when no wrapper is registered for the incoming type ID.

This is a user-facing fix affecting anyone writing Python AppHosts that use typed resource-builder callbacks, so it needed a documentation update.

What changed

  • src/frontend/src/content/docs/whats-new/aspire-13-6.mdx — added a bullet under "Integration updates" noting the fix, with the concrete example (configure_container / WithRedisCommander) from the source PR's "User-facing usage" section.
  • src/frontend/src/content/docs/extensibility/multi-language-integration-authoring.mdx — added a note in the "Callback context types and the ATS-first editor pattern" section explaining that Action<IResourceBuilder<T>> callback parameters are marshalled using the concrete resource type's identity so guest-language wrappers (e.g., Python) resolve to the correct typed handle.

Both are edits to existing pages; no new pages were created.

Generated by PR Documentation Check for #19870 · auto · 118.1 AIC · ⌖ 17.6 AIC · ⊞ 19.6K ·

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Sep 3, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1614. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1614 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants