SquidStd.Vfs.S3
0.28.0
dotnet add package SquidStd.Vfs.S3 --version 0.28.0
NuGet\Install-Package SquidStd.Vfs.S3 -Version 0.28.0
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="SquidStd.Vfs.S3" Version="0.28.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SquidStd.Vfs.S3" Version="0.28.0" />
<PackageReference Include="SquidStd.Vfs.S3" />
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 SquidStd.Vfs.S3 --version 0.28.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: SquidStd.Vfs.S3, 0.28.0"
#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 SquidStd.Vfs.S3@0.28.0
#: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=SquidStd.Vfs.S3&version=0.28.0
#tool nuget:?package=SquidStd.Vfs.S3&version=0.28.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
<h1 align="center">SquidStd.Vfs.S3</h1>
An IVirtualFileSystem over S3-compatible object storage - AWS S3, MinIO, Cloudflare R2, Backblaze B2 - via
the MinIO .NET SDK. Each logical path maps directly to an object key inside a single bucket. The bucket is
created lazily on first use.
Install
dotnet add package SquidStd.Vfs.S3
Usage
using DryIoc;
using SquidStd.Vfs.Abstractions.Interfaces;
using SquidStd.Vfs.S3.Extensions;
container.RegisterS3FileSystem(o =>
{
o.Bucket = "app-data";
o.Aws.ServiceUrl = "https://s3.amazonaws.com"; // or MinIO/R2/B2 endpoint
o.Aws.AccessKey = "...";
o.Aws.SecretKey = "...";
});
var fs = container.Resolve<IVirtualFileSystem>();
await fs.WriteAllBytesAsync("reports/2026.json", payload);
byte[]? data = await fs.ReadAllBytesAsync("reports/2026.json");
await foreach (var entry in fs.ListAsync("reports"))
Console.WriteLine($"{entry.Path} ({entry.Size} bytes)");
For native AWS with the default credential chain, omit AccessKey/SecretKey and set only the region via
o.Aws.Region.
Key types
| Type | Purpose |
|---|---|
RegisterS3FileSystemExtensions |
RegisterS3FileSystem(...) DryIoc registration. |
S3FileSystem |
MinIO-backed IVirtualFileSystem with lazy bucket creation. |
S3FileSystemOptions |
Bucket + Aws (ServiceUrl, AccessKey, SecretKey, Region). |
Related
- Tutorial: Virtual filesystem
SquidStd.Vfs- core backends and decorators
License
MIT - part of SquidStd.
| Product | Versions 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.
-
net10.0
- Minio (>= 7.0.0)
- SquidStd.Aws.Abstractions (>= 0.28.0)
- SquidStd.Core (>= 0.28.0)
- SquidStd.Vfs.Abstractions (>= 0.28.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.28.0 | 0 | 7/8/2026 |
| 0.27.0 | 44 | 7/7/2026 |
| 0.26.0 | 38 | 7/7/2026 |
| 0.25.0 | 52 | 7/6/2026 |
| 0.24.1 | 45 | 7/6/2026 |
| 0.24.0 | 53 | 7/6/2026 |
| 0.23.0 | 53 | 7/4/2026 |
| 0.22.0 | 49 | 7/4/2026 |
| 0.21.0 | 53 | 7/3/2026 |
| 0.20.0 | 45 | 7/3/2026 |
| 0.19.0 | 53 | 7/3/2026 |
| 0.18.0 | 54 | 7/3/2026 |
| 0.17.0 | 53 | 7/3/2026 |
| 0.16.0 | 65 | 7/3/2026 |
| 0.15.0 | 54 | 7/2/2026 |
| 0.14.1 | 53 | 7/2/2026 |
| 0.14.0 | 52 | 7/2/2026 |
| 0.13.0 | 49 | 7/2/2026 |
| 0.12.0 | 49 | 7/2/2026 |
| 0.11.0 | 51 | 7/2/2026 |
Loading failed