Enhanced, asyncio-compatible client for AWS Step Functions.
Project description
sfn_workflow_client
Enhanced, asyncio-compatible client for AWS Step Functions.
Features:
- Trigger new executions
- Query for state machine execution status
- Wait for an execution to complete
- Fetch execution history
Table of Contents:
Installation
sfn_workflow_client requires Python 3.6 or above.
pip install sfn_workflow_client
Guide
from sfn_workflow_client.enums import ExecutionStatus
from sfn_workflow_client.workflow import Workflow
# Initialize a workflow client
workflow = Workflow("my-state-machine")
# Fetch all executions
collection = await workflow.executions.fetch()
# Fetch currently running executions
collection = await workflow.executions.fetch(status=ExecutionStatus.running)
# Start a new execution
execution = await workflow.executions.create().start()
# Start a new execution and wait until it completes (useful for tests)
execution = await workflow.executions.start_sync()
# Find an execution by trace ID (for tests)
execution = await workflow.executions.fetch().find_by_trace_id("abc")
# Fetch the event history of an execution
events = await execution.events.fetch()
Development
To develop sfn_workflow_client, install dependencies and enable the pre-commit hook:
pip install pre-commit tox
pre-commit install
To run functional tests, you need to create an AWS IAM role with permissions to:
- Create/update/delete state machines
- Start/stop executions
Set the following environment variables:
AWS_ACCOUNT_ID
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_DEFAULT_REGION
AWS_IAM_ROLE_ARN
To run tests:
tox
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sfn_workflow_client-0.5.0.tar.gz
(12.4 kB
view hashes)
Built Distribution
Close
Hashes for sfn_workflow_client-0.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | bbb5f5ef3b06b28df1c585f0591f6e2b06c142aa27de4205a728233ee4ff995e |
|
MD5 | d23f484a7ac0d0ff7c4146266fbf1e95 |
|
BLAKE2b-256 | 1b5ae42dbba1bf1772aea544d7fe2fb4dfac4bd5b38cf54d329a30b83ee498b2 |
Close
Hashes for sfn_workflow_client-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a92bedc7c7863cb2ccaaa2673135d2d894179b48d069108abb2c90a6378c71b2 |
|
MD5 | d46ab7e97ec224cebc48dbf9a61bd87b |
|
BLAKE2b-256 | ada18bd31c956d3ea44d96c71c1ea4bd458c62ae07b9f518dfb50575beecb9c9 |