Fluent shard registration & per-shard resource factories for Shardis using Microsoft.Extensions.DependencyInjection.
Get Started
$ dotnet add package Shardis.DependencyInjectionReadme
Shardis.DependencyInjection
Lightweight fluent registration helpers for per-shard resource factories (e.g. DbContext, IDocumentSession, Redis connections) integrated with Microsoft.Extensions.DependencyInjection.
Install
dotnet add package Shardis.DependencyInjection --version 0.1.*
When to use
- You need to provision one resource instance per logical shard (EF Core DbContext, Marten session, etc.)
- You want strongly-typed
IShardFactory<T>resolution via DI - You prefer fluent bulk shard registration rather than manual loops
- You want deterministic shard id enumeration at runtime
What’s included
IShardFactory<T>resolution (implemented byDependencyInjectionShardFactory<T>)AddShard/AddShards(sync + async variants) fluent registration methodsAddShardInstancefor supplying a pre-created singleton-per-shard instanceGetRegisteredShards<T>()enumeration helperUseAsynchelpers for safe create/use/dispose ofIAsyncDisposableshard resources
Quick start
var services = new ServiceCollection();
// Register 4 shards with synchronous factory
services.AddShards<MyDbContext>(4, shard => new MyDbContext(BuildOptionsFor(shard)));
// Or async creation per shard
services.AddShard<MyDbContext>(new ShardId("primary"), async (sp, shard) =>
{
await Task.Yield();
return new MyDbContext(BuildOptionsFor(shard));
});
var provider = services.BuildServiceProvider();
var factory = provider.GetRequiredService<IShardFactory<MyDbContext>>();
await using var ctx = await factory.CreateAsync(new ShardId("2"));