Foundatio.AWS 13.0.0-beta3

Prefix Reserved

This is a prerelease version of Foundatio.AWS.

dotnet add package Foundatio.AWS --version 13.0.0-beta3

NuGet\Install-Package Foundatio.AWS -Version 13.0.0-beta3

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="Foundatio.AWS" Version="13.0.0-beta3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Foundatio.AWS" Version="13.0.0-beta3" />
                    

                            Directory.Packages.props

<PackageReference Include="Foundatio.AWS" />
                    

                            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 Foundatio.AWS --version 13.0.0-beta3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Foundatio.AWS, 13.0.0-beta3"

#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 Foundatio.AWS@13.0.0-beta3

#: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=Foundatio.AWS&version=13.0.0-beta3&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Foundatio.AWS&version=13.0.0-beta3&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Foundatio

Pluggable foundation blocks for building loosely coupled distributed apps.

✨ Why Choose Foundatio?

🔌 Pluggable implementations - Swap Redis, Azure, AWS, or in-memory with no code changes
🧪 Developer friendly - In-memory implementations for fast local development and testing
💉 DI native - Built for Microsoft.Extensions.DependencyInjection
🎯 Interface-first - Code against abstractions, not implementations
⚡ Production ready - Battle-tested in high-scale applications
🔄 Consistent APIs - Same patterns across caching, queues, storage, and more

🧱 Core Building Blocks

Feature	Description
Caching	In-memory, Redis, and hybrid caching with automatic invalidation
Queues	Reliable message queuing with Redis, Azure, AWS SQS
Locks	Distributed locking and throttling
Messaging	Pub/sub with Redis, RabbitMQ, Kafka, Azure Service Bus
Jobs	Background job processing with queue integration
File Storage	Unified file API for disk, S3, Azure Blob, and more
Resilience	Retry policies, circuit breakers, and timeouts

🚀 Quick Start

dotnet add package Foundatio.AWS

// Queuing (SQS)
IQueue<WorkItem> queue = new SQSQueue<WorkItem>(o => o
    .ConnectionString("serviceurl=http://localhost:4566"));
await queue.EnqueueAsync(new WorkItem { Data = "Hello" });
var entry = await queue.DequeueAsync();

// Messaging (SQS)
IMessageBus messageBus = new SQSMessageBus(o => o
    .ConnectionString("serviceurl=http://localhost:4566"));
await messageBus.PublishAsync(new MyMessage { Data = "Hello" });

// File Storage (S3)
IFileStorage storage = new S3FileStorage(o => o
    .ConnectionString("serviceurl=http://localhost:4566")
    .Bucket("my-bucket"));
await storage.SaveFileAsync("docs/readme.txt", "Hello World");

📦 Provider Implementations

Provider	Caching	Queues	Messaging	Storage	Locks
In-Memory	✅	✅	✅	✅	✅
Redis	✅	✅	✅	✅	✅
Azure Storage		✅		✅
Azure Service Bus		✅	✅
AWS (S3/SQS/SNS)		✅	✅	✅
RabbitMQ			✅
Kafka			✅
Minio				✅
Aliyun				✅
SFTP				✅

📚 Learn More

👉 Complete Documentation

Core Features

Getting Started - Installation and setup
Caching - In-memory, Redis, and hybrid caching with invalidation
Queues - FIFO message delivery with lock renewal and retry policies
Locks - Distributed locking with null handling patterns
Messaging - Pub/sub with size limits and notification patterns
File Storage - Unified file API across providers
Jobs - Background job processing and hosted service integration

Advanced Topics

Resilience - Retry policies, circuit breakers, and timeouts
Serialization - Serializer configuration and performance
Dependency Injection - DI setup and patterns
Configuration - Options and settings

📦 CI Packages (Feedz)

Want the latest CI build before it hits NuGet? Add the Feedz source and install the pre-release version:

dotnet nuget add source https://f.feedz.io/foundatio/foundatio/nuget -n foundatio-feedz
dotnet add package Foundatio.AWS --prerelease

Or add to your NuGet.config:

<configuration>
  <packageSources>
    <add key="foundatio-feedz" value="https://f.feedz.io/foundatio/foundatio/nuget" />
  </packageSources>
  <packageSourceMapping>
    <packageSource key="foundatio-feedz">
      <package pattern="Foundatio.*" />
    </packageSource>
  </packageSourceMapping>
</configuration>

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See our documentation for development guidelines.

Development Setup:

Clone the repository
Open Foundatio.AWS.slnx in Visual Studio or VS Code
Run dotnet build to build
Run dotnet test to run tests

📄 License

Apache 2.0 License

Thanks to all the people who have contributed

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- AWSSDK.CloudWatch (>= 4.0.7)
- AWSSDK.S3 (>= 4.0.18.6)
- AWSSDK.SimpleNotificationService (>= 4.0.2.16)
- AWSSDK.SQS (>= 4.0.2.14)
- Foundatio (>= 13.0.0-beta3)
net8.0
- AWSSDK.CloudWatch (>= 4.0.7)
- AWSSDK.S3 (>= 4.0.18.6)
- AWSSDK.SimpleNotificationService (>= 4.0.2.16)
- AWSSDK.SQS (>= 4.0.2.14)
- Foundatio (>= 13.0.0-beta3)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Foundatio.AWS:

Package	Downloads
LShared.Frameworks Package Description	23.9K

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Foundatio.AWS:

Repository	Stars
exceptionless/Exceptionless Exceptionless application	2.5K

Version	Downloads	Last Updated
13.0.0-beta3	2,204	2/14/2026
13.0.0-beta1	331	1/12/2026
12.0.1	8,224	1/12/2026
12.0.0	22,442	8/20/2025
11.1.0	15,058	5/9/2025
11.0.8	19,057	1/31/2025
11.0.6	15,453	11/26/2024
11.0.5	11,936	9/28/2024
11.0.2	10,777	8/31/2024
11.0.0	10,173	8/31/2024
10.7.1	28,129	3/27/2024
10.7.0	16,700	1/5/2024
10.6.1	48,281	6/23/2023
10.6.0	46,639	1/4/2023
10.5.0	14,418	5/18/2022
10.4.0	17,248	3/8/2022
10.3.0	11,615	1/20/2022
10.2.2	15,071	9/23/2021
10.2.0	15,373	7/8/2021
10.1.0	10,579	6/17/2021

https://github.com/FoundatioFx/Foundatio.AWS/releases