Skip to content

Commit 4f1ee56

Browse files
authored
Bump version and workflow exception clarification (#196)
1 parent eacdca8 commit 4f1ee56

File tree

3 files changed

+11
-4
lines changed

3 files changed

+11
-4
lines changed

README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -463,8 +463,15 @@ While running in a workflow, in addition to features documented elsewhere, the f
463463

464464
#### Exceptions
465465

466-
* Workflows can raise exceptions to fail the workflow
467-
* Using `temporalio.exceptions.ApplicationError`, exceptions can be marked as non-retryable or include details
466+
* Workflows can raise exceptions to fail the workflow or the "workflow task" (i.e. suspend the workflow retrying).
467+
* Exceptions that are instances of `temporalio.exceptions.FailureError` will fail the workflow with that exception
468+
* For failing the workflow explicitly with a user exception, use `temporalio.exceptions.ApplicationError`. This can
469+
be marked non-retryable or include details as needed.
470+
* Other exceptions that come from activity execution, child execution, cancellation, etc are already instances of
471+
`FailureError` and will fail the workflow when uncaught.
472+
* All other exceptions fail the "workflow task" which means the workflow will continually retry until the workflow is
473+
fixed. This is helpful for bad code or other non-predictable exceptions. To actually fail the workflow, use an
474+
`ApplicationError` as mentioned above.
468475

469476
#### External Workflows
470477

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[tool.poetry]
22
name = "temporalio"
3-
version = "0.1b2"
3+
version = "0.1b3"
44
description = "Temporal.io Python SDK"
55
license = "MIT"
66
authors = ["Temporal Technologies Inc <sdk@temporal.io>"]

temporalio/service.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
import temporalio.bridge.runtime
2525
import temporalio.exceptions
2626

27-
__version__ = "0.1b2"
27+
__version__ = "0.1b3"
2828

2929
ServiceRequest = TypeVar("ServiceRequest", bound=google.protobuf.message.Message)
3030
ServiceResponse = TypeVar("ServiceResponse", bound=google.protobuf.message.Message)

0 commit comments

Comments
 (0)