Undocumented
| Class | |
How an activity cancellation should be handled. |
| Class | |
TypedDict of config that can be used for start_activity and execute_activity. |
| Class | |
Handle returned from start_activity and start_local_activity. |
| Class | |
TypedDict of config that can be used for start_local_activity and execute_local_activity. |
| Async Function | execute |
Start an activity and wait for completion. |
| Async Function | execute |
Start an activity from a callable class and wait for completion. |
| Async Function | execute |
Start an activity from a method and wait for completion. |
| Async Function | execute |
Start a local activity and wait for completion. |
| Async Function | execute |
Start a local activity from a callable class and wait for completion. |
| Async Function | execute |
Start a local activity from a method and wait for completion. |
| Function | start |
Start an activity and return its handle. |
| Function | start |
Start an activity from a callable class. |
| Function | start |
Start an activity from a method. |
| Function | start |
Start a local activity and return its handle. |
| Function | start |
Start a local activity from a callable class. |
| Function | start |
Start a local activity from a method. |
CallableAsyncNoParam[ ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:CallableSyncNoParam[ ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:CallableAsyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:CallableSyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Callable[ ..., Awaitable[ ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Callable[ ..., ReturnType], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:str, arg: Any = temporalio.common._arg_unset, *, args: Sequence[ Any] = [], task_queue: str | None = None, result_type: type | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> Any:Start an activity and wait for completion.
This is a shortcut for await start_activity.
type[ CallableAsyncNoParam[ ReturnType]], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:type[ CallableSyncNoParam[ ReturnType]], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:type[ CallableAsyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:type[ CallableSyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:type[ Callable[ ..., Awaitable[ ReturnType]]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:type[ Callable[ ..., ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Start an activity from a callable class and wait for completion.
This is a shortcut for await start_activity_class.
MethodAsyncNoParam[ SelfType, ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:MethodSyncNoParam[ SelfType, ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:MethodAsyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:MethodSyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Callable[ Concatenate[ SelfType, MultiParamSpec], Awaitable[ ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Callable[ Concatenate[ SelfType, MultiParamSpec], ReturnType], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ReturnType:Start an activity from a method and wait for completion.
This is a shortcut for await start_activity_method.
CallableAsyncNoParam[ ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:CallableSyncNoParam[ ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:CallableAsyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:CallableSyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Callable[ ..., Awaitable[ ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Callable[ ..., ReturnType], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:str, arg: Any = temporalio.common._arg_unset, *, args: Sequence[ Any] = [], result_type: type | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> Any:Start a local activity and wait for completion.
This is a shortcut for await start_local_activity.
type[ CallableAsyncNoParam[ ReturnType]], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:type[ CallableSyncNoParam[ ReturnType]], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:type[ CallableAsyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:type[ CallableSyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:type[ Callable[ ..., Awaitable[ ReturnType]]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:type[ Callable[ ..., ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Start a local activity from a callable class and wait for completion.
This is a shortcut for await start_local_activity_class.
MethodAsyncNoParam[ SelfType, ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:MethodSyncNoParam[ SelfType, ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:MethodAsyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:MethodSyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Callable[ Concatenate[ SelfType, MultiParamSpec], Awaitable[ ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Callable[ Concatenate[ SelfType, MultiParamSpec], ReturnType], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ReturnType:Start a local activity from a method and wait for completion.
This is a shortcut for await start_local_activity_method.
CallableAsyncNoParam[ ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:CallableSyncNoParam[ ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:CallableAsyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:CallableSyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Callable[ ..., Awaitable[ ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Callable[ ..., ReturnType], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:str, arg: Any = temporalio.common._arg_unset, *, args: Sequence[ Any] = [], task_queue: str | None = None, result_type: type | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ Any]:Start an activity and return its handle.
At least one of schedule_to_close_timeout or start_to_close_timeout must be present.
| Parameters | |
activity:Any | Activity name or function reference. |
arg:Any | Single argument to the activity. |
args:Sequence[ | Multiple arguments to the activity. Cannot be set if arg is. |
taskstr | None | Task queue to run the activity on. Defaults to the current workflow's task queue. |
resulttype | None | For string activities, this can set the specific result type hint to deserialize into. |
scheduletimedelta | None | Max amount of time the activity can take from first being scheduled to being completed before it times out. This is inclusive of all retries. |
scheduletimedelta | None | Max amount of time the activity can take to be started from first being scheduled. |
starttimedelta | None | Max amount of time a single activity run can take from when it starts to when it completes. This is per retry. |
heartbeattimedelta | None | How frequently an activity must invoke heartbeat while running before it is considered timed out. |
retrytemporalio.common.RetryPolicy | None | How an activity is retried on failure. If unset, a server-defined default is used. Set maximum attempts to 1 to disable retries. |
cancellationActivityCancellationType | How the activity is treated when it is cancelled from the workflow. |
activitystr | None | Optional unique identifier for the activity. This is an advanced setting that should not be set unless users are sure they need to. Contact Temporal before setting this value. |
versioningVersioningIntent | None | When using the Worker Versioning feature, specifies whether this Activity should run on a worker with a compatible Build Id or not. Deprecated: Use Worker Deployment versioning instead. |
summary:str | None | A single-line fixed summary for this activity that may appear in UI/CLI. This can be in single-line Temporal markdown format. |
priority:temporalio.common.Priority | Priority of the activity. |
| Returns | |
ActivityHandle[ | An activity handle to the activity which is an async task. |
type[ CallableAsyncNoParam[ ReturnType]], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:type[ CallableSyncNoParam[ ReturnType]], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:type[ CallableAsyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:type[ CallableSyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:type[ Callable[ ..., Awaitable[ ReturnType]]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:type[ Callable[ ..., ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Start an activity from a callable class.
See start_activity for parameter and return details.
MethodAsyncNoParam[ SelfType, ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:MethodSyncNoParam[ SelfType, ReturnType], *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:MethodAsyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:MethodSyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Callable[ Concatenate[ SelfType, MultiParamSpec], Awaitable[ ReturnType]], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Callable[ Concatenate[ SelfType, MultiParamSpec], ReturnType], *, args: Sequence[ Any], task_queue: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, heartbeat_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, versioning_intent: VersioningIntent | None = None, summary: str | None = None, priority: temporalio.common.Priority = temporalio.common.Priority.default) -> ActivityHandle[ ReturnType]:Start an activity from a method.
See start_activity for parameter and return details.
CallableAsyncNoParam[ ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:CallableSyncNoParam[ ReturnType], *, activity_id: str | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, summary: str | None = None) -> ActivityHandle[ ReturnType]:CallableAsyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:CallableSyncSingleParam[ ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:Callable[ ..., Awaitable[ ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:Callable[ ..., ReturnType], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:str, arg: Any = temporalio.common._arg_unset, *, args: Sequence[ Any] = [], result_type: type | None = None, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ Any]:Start a local activity and return its handle.
At least one of schedule_to_close_timeout or start_to_close_timeout must be present.
| Parameters | |
activity:Any | Activity name or function reference. |
arg:Any | Single argument to the activity. |
args:Sequence[ | Multiple arguments to the activity. Cannot be set if arg is. |
resulttype | None | For string activities, this can set the specific result type hint to deserialize into. |
scheduletimedelta | None | Max amount of time the activity can take from first being scheduled to being completed before it times out. This is inclusive of all retries. |
scheduletimedelta | None | Max amount of time the activity can take to be started from first being scheduled. |
starttimedelta | None | Max amount of time a single activity run can take from when it starts to when it completes. This is per retry. |
retrytemporalio.common.RetryPolicy | None | How an activity is retried on failure. If unset, an SDK-defined default is used. Set maximum attempts to 1 to disable retries. |
localtimedelta | None | Undocumented |
cancellationActivityCancellationType | How the activity is treated when it is cancelled from the workflow. |
activitystr | None | Optional unique identifier for the activity. This is an advanced setting that should not be set unless users are sure they need to. Contact Temporal before setting this value. |
summary:str | None | Optional summary for the activity. |
| Returns | |
ActivityHandle[ | An activity handle to the activity which is an async task. |
type[ CallableAsyncNoParam[ ReturnType]], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:type[ CallableSyncNoParam[ ReturnType]], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:type[ CallableAsyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:type[ CallableSyncSingleParam[ ParamType, ReturnType]], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:type[ Callable[ ..., Awaitable[ ReturnType]]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:type[ Callable[ ..., ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None) -> ActivityHandle[ ReturnType]:Start a local activity from a callable class.
See start_local_activity for parameter and return details.
MethodAsyncNoParam[ SelfType, ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:MethodSyncNoParam[ SelfType, ReturnType], *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:MethodAsyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:MethodSyncSingleParam[ SelfType, ParamType, ReturnType], arg: ParamType, *, schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:Callable[ Concatenate[ SelfType, MultiParamSpec], Awaitable[ ReturnType]], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:Callable[ Concatenate[ SelfType, MultiParamSpec], ReturnType], *, args: Sequence[ Any], schedule_to_close_timeout: timedelta | None = None, schedule_to_start_timeout: timedelta | None = None, start_to_close_timeout: timedelta | None = None, retry_policy: temporalio.common.RetryPolicy | None = None, local_retry_threshold: timedelta | None = None, cancellation_type: ActivityCancellationType = ActivityCancellationType.TRY_CANCEL, activity_id: str | None = None, summary: str | None = None) -> ActivityHandle[ ReturnType]:Start a local activity from a method.
See start_local_activity for parameter and return details.