How aws/aws-emulator works
AWS Emulator is a local AWS API emulator. A user points an SDK or CLI at the server endpoint, or uses the embedded Rust facade; requests are routed to service-specific emulations, which implement AWS operations and maintain service state before returning emulated responses. The README documents the router’s service-mounting role and the per-service operation/state structure. Specialized service engines and workflows are represented where the source index or excerpts identify them; unsampled service internals and their detailed call paths are not inferred.
Main entry points: src/ops CloudWatch Logs operations · main.rs Server router · lib.rs Embedded facade · src/ops Athena operations
Components 18
Runtime entry points
- Server router
core/router/src/main.rs - Embedded facade
core/embedded/src/lib.rs - Embedded HTTP client
core/embedded/src/lib.rs
Service APIs
- Shared service helpers
services/common/src/lib.rs - Access Analyzer
services/service-com-amazonaws-accessanalyzer-accessanalyzer/src/service.rs - Account APIs
services/service-com-amazonaws-account-account/src/service.rs - Athena operations
services/service-com-amazonaws-athena-amazonathena/src/ops - CloudWatch Logs operations
services/service-com-amazonaws-cloudwatchlogs-logs-20140328/src/ops - Other service emulations
services
Service state and engines
- Athena SQL engine
services/service-com-amazonaws-athena-amazonathena/src/state/query_engine.rs - Logs state
services/service-com-amazonaws-cloudwatchlogs-logs-20140328/src/state.rs - Insights query pipeline
services/service-com-amazonaws-cloudwatchlogs-logs-20140328/src/state/insights/pipeline.rs - Pipeline execution state
services/service-com-amazonaws-codepipeline-codepipeline-20150709/src/state
Workflow services
- CloudFormation provisioner
services/service-com-amazonaws-cloudformation-cloudformation/src/state/provisioner/data_and_storage.rs - Data Pipeline definitions
services/service-com-amazonaws-datapipeline-datapipeline/src/ops/put_pipeline_definition.rs - DataSync locations
services/service-com-amazonaws-datasync-fmrsservice/src/ops/create_location_object_storage.rs - Start pipeline execution
services/service-com-amazonaws-codepipeline-codepipeline-20150709/src/ops/start_pipeline_execution.rs
Other components
- SDK or CLI user
Connections 9
- SDK or CLI user → Server router: sends API requests
- Server router → Other service emulations: routes requests
- SDK or CLI user → Embedded facade: creates instance
- Embedded facade → Embedded HTTP client: provides client
- Embedded HTTP client → SDK or CLI user: returns for SDK use
- Athena operations → Athena SQL engine: runs SQL
services/service-com-amazonaws-athena-amazonathena/src/state/query_engine.rs - CloudWatch Logs operations → Logs state: uses log state
services/service-com-amazonaws-cloudwatchlogs-logs-20140328/src/state.rs - CloudWatch Logs operations → Insights query pipeline: runs Insights queries
services/service-com-amazonaws-cloudwatchlogs-logs-20140328/src/state/insights/pipeline.rs - Start pipeline execution → Pipeline execution state: creates execution
services/service-com-amazonaws-codepipeline-codepipeline-20150709/src/ops/start_pipeline_execution.rs