How aswina1636/floci works
Floci is a local AWS emulator: users point AWS SDKs, the CLI, or infrastructure-as-code tools at its endpoint and receive AWS-compatible service behavior. The repository implements a broad set of AWS service domains, shared protocol and request infrastructure, configurable local state, lifecycle controls, and Docker-backed execution for services that need it. The README also documents a lazily started browser console sidecar. Source excerpts are limited, so service-to-storage and request-dispatch links are omitted where the evidence does not establish them.
Main entry points: common AWS protocols · floci Local endpoint · docker Docker runtime · UiController.java Console controller
Components 23
Shared runtime
- Local endpoint
src/main/java/io/github/hectorvent/floci - AWS protocols
src/main/java/io/github/hectorvent/floci/core/common - Request context
src/main/java/io/github/hectorvent/floci/core/common/RegionResolver.java - Emulator config
src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java - Local state
src/main/java/io/github/hectorvent/floci/core/storage - Lifecycle and health
src/main/java/io/github/hectorvent/floci/lifecycle - IAM and STS
src/main/java/io/github/hectorvent/floci/services/iam
Compute and network
- EC2 networking
src/main/java/io/github/hectorvent/floci/services/ec2 - Lambda execution
src/main/java/io/github/hectorvent/floci/services/lambda - ECS containers
src/main/java/io/github/hectorvent/floci/services/ecs - Docker runtime
src/main/java/io/github/hectorvent/floci/core/common/docker
Data services
- RDS databases
src/main/java/io/github/hectorvent/floci/services/rds - DocumentDB
src/main/java/io/github/hectorvent/floci/services/docdb - DynamoDB
src/main/java/io/github/hectorvent/floci/services/dynamodb - S3 storage
src/main/java/io/github/hectorvent/floci/services/s3
Integration services
- SQS messaging
src/main/java/io/github/hectorvent/floci/services/sqs - SNS messaging
src/main/java/io/github/hectorvent/floci/services/sns - API Gateway
src/main/java/io/github/hectorvent/floci/services/apigateway - Other AWS services
src/main/java/io/github/hectorvent/floci/services
Console
- Console controller
src/main/java/io/github/hectorvent/floci/lifecycle/UiController.java - Console sidecar
Other components
- AWS clients
- Browser user
Connections 23
- AWS clients → Local endpoint: send AWS requests
README.md - Local endpoint → AWS protocols: serve AWS APIs
src/main/java/io/github/hectorvent/floci/services/codepipeline/CodePipelineService.java - AWS protocols → EC2 networking: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → RDS databases: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → DocumentDB: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → DynamoDB: dispatches requests
- AWS protocols → S3 storage: dispatches requests
- AWS protocols → SQS messaging: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → SNS messaging: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → Lambda execution: dispatches requests
- AWS protocols → ECS containers: dispatches requests
- AWS protocols → API Gateway: dispatches requests
- AWS protocols → IAM and STS: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - AWS protocols → Other AWS services: dispatches requests
src/main/java/io/github/hectorvent/floci/core/common/AwsQueryController.java - Emulator config → Local endpoint: configures runtime
src/main/java/io/github/hectorvent/floci/services/codepipeline/CodePipelineService.java - Browser user → Console controller: opens console
README.md - Console controller → Console sidecar: starts sidecar
README.md - Console sidecar → Local endpoint: connects to Floci
README.md - Console controller → Docker runtime: starts container
README.md - Lifecycle and health → Local endpoint: reports health
- Lambda execution → Docker runtime: runs in containers
README.md - RDS databases → Docker runtime: runs in containers
README.md - ECS containers → Docker runtime: runs in containers
README.md