S3 coverage
Every S3 operation the emulator advertises, and what Emuplane does with it. The rule is simple and it is enforced on every test run: an operation with no test fails the build, and an operation the console cannot reach is marked as such rather than quietly omitted.
Two columns matter:
- Shown in the console — a page performs or displays it. An em dash means the operation works over the wire and nowhere in the UI.
- Emuplane test — the test that exercises it, in this version.
The table is generated in the implementation repository and copied here, so what you read is what the ledger says. Work that is planned rather than done is tracked on this repository's project board.
Nine operations the console drives are not rows here, because the emulator's
advertised S3 row omits them although the emulator answers them:
ListMultipartUploads (GET ?uploads), ListParts (GET ?uploadId),
GetObjectAcl and PutObjectAcl (?acl on an object), Get, Put and
DeleteBucketWebsite (?website), and Get and PutBucketOwnershipControls
(?ownershipControls). The console drives all nine — the incomplete-uploads card,
the object ACL dialog, the static-website document and the Object Ownership
switch — and tests/control/test_api.py pins each against the emulator, so an
upstream README that catches up turns them into ordinary rows.
npm run coverage # regenerates every service's coverage page
- Operations upstream advertises: 84
- Console actions (
/api/exec, the create page): 5 - Operations with an emuplane test: 84
- Operations shown in the console: 83
- Operations that are not console actions: 1
- GET operations (Get/List/Head/Describe) shown in the console: 35 of 35
- Operations with no emuplane test: 0
Buckets and objects
| Operation | Console action | Shown in the console | Emuplane test |
|---|---|---|---|
CreateBucket | create-bucket | Buckets page › Create bucket | tests/s3/test_create.py, tests/control/test_gateway.py, tests/control/test_parity.py |
DeleteBucket | delete-bucket | Buckets page › Delete | tests/control/test_gateway.py, tests/control/test_parity.py |
ListBuckets | Buckets page | Buckets page › table | tests/control/test_api.py (via /api/browse), tests/control/test_parity.py |
HeadBucket | Bucket page (region check) | Bucket page (HeadBucket decides the region) | tests/control/test_gateway.py (301 path), tests/s3/test_objects.py, tests/control/test_api.py |
PutObject | put-object | Bucket page › Objects › Upload | tests/control/test_api.py, tests/s3/test_objects.py, tests/control/test_parity.py, tests/control/test_object_upload.py |
GetObject | Bucket page (Objects) | Bucket page › Objects › open | tests/s3/test_objects.py, tests/control/test_parity.py, tests/control/test_object_upload.py |
DeleteObject | delete-object | Bucket page › Objects › open › Delete | tests/web/s3.test.jsx (object view), tests/s3/test_catalogue.py, tests/control/test_parity.py |
HeadObject | Bucket page (Objects) | Bucket page › Objects › open (size, ETag, last modified) | tests/control/test_gateway.py (301 path), tests/s3/test_objects.py (HEAD first), tests/control/test_api.py |
CopyObject | Bucket page (Objects) | Bucket page › Objects › Actions › Copy / Edit storage class / Edit encryption | tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
ListObjects v1/v2 | list-objects | Bucket page › Objects | tests/control/test_api.py (v2), tests/control/test_parity.py, tests/s3/test_objects.py (v1) |
DeleteObjects | delete-object | Buckets page › Empty | tests/s3/test_objects.py (Empty) |
Bucket configuration
| Operation | Console action | Shown in the console | Emuplane test |
|---|---|---|---|
GetBucketVersioning | Bucket page (Properties) | Bucket page › Properties | tests/s3/test_create.py |
PutBucketVersioning | Bucket page (Properties, Edit) | Bucket page › Properties › Edit | tests/s3/test_create.py, tests/control/test_api.py, tests/web/s3.test.jsx |
GetBucketEncryption | Bucket page (Properties) | Bucket page › Properties | tests/s3/test_create.py, tests/control/test_api.py |
PutBucketEncryption | Bucket page (Properties, Edit) | Bucket page › Properties › Edit | tests/s3/test_create.py, tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
DeleteBucketEncryption | — | Bucket page › Properties › Remove default encryption | tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
GetBucketLifecycleConfiguration | Bucket page (Configuration documents) | Bucket page › Configuration documents | tests/s3/test_objects.py (documents) |
PutBucketLifecycleConfiguration | Bucket page (Configuration documents, Edit) | Bucket page › Configuration documents › Edit | tests/s3/test_objects.py (lifecycle round trip), tests/control/test_api.py (cors), tests/web/s3.test.jsx |
DeleteBucketLifecycle | Bucket page (Configuration documents, Remove) | Bucket page › Configuration documents › Remove | tests/s3/test_objects.py (lifecycle round trip) |
GetBucketCors | Bucket page (Configuration documents) | Bucket page › Configuration documents | tests/s3/test_objects.py (documents) |
PutBucketCors | Bucket page (Configuration documents, Edit) | Bucket page › Configuration documents › Edit | tests/s3/test_objects.py (cors round trip), tests/control/test_api.py, tests/web/s3.test.jsx |
DeleteBucketCors | Bucket page (Configuration documents, Remove) | Bucket page › Configuration documents › Remove | tests/s3/test_objects.py (cors round trip), tests/control/test_api.py |
GetBucketAcl | Bucket page (Configuration documents) | Bucket page › Configuration documents | tests/s3/test_objects.py (documents), tests/control/test_api.py |
PutBucketAcl | Bucket page (Configuration documents, Edit) | Bucket page › Configuration documents › Edit (ACL-enabled buckets) | tests/s3/test_objects.py (ACL enabled/disabled), tests/web/s3.test.jsx |
GetBucketTagging | Bucket page (Properties) | Bucket page › Properties | tests/s3/test_create.py, tests/control/test_api.py |
PutBucketTagging | Bucket page (Properties, Edit), Create page (tags) | Create bucket page › Tags, Bucket page › Properties › Tags › Edit | tests/s3/test_create.py, tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
DeleteBucketTagging | Bucket page (Properties, Remove tags) | Bucket page › Properties › Tags › Remove tags | tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
GetBucketPolicy | Bucket page (Configuration documents) | Bucket page › Configuration documents | tests/s3/test_objects.py (documents), tests/control/test_api.py, tests/control/test_bucket_policies.py (two-account matrix) |
PutBucketPolicy | Bucket page (Configuration documents, Edit) | Bucket page › Configuration documents › Edit | tests/s3/test_objects.py (policy round trip), tests/control/test_api.py, tests/web/s3.test.jsx, tests/control/test_bucket_policies.py (two-account matrix) |
DeleteBucketPolicy | Bucket page (Configuration documents, Remove) | Bucket page › Configuration documents › Remove | tests/s3/test_objects.py (policy round trip), tests/control/test_api.py, tests/control/test_bucket_policies.py (two-account matrix) |
GetBucketNotificationConfiguration | Bucket page (Properties) | Bucket page › Properties › Event notifications | tests/s3/test_objects.py (documents) |
PutBucketNotificationConfiguration | Bucket page (Properties, Edit) | Bucket page › Properties › Event notifications › Edit | tests/s3/test_operations.py (EventBridge rule) |
GetBucketLogging | Bucket page (Properties) | Bucket page › Properties › Server access logging | tests/s3/test_objects.py (documents) |
PutBucketLogging | Bucket page (Properties, Edit) | Bucket page › Properties › Server access logging › Edit | tests/s3/test_operations.py (logging written and read) |
PutPublicAccessBlock | Bucket page (Permissions, Save) | Bucket page › Permissions › Save | tests/s3/test_create.py |
GetPublicAccessBlock | Bucket page (Permissions) | Bucket page › Permissions | tests/s3/test_create.py |
DeletePublicAccessBlock | Bucket page (Permissions, Remove) | Bucket page › Permissions › Remove configuration | tests/s3/test_operations.py (access block removed) |
Objects in depth
| Operation | Console action | Shown in the console | Emuplane test |
|---|---|---|---|
ListObjectVersions | Bucket page (Properties) | Bucket page › Properties › Versions | tests/s3/test_objects.py, tests/control/test_api.py, tests/web/s3.test.jsx |
CreateMultipartUpload | — | Bucket page › Objects › Upload (files above 8 MiB, part 1 of N) | tests/s3/test_operations.py (multipart), tests/control/test_api.py (incomplete-upload listing), tests/web/s3.test.jsx (files above 8 MiB) |
UploadPart | — | Bucket page › Objects › Upload (each part) | tests/s3/test_operations.py (multipart) |
CompleteMultipartUpload | — | Bucket page › Objects › Upload (when the last part lands) | tests/s3/test_operations.py (multipart) |
AbortMultipartUpload |