Skip to content

docs(errors): rebuild Python exception hierarchy for 2.x - #272

Merged
yaythomas merged 1 commit into
mainfrom
fix/errors-v2-hierarchy
Sep 8, 2026
Merged

docs(errors): rebuild Python exception hierarchy for 2.x#272
yaythomas merged 1 commit into
mainfrom
fix/errors-v2-hierarchy

Conversation

@ayushiahjolia

Copy link
Copy Markdown
Contributor

Issue #, if available: aws/aws-durable-execution-sdk-python#663

Description of changes:
The Python error hierarchy on the error-handling page described the 1.x tree.
Update it to 2.x: drop the removed UserlandError and CallableRuntimeError, add the DurableOperationError base (StepError,
InvokeError, ChildContextError, WaitForConditionError, BatchCompletionError, and the graded CallbackError subtypes), reparent SerDesError under DurableExecutionsError, and add RetryableSerDesError. Updates the mermaid diagram, prose, and the exception-hierarchy.py example.

Checks: mdformat --check, codespell, check_example_refs.py, and zensical build --clean all pass.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@ayushiahjolia
ayushiahjolia marked this pull request as ready for review August 31, 2026 21:48
@ayushiahjolia
ayushiahjolia deployed to ai-pr-review-runtime August 31, 2026 21:48 — with GitHub Actions Active
Comment thread examples/python/sdk-reference/error-handling/exception-hierarchy.py

@yaythomas yaythomas left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the Python tab under Serialization errors still says that serialization or deserialization failures always raise SerDesError and do not retry. Please revise that section to distinguish permanent failures (SerDesError, no retry) from transient failures (RetryableSerDesError, fail the invocation so the backend retries). Otherwise this page contradicts itself, as well as the new serialization guidance in #275.

Comment thread docs/sdk-reference/error-handling/errors.md Outdated
@yaythomas
yaythomas merged commit 86ffe55 into main Sep 8, 2026
7 of 9 checks passed
@yaythomas
yaythomas deleted the fix/errors-v2-hierarchy branch September 8, 2026 18:49
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.

3 participants