Foundatio

🚀

Caching

Fast, consistent caching with InMemory, Redis, and Hybrid implementations. Includes scoped cache support.

📬

Queues

FIFO message delivery with InMemory, Redis, Azure Service Bus, Azure Storage, and AWS SQS implementations.

🔒

Locks

Distributed locking with cache-based and throttling implementations for cross-machine coordination.

📡

Messaging

Pub/sub messaging with InMemory, Redis, RabbitMQ, Kafka, and Azure Service Bus implementations.

💼

Jobs

Long-running process management with queue processor jobs and work item handlers.

📁

File Storage

Abstracted file storage with InMemory, Folder, Azure Blob, S3, Redis, Minio, and more.

🛡️

Resilience

Retry policies, circuit breakers, timeouts, and exponential backoff for robust applications.

💉

Dependency Injection

Built-in support for Microsoft.Extensions.DependencyInjection with easy service registration.

🔄

Swappable Implementations

Abstract interfaces allow easy swapping between in-memory (dev) and production implementations.

🧪

Testability

In-memory implementations make testing easy without external dependencies.

🔧

Extensibility

Modular design allows adding custom implementations for any abstraction.

📊

Metrics & Logging

Optional metrics and logging integration for observability.

Quick Example

Caching

csharp

using Foundatio.Caching;

ICacheClient cache = new InMemoryCacheClient();
await cache.SetAsync("test", 1);
var value = await cache.GetAsync<int>("test");

Queues

csharp

using Foundatio.Queues;

IQueue<SimpleWorkItem> queue = new InMemoryQueue<SimpleWorkItem>();

await queue.EnqueueAsync(new SimpleWorkItem { Data = "Hello" });
var workItem = await queue.DequeueAsync();

Locks

csharp

using Foundatio.Lock;

ILockProvider locker = new CacheLockProvider(
    new InMemoryCacheClient(),
    new InMemoryMessageBus()
);
var testLock = await locker.AcquireAsync("test");
// ... do work
await testLock.ReleaseAsync();

Messaging

csharp

using Foundatio.Messaging;

IMessageBus messageBus = new InMemoryMessageBus();
await messageBus.SubscribeAsync<SimpleMessage>(msg => {
  // Got message
});

await messageBus.PublishAsync(new SimpleMessage { Data = "Hello" });

File Storage

csharp

using Foundatio.Storage;

IFileStorage storage = new InMemoryFileStorage();
await storage.SaveFileAsync("test.txt", "test");
string content = await storage.GetFileContentsAsync("test.txt");

Why Foundatio?

When building several large cloud applications we found a lack of great solutions for many key pieces to building scalable distributed applications while keeping the development experience simple. Here's why we built and use Foundatio:

Abstract Interfaces: Build against abstract interfaces so you can easily change implementations

DI Friendly: All blocks are dependency injection friendly

Local Development: In-memory implementations mean no external dependencies during development

Swappable: Easily swap between in-memory (development) and production implementations (Redis, Azure, AWS)

Battle Tested: Used in production at Exceptionless and other large-scale applications