Skip to content

feat: Add support for MiniStack - #1760

Open
mwilde wants to merge 4 commits into
testcontainers:mainfrom
mwilde:feature/add_ministack
Open

feat: Add support for MiniStack#1760
mwilde wants to merge 4 commits into
testcontainers:mainfrom
mwilde:feature/add_ministack

Conversation

@mwilde

@mwilde mwilde commented Sep 6, 2026

Copy link
Copy Markdown

What does this PR do?

Adds a new \Testcontainers.MiniStack\ module — a Testcontainers integration for MiniStack, a free open-source AWS emulator.

The module follows the same structure as the existing \Testcontainers.LocalStack\ module and includes:

  • \MiniStackBuilder\ — fluent builder with port binding, health check on /_ministack/health, and image default \ministackorg/ministack:latest\
  • \MiniStackConfiguration\ — immutable container configuration
  • \MiniStackContainer\ — container with:
    • \GetConnectionString()\ — returns the \http://host:port\ endpoint
    • \ResetAsync(bool runInitScripts, CancellationToken)\ — wipes all service state via /_ministack/reset; optionally re-runs init scripts with ?init=1\
    • \GetSesMessagesAsync(CancellationToken)\ — inspects SES emails without consuming them
    • \GetSqsMessagesAsync(CancellationToken)\ — inspects SQS messages without consuming them
  • Full test coverage: CloudWatch, DynamoDB, S3, SNS, SQS, reset, SES inspection, SQS inspection

Why is it important?

LocalStack moved its core services behind a paid plan. MiniStack is a MIT-licensed, drop-in compatible alternative that emulates 60+ AWS services on port 4566 with no account, API key, or sign-up required. Having first-class Testcontainers support makes it easy for teams to adopt MiniStack in their .NET test suites.

Related issues

@mwilde
mwilde requested a review from HofmeisterAn as a code owner September 6, 2026 21:06
@coderabbitai

coderabbitai Bot commented Sep 6, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Team

Run ID: 1e0925bb-e884-43b0-88d3-f8a202c374f9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@mwilde
mwilde force-pushed the feature/add_ministack branch from c1b3c0f to c40faf8 Compare September 6, 2026 21:10
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mwilde
mwilde requested a review from a team as a code owner September 6, 2026 21:13
Moritz Wilde and others added 2 commits September 6, 2026 23:14
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mwilde mwilde changed the title feat: Add MiniStack module feat: Add support for MiniStack Sep 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant