winterbaume-sfn 0.2.0

Step Functions service implementation for winterbaume
Documentation

winterbaume-sfn

Step Functions service implementation for winterbaume.

This crate is part of the winterbaume workspace — a suite of in-process AWS service mocks for Rust. Use the umbrella winterbaume crate to pull in all services at once, or depend on this crate directly for Step Functions only.

Winterbäume is not affiliated with, endorsed by, or sponsored by Amazon Web Services, Inc. or Amazon.com, Inc. Amazon Web Services, AWS, and related marks are trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.

Coverage

Metric Value
Service Step Functions
AWS model sfn
Protocol awsJson1.0
winterbaume coverage 35/37 operations (94.6%)
stubs (routed, returns empty/default) 2/37 operations (5.4%)
moto coverage 29/37 operations (78.4%)
floci coverage 0/37 operations (0.0%)
kumo coverage 18/37 operations (48.6%)
Coverage report date 2026-05-13

Coverage is generated from .agents/docs/API_COVERAGE.md by update_readme.py. The winterbaume row counts only operations with real, state-backed logic; stubs counts handlers that route the request and return an empty/default response without real behaviour. Operation-count coverage is a prioritisation signal, not a behavioural guarantee.

See the workspace README.md for setup, usage, and the full cross-service coverage table.

Server-mode usage

Start winterbaume-server and point the AWS CLI at it:

cargo run -p winterbaume-server -- --host 127.0.0.1 --port 5555

export AWS_ENDPOINT_URL=http://localhost:5555
aws stepfunctions list-state-machines

Example

use aws_sdk_sfn::config::BehaviorVersion;
use winterbaume_core::MockAws;
use winterbaume_sfn::SfnService;

#[tokio::main]
async fn main() {
    let mock = MockAws::builder().with_service(SfnService::new()).build();

    let config = aws_config::defaults(BehaviorVersion::latest())
        .http_client(mock.http_client())
        .credentials_provider(mock.credentials_provider())
        .region(aws_sdk_sfn::config::Region::new("us-east-1"))
        .load()
        .await;

    let client = aws_sdk_sfn::Client::new(&config);

    let resp = client
        .list_state_machines()
        .send()
        .await
        .expect("list_state_machines should succeed");
    println!(
        "Step Functions state machines: {}",
        resp.state_machines().len()
    );
}

Implemented APIs (35)

  • CreateActivity
  • CreateStateMachine
  • CreateStateMachineAlias
  • DeleteActivity
  • DeleteStateMachine
  • DeleteStateMachineAlias
  • DeleteStateMachineVersion
  • DescribeActivity
  • DescribeExecution
  • DescribeMapRun
  • DescribeStateMachine
  • DescribeStateMachineAlias
  • DescribeStateMachineForExecution
  • GetActivityTask
  • GetExecutionHistory
  • ListActivities
  • ListExecutions
  • ListMapRuns
  • ListStateMachineAliases
  • ListStateMachineVersions
  • ListStateMachines
  • ListTagsForResource
  • PublishStateMachineVersion
  • RedriveExecution
  • SendTaskFailure
  • SendTaskHeartbeat
  • SendTaskSuccess
  • StartExecution
  • StopExecution
  • TagResource
  • UntagResource
  • UpdateMapRun
  • UpdateStateMachine
  • UpdateStateMachineAlias
  • ValidateStateMachineDefinition
  • StartSyncExecution
  • TestState