How johannesboyne/gofakes3 works
GoFakeS3 is a local S3-compatible fake server and integration-testing library. The principal workflow is an S3 client sending HTTP requests to the server, which routes S3 operations to a selected storage backend and returns S3-style responses. The repository also provides multipart-upload handling, versioned in-memory storage, and filesystem- and Bolt-backed storage options. The README documents the server setup and backend selection; routing and storage relationships are shown only where the excerpts support them, so some backend-dispatch links remain unverified.
Main entry points: backend.go Backend Contract · io.go I/O Helpers · gofakes3.go HTTP Server API · s3mem/backend.go Memory Backend
Components 14
S3 Server
- Server CLI
cmd/gofakes3/main.go - HTTP Server API
gofakes3.go - Request Router
routing.go
S3 Operations
- S3 Operations
gofakes3.go - Multipart Uploads
uploader.go
Storage Backends
- Backend Contract
backend.go - Memory Backend
backend/s3mem/backend.go - Bucket Versions
backend/s3mem/bucket.go - Bolt Backend
backend/s3bolt/backend.go - Bolt Schema
backend/s3bolt/schema.go - Multi-Bucket FS
backend/s3afero/multi.go - Single-Bucket FS
backend/s3afero/single.go
Storage Internals
- I/O Helpers
internal/s3io/io.go
Other components
- S3 Client
Connections 16
- S3 Client → HTTP Server API: sends S3 requests
- HTTP Server API → Request Router: routes requests
- Request Router → S3 Operations: dispatches operations
routing.go - S3 Operations → Backend Contract: uses backend
- Server CLI → HTTP Server API: serves handler
- Memory Backend → Backend Contract: implements
- Bolt Backend → Backend Contract: implements
- Multi-Bucket FS → Backend Contract: implements
- Single-Bucket FS → Backend Contract: implements
- Memory Backend → Bucket Versions: uses bucket state
backend/s3mem/backend.go - Bolt Backend → Bolt Schema: stores schema data
backend/s3bolt/backend.go - Multipart Uploads → Backend Contract: uses storage
uploader.go - Multi-Bucket FS → I/O Helpers: uses I/O helper
backend/s3afero/multi.go - Single-Bucket FS → I/O Helpers: uses I/O helper
backend/s3afero/single.go - Bucket Versions → I/O Helpers: uses I/O helper
backend/s3mem/bucket.go - Bolt Schema → I/O Helpers: uses I/O helper
backend/s3bolt/schema.go