BoltDI.Generators 0.1.0

BoltDI

Lightning-fast, source-generated dependency injection for .NET. BoltDI generates strongly-typed containers at compile time—no reflection, no runtime registration.

Features

• Compile-time container generation driven by attributes.
• Deterministic lifetimes (Transient / Scoped / Singleton) with automatic disposal.
• Roslyn diagnostics that catch graph issues before you press F5.
• Drop-in ASP.NET Core integration via BoltServiceProviderFactory<TContainer>.
• Samples and benchmarks that compare BoltDI to Microsoft.Extensions.DependencyInjection.

Quick Start

Install the packages:

dotnet add package BoltDI
dotnet add package BoltDI.Abstractions
dotnet add package BoltDI.Generators

Declare a container:

using BoltDI;

[DiContainer]
[Singleton(typeof(IGreeter), typeof(Greeter))]
[Scoped(typeof(IClock), typeof(UtcClock))]
internal partial class AppContainer : BoltContainerBase
{
}

internal interface IGreeter
{
    string SayHello();
}

internal sealed class Greeter(IClock clock) : IGreeter
{
    public string SayHello() => $"Hello from {clock.Now:O}";
}

internal interface IClock
{
    DateTime Now { get; }
}

internal sealed class UtcClock : IClock
{
    public DateTime Now => DateTime.UtcNow;
}

Resolve services:

var container = new AppContainer();
var greeter = container.GetRequiredService<IGreeter>();
Console.WriteLine(greeter.SayHello());

using var scope = container.CreateScope();
var clock = scope.ServiceProvider.GetRequiredService<IClock>();
Console.WriteLine(clock.Now);

See Getting Started for a deeper walkthrough.

ASP.NET Core integration

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseBoltDI<AppContainer>();

var app = builder.Build();
app.UseBoltDI();

app.MapGet("/", ([FromServices] IGreeter greeter) => Results.Text(greeter.SayHello()));

app.Run();

The factory replaces the default service provider, honours request scopes, and surfaces BoltDI diagnostics during build. Review samples/02-AspNetCore for a complete example.

Documentation

• Getting Started
• Lifetimes
• Diagnostics catalogue
• NativeAOT guide
• Roadmap
• Release notes
• RFCs (design history and decisions)

Diagnostics

BoltDI validates your container graph at compile time. Browse the diagnostics table for examples and remediation steps.

Samples & Benchmarks

• samples/01-Console – minimal console program using BoltDI-generated scopes.
• samples/02-AspNetCore – ASP.NET Core host using BoltDI for dependency resolution.
• benchmarks/BoltDI.Benchmarks – BenchmarkDotNet scenarios comparing BoltDI with Microsoft.Extensions.DependencyInjection (dotnet run -c Release).

Target frameworks

• BoltDI.Abstractions: netstandard2.0.
• BoltDI: netstandard2.0, net8.0.
• BoltDI.Generators: netstandard2.0 analyzer (works in modern IDEs and SDKs).
• BoltDI.AspNetCore: net8.0, net9.0.

Roadmap

Upcoming features such as collection injection, factory helpers, and analyzers are tracked in the roadmap. Feedback is welcome—file an issue or start a discussion.

License

BoltDI is distributed under the MIT License.