fakecloud-sdk

Rust client SDK for fakecloud, a local AWS cloud emulator.

The crate wraps fakecloud's introspection and simulation API (/_fakecloud/*) so Rust tests can inspect emulator state, reset services, and trigger time-based processors without going through raw HTTP calls.

Installation

cargo add fakecloud-sdk

Quick Start

use fakecloud_sdk::FakeCloud;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let fc = FakeCloud::new("http://localhost:4566");

    let health = fc.health().await?;
    println!("{}", health.version);

    fc.reset().await?;

    let emails = fc.ses().get_emails().await?;
    println!("sent {} emails", emails.emails.len());

    Ok(())
}

What It Covers

• health and reset endpoints
• SES email inspection and inbound simulation
• SNS and SQS message inspection
• EventBridge history and manual rule firing
• S3 notifications and lifecycle ticks
• DynamoDB TTL and Secrets Manager rotation ticks
• Lambda invocation and warm-container inspection
• Cognito confirmation codes, token inspection, and auth event access
• RDS instance inspection with runtime metadata
• ElastiCache cluster, replication group, and serverless cache inspection
• Step Functions execution history
• API Gateway v2 HTTP API request history

Repository

• Project: https://github.com/faiscadev/fakecloud
• Website: https://fakecloud.dev