How floci-io/floci works
Floci is a local AWS emulator: users direct standard AWS clients to its local endpoint, issue AWS-shaped requests, and receive compatible responses. The repository includes protocol and service implementations, persistent storage, lifecycle management, configuration, and a Docker-backed web-console sidecar. The README documents the client and console workflows; sampled source and the SOURCE INDEX support selected service-to-core relationships. Many service implementations and runtime routes were not sampled, so those internal links are omitted.
Main entry points: Ec2QueryHandler.java EC2 API · common Local Endpoint · RdsQueryHandler.java RDS API · AutoScalingQueryHandler.java Auto Scaling API
Components 24
Request Runtime
- Local Endpoint
src/main/java/io/floci/aws/core/common - Region Resolver
src/main/java/io/floci/aws/core/common/RegionResolver.java - ARN Utilities
src/main/java/io/floci/aws/core/common/AwsArnUtils.java - Query Responses
src/main/java/io/floci/aws/core/common/AwsQueryResponse.java - XML Builder
src/main/java/io/floci/aws/core/common/XmlBuilder.java - AWS Errors
src/main/java/io/floci/aws/core/common/AwsException.java - Pagination
src/main/java/io/floci/aws/core/common/Pagination.java - AWS Namespaces
src/main/java/io/floci/aws/core/common/AwsNamespaces.java
AWS Services
- EC2 API
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 Service
src/main/java/io/floci/aws/services/ec2/Ec2Service.java - RDS API
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - RDS Service
src/main/java/io/floci/aws/services/rds/RdsService.java - IAM API
src/main/java/io/floci/aws/services/iam/IamQueryHandler.java - Auto Scaling API
src/main/java/io/floci/aws/services/autoscaling/AutoScalingQueryHandler.java - CodePipeline
src/main/java/io/floci/aws/services/codepipeline/CodePipelineService.java
State and Storage
- Storage Factory
src/main/java/io/floci/aws/core/storage/StorageFactory.java - Storage Backend
src/main/java/io/floci/aws/core/storage/StorageBackend.java - Account Storage
src/main/java/io/floci/aws/core/storage/AccountAwareStorageBackend.java
Lifecycle and Integrations
- Emulator Lifecycle
src/main/java/io/floci/aws/lifecycle/EmulatorLifecycle.java - Console Controller
src/main/java/io/floci/aws/lifecycle/UiController.java - Console Sidecar
- Docker Runtime
src/main/java/io/floci/aws/core/common/docker - Emulator Config
src/main/java/io/floci/aws/config/EmulatorConfig.java
Other components
- AWS Client
Connections 29
- AWS Client → Local Endpoint: sends requests
- EC2 API → EC2 Service: calls
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - RDS API → RDS Service: calls
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - EC2 API → Region Resolver: uses
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 API → ARN Utilities: uses
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 API → AWS Errors: uses
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 API → XML Builder: builds XML
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 API → AWS Namespaces: uses
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - EC2 API → Pagination: uses
src/main/java/io/floci/aws/services/ec2/Ec2QueryHandler.java - RDS API → AWS Errors: uses
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - RDS API → XML Builder: builds XML
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - RDS API → AWS Namespaces: uses
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - RDS API → Pagination: uses
src/main/java/io/floci/aws/services/rds/RdsQueryHandler.java - IAM API → Region Resolver: uses
src/main/java/io/floci/aws/services/iam/IamQueryHandler.java - IAM API → Pagination: uses
src/main/java/io/floci/aws/services/iam/IamQueryHandler.java - Auto Scaling API → AWS Errors: uses
src/main/java/io/floci/aws/services/autoscaling/AutoScalingQueryHandler.java - Auto Scaling API → XML Builder: builds XML
src/main/java/io/floci/aws/services/autoscaling/AutoScalingQueryHandler.java - Auto Scaling API → Pagination: uses
src/main/java/io/floci/aws/services/autoscaling/AutoScalingQueryHandler.java - CodePipeline → Storage Backend: uses
src/main/java/io/floci/aws/services/codepipeline/CodePipelineService.java - CodePipeline → Account Storage: uses
src/main/java/io/floci/aws/services/codepipeline/CodePipelineService.java - Storage Factory → Storage Backend: creates
src/main/java/io/floci/aws/core/storage/StorageFactory.java - Local Endpoint → EC2 API: routes to
src/main/java/io/floci/aws/core/common/AwsQueryController.java - Local Endpoint → RDS API: routes to
src/main/java/io/floci/aws/core/common/AwsQueryController.java - Local Endpoint → IAM API: routes to
src/main/java/io/floci/aws/core/common/AwsQueryController.java - Local Endpoint → Auto Scaling API: routes to
src/main/java/io/floci/aws/core/common/AwsQueryController.java - Local Endpoint → Console Controller: serves console
- Console Controller → Console Sidecar: starts and checks
- Console Controller → Docker Runtime: uses Docker
- Emulator Lifecycle → Emulator Config: uses configuration