Rig.TUnit.Storage.MinIO 0.1.0-beta.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Rig.TUnit.Storage.MinIO. 
dotnet add package Rig.TUnit.Storage.MinIO --version 0.1.0-beta.2
                    


                    

                
NuGet\Install-Package Rig.TUnit.Storage.MinIO -Version 0.1.0-beta.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Rig.TUnit.Storage.MinIO" Version="0.1.0-beta.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Rig.TUnit.Storage.MinIO" Version="0.1.0-beta.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Rig.TUnit.Storage.MinIO" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Rig.TUnit.Storage.MinIO --version 0.1.0-beta.2
                    


                    

                
#r "nuget: Rig.TUnit.Storage.MinIO, 0.1.0-beta.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Rig.TUnit.Storage.MinIO@0.1.0-beta.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Rig.TUnit.Storage.MinIO&version=0.1.0-beta.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Rig.TUnit.Storage.MinIO&version=0.1.0-beta.2&prerelease
                    


                            Install as a Cake Tool

Rig.TUnit.Storage.MinIO

Testcontainers-backed MinIO fixture (minio/minio) with IMinioClient and pure-function MinIOSasBuilder for presigned-URL construction.

What this package is

The Rig.TUnit MinIO provider. MinIOFixture spins the minio/minio container via Testcontainers and exposes a ready IMinioClient. MinIOSasBuilder is a pure function that builds presign-request parameters (bucket + object + verb + TTL) — unit-testable without hitting the server.

MinIO is wire-compatible with S3, so this is also the fast path for testing S3 behaviour without LocalStack overhead.

When to use it

  • Integration tests for object storage with S3-compatible semantics.
  • Presigned-URL construction + download/upload verification.
  • Not for: S3 features not implemented by MinIO (S3 Select, Glacier tiers, Intelligent Tiering).

Prerequisites

  • .NET 10 SDK
  • Docker Desktop / Colima (MinIO image ~150 MB)
  • Minio SDK 6.x (transitive, Apache-2.0).

Quick start

using Minio.DataModel.Args;
using Rig.TUnit.Storage.MinIO.Fixtures;

await using var fx = new MinIOFixture();
await fx.InitializeAsync();

await fx.Client.MakeBucketAsync(new MakeBucketArgs().WithBucket("demo"));

Options

Property Type Default Description
Image string "minio/minio:latest" MinIO image
StartupTimeoutSeconds int 60 MinIO boot
RootUser string "rigtunit" Default admin user
RootPassword string "rigtunit-minio" Default admin password (8+ chars required)

Fixture + helper APIs

  • Rig.TUnit.Storage.MinIO.Fixtures.MinIOFixture
  • Rig.TUnit.Storage.MinIO.Options.MinIOFixtureOptions
  • Rig.TUnit.Storage.MinIO.Builder.MinIORigBuilder
  • Rig.TUnit.Storage.MinIO.Helpers.MinIOSasBuilder

Per-test isolation

Per-test bucket: test-{IsolationKey:short}. Teardown removes the bucket recursively (RemoveBucketAsync requires the bucket be empty — the fixture clears it first).

Parallelism + performance

  • First-run pull: ~20 s.
  • Warm startup: ~3 s.
  • Per-test bucket create + delete: ~60 ms.
  • Parallelism: 8+ concurrent tests.

Troubleshooting

  • AccessDenied on presign — clock skew between the fixture and signature builder; MinIO enforces ±15 min. Ensure both use UTC.
  • BucketNotEmpty on teardown — test wrote an object after the fixture's cleanup pass. Ensure using / await using scopes are tight.

See docs/troubleshooting.md#minio.

Provider quirks + edge cases

  • MinIO is S3-wire-compatible but not byte-identical — S3-specific error codes can differ, and some advanced features (S3 Select, Intelligent Tiering) are absent. Use LocalStack for those.
  • Default region is us-east-1; presigned URLs without explicit region use that.
  • Root password must be at least 8 characters (MinIO enforced).

Benchmarks

See MinIOBenchmarks.cs; baseline in benchmarks/baseline-005.json.

License

MIT. See LICENSE.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Rig.TUnit.Storage.MinIO:

Package Downloads
Rig.TUnit.All

Meta-package containing every Rig.TUnit.* package. DISCOURAGED — prefer per-feature or per-stack meta-packages (Rig.TUnit, Rig.TUnit.Microservices).

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-beta.2 50 4/27/2026
0.0.0-alpha.0.14 46 4/26/2026