skills/docs/testkit/testing/testing-integration-garage-s3/README.md

@suaveplan/testing-integration-garage-s3 - Garage S3 v2.0.0 testcontainers fixture for @suaveplan/testing-integration

Summary

Garage S3 v2.0.0 testcontainers fixture for @suaveplan/testing-integration.

Implements ServiceFixture<GarageS3Config> — manages a Garage container lifecycle including the 7-step init sequence (status, layout assign, layout apply, bucket create, key create, bucket allow, key info). Returns a plain S3 config; consumers bring their own @aws-sdk/client-s3.

Documentation tree

• fixture — (no submodules)
  • garage-s3-fixture — (no submodules)

- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — _(no submodules)_

Install

bun add -D @suaveplan/testing-integration-garage-s3

Quick Start

import { GarageS3Fixture } from "@suaveplan/testing-integration-garage-s3";

const fixture = new GarageS3Fixture();
const config = await fixture.start();
// config.endpoint, config.adminEndpoint, config.region, config.bucket
// config.accessKeyId, config.secretAccessKey
await fixture.stop();

Env-bridge passthrough

Set all 4 env vars to skip container startup:

GARAGE_S3_ENDPOINT=http://localhost:3900
GARAGE_S3_ADMIN_ENDPOINT=http://localhost:3902
GARAGE_S3_ACCESS_KEY_ID=your-key-id
GARAGE_S3_SECRET_ACCESS_KEY=your-secret

Docs

• GarageS3Fixture