How harsha7475/floci works
Floci is a local AWS emulator: clients send familiar AWS API requests to its local endpoint, service implementations emulate AWS operations, and state is retained by configurable storage. The README documents both in-process and Docker-backed services, including real container execution for selected compute and database workloads. The graph preserves the main service domains and shared protocol/storage layers. Some routing and service wiring is documented only at a high level; those edges cite the README rather than implying unsampled implementation details.
Main entry points: EmulatorConfig.java AWS HTTP endpoint · storage Configurable storage · S3Service.java S3 · DynamoDbService.java DynamoDB
Components 20
Request handling
- AWS HTTP endpoint
src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java
Shared runtime
- Protocol and context
src/main/java/io/github/hectorvent/floci/core/common - Configurable storage
src/main/java/io/github/hectorvent/floci/core/storage - Lifecycle and hooks
src/main/java/io/github/hectorvent/floci/lifecycle
Application APIs
- S3
src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java - DynamoDB
src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java - Queues and events
src/main/java/io/github/hectorvent/floci/services/sqs/SqsQueryHandler.java - Identity and security
src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java
Infrastructure APIs
- API and GraphQL
src/main/java/io/github/hectorvent/floci/services/apigateway - Cognito and certificates
src/main/java/io/github/hectorvent/floci/services/cognito/CognitoService.java - Network and discovery
src/main/java/io/github/hectorvent/floci/services/route53/Route53Service.java
Compute and data
- Lambda execution
src/main/java/io/github/hectorvent/floci/services/lambda/LambdaService.java - Container workloads
src/main/java/io/github/hectorvent/floci/services/ecs/EcsService.java - Relational databases
src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java - Neptune graph
src/main/java/io/github/hectorvent/floci/services/neptune/NeptuneQueryHandler.java
Operations and analytics
- Analytics and costs
src/main/java/io/github/hectorvent/floci/services/athena/AthenaService.java - Logs and metrics
src/main/java/io/github/hectorvent/floci/services/cloudwatch - Backup and config
src/main/java/io/github/hectorvent/floci/services/backup
Other components
- AWS SDK / CLI
- Docker Engine
Connections 24
- AWS SDK / CLI → AWS HTTP endpoint: sends AWS requests
README.md - AWS HTTP endpoint → Protocol and context: uses shared protocol
src/main/java/io/github/hectorvent/floci/core/common/RegionResolver.java - AWS HTTP endpoint → S3: routes requests
README.md - AWS HTTP endpoint → DynamoDB: routes requests
README.md - AWS HTTP endpoint → Queues and events: routes requests
README.md - AWS HTTP endpoint → Identity and security: routes requests
README.md - AWS HTTP endpoint → API and GraphQL: routes requests
README.md - AWS HTTP endpoint → Cognito and certificates: routes requests
README.md - AWS HTTP endpoint → Network and discovery: routes requests
README.md - AWS HTTP endpoint → Lambda execution: routes requests
README.md - AWS HTTP endpoint → Container workloads: routes requests
README.md - AWS HTTP endpoint → Relational databases: routes requests
README.md - AWS HTTP endpoint → Neptune graph: routes requests
README.md - AWS HTTP endpoint → Analytics and costs: routes requests
README.md - AWS HTTP endpoint → Logs and metrics: routes requests
README.md - AWS HTTP endpoint → Backup and config: routes requests
README.md - S3 → Configurable storage: uses storage
README.md - DynamoDB → Configurable storage: uses storage
README.md - Queues and events → Configurable storage: uses storage
- Identity and security → Configurable storage: uses storage
- Container workloads → Docker Engine: runs workloads
README.md - Lambda execution → Docker Engine: runs workloads
README.md - Relational databases → Docker Engine: runs workloads
README.md - Neptune graph → Docker Engine: runs workloads
README.md