floci-io/floci
Floci
Floci is a local emulator for AWS services and cloud infrastructure designed for developing and testing applications without a live internet connection. It serves as a containerized cloud emulator and a serverless runtime emulator, allowing users to run high-fidelity replicas of cloud databases, queues, and compute services on a local machine.
The project distinguishes itself by using real container images instead of simple mocks to ensure behavioral accuracy. It functions as a local API gateway simulator with proxy-based routing for REST and WebSocket APIs, and provides a serverless environment featuring dynamic code reloading to iterate on functions without restarting the entire environment.
The emulator covers a wide range of capabilities, including the management of object storage, NoSQL tables, relational databases, and streaming clusters. It supports infrastructure-as-code testing and SDK compatibility verification, alongside identity management, event orchestration, and cryptographic key security.
The system integrates with test containers to manage isolated instances directly from test code, ensuring a clean state for every run.
Features
- AWS Local Development Environments - Simulates AWS cloud services and infrastructure on a local machine to build and test applications without a live internet connection.
- Cloud Service Emulators - Implements a local environment that mimics cloud service behavior using real container images for high fidelity.
- Cloud Service Emulators - Executes high-fidelity emulations of cloud compute and data services using real container images instead of mocks.
- Dynamic Code Reloading - Automatically refreshes emulated cloud function logic to enable rapid iteration without restarts.
- Local Emulation Environments - Provides a local environment for developing and testing applications by emulating AWS services and infrastructure without a live connection.
- Local Function Execution - Runs serverless functions using local runtimes with support for container images and instant code reloading.
- Local Serverless Testing - Executes and reloads serverless functions in a local runtime to iterate on code without deploying to the cloud.
- Infrastructure Orchestration Templates - Deploys relational databases and streaming clusters by managing isolated container groups through integrated templates.
- Serverless Runtimes - Provides a local execution environment for serverless functions featuring dynamic code reloading and container image support.
- Protocol-Compatible Backends - Implements standard cloud provider API protocols to ensure compatibility with official SDKs and CLI tools.
- Local Proxy Gateways - Simulates API endpoints and network traffic via a local gateway with authorizers and custom domain mappings.
- Cloud Protocol Emulation - Implements wire protocols like JSON and REST to process cloud service requests and responses locally.
- Traffic Management Gateways - Simulates REST and WebSocket API traffic using authorizers and proxy integrations to manage local network flow.
- Infrastructure Testing Tools - Utility for verifying infrastructure as code scripts and SDK compatibility against local emulated endpoints.
- Messaging and Queuing - Simulates cloud queuing and notification systems for asynchronous communication.
- Ephemeral Test Instance Management - Starts and stops temporary emulator instances via language modules to ensure a clean state for every test run.
- Multi-Tenant Resource Isolation - Separates resource storage based on access keys to support multiple isolated tenants.
- Bucket Management - Simulates object storage buckets with support for virtual addressing and static website hosting.
- NoSQL Table Emulation - Emulates NoSQL database operations including specialized query languages and point-in-time recovery.
- Client-Emulator Compatibility Verifiers - Verify that cloud software development kits and command line tools interact correctly with the local emulator using real clients.
- Dynamic Logic Reloading - Automatically updates the logic of emulated cloud functions without restarting the local development environment.
- Container Service Execution - Uses real container images for compute and database services to ensure behavioral accuracy.
- Dynamic Runtime Reloading - Allows updating serverless function logic instantly without restarting the entire emulator environment.
- Streaming Cluster Emulation - Orchestrates containerized Kafka brokers to simulate high-throughput message distribution.
- Container Deployment - Orchestrates local container clusters with integrated load balancer registration.
- Automated Testing Containers - Starts isolated emulator instances directly from test code via Testcontainers to ensure a clean state.
- Database Cluster Orchestration - Provisions containerized relational databases and cache clusters to simulate production cloud environments.
- Event Pattern Emulation - Processes event schedules and patterns with capabilities to archive and replay historical data streams.
- IaC Local Validation - Verifies that deployment scripts and cloud software development kits work correctly by targeting a local emulator instead of live resources.
- Infrastructure Provisioning Templates - Deploys local resources using formatted infrastructure templates with support for transforms and cross-stack references.
- Virtual Network Emulation - Emulates cloud networks, subnets, and instances using containers with secure shell access.
- Cloud Key Emulators - Simulates key management operations including on-demand rotation and hash-based message authentication codes.
- User Identity Management - Emulates user and identity pools, including custom authentication flows and trigger functions for member access.
- State Machine Orchestrators - Runs state machine definitions using JSONata and nested executions to manage complex business logic flows.
- Account-Based Resource Isolation - Separates resources by account ID to ensure that different tests or users do not interfere.
- Test Isolation - Starts temporary emulator instances within test code to ensure a clean state and prevent network port conflicts.
- SDK Compatibility Testing - Verify that standard cloud software development kits interact correctly with the local emulator without requiring code changes.
