IoCTools.Testing.Abstractions 1.6.0

IoCTools

A Roslyn source generator that lets each service declare its own lifetime, dependencies, and registration intent with small attributes. IoCTools emits constructors, service registrations, and analyzers at build time—no reflection, no runtime scanning.

Highlights

• Self-describing services – [Scoped], [DependsOn<T>], [RegisterAs<…>], and [ConditionalService] live on the class, so intent never leaves the type
• Dependency sets – Implement IDependencySet to reuse dependency bundles across services
• Inheritance-aware – Derived services inherit base class lifetime; diagnostics validate across the full chain
• 100+ diagnostics – Build-time validation catches missing lifetimes, circular dependencies, lifetime mismatches, open-generic edge cases, and FluentValidation anti-patterns
• Zero reflection – Everything happens at compile time; generated code is plain C# you can inspect

Authoring Posture

• [Inject] is deprecated in 1.6.0 and emits IOC095. A Roslyn code fix plus ioc-tools migrate-inject migrate in bulk. Scheduled for removal in 2.0.
• [DependsOn<T>] is the source-of-truth for explicit service dependencies.
• [DependsOnConfiguration<T>] / [DependsOnOptions<T>] for config dependencies. InjectConfiguration stays supported but is not preferred.
• Auto-deps (1.6.0+) declare ambient dependencies once per assembly: [assembly: AutoDep<T>], [assembly: AutoDepOpen(typeof(ILogger<>))], plus Microsoft.Extensions.Logging.ILogger<T> is auto-detected with zero configuration. See docs/auto-deps.md.

Installation

dotnet add package IoCTools.Abstractions
dotnet add package IoCTools.Generator

Or directly in your project file:

<ItemGroup>
  <PackageReference Include="IoCTools.Abstractions" Version="*" />
  <PackageReference Include="IoCTools.Generator" Version="*" PrivateAssets="all" />
</ItemGroup>

What's New in v1.6.0

• Auto-deps — declare ambient deps once at assembly scope; universal, profile-scoped, or transitive across project boundaries. Microsoft.Extensions.Logging.ILogger<T> is auto-detected with zero configuration.
• [Inject] deprecated — emits IOC095 warning in 1.6, error in 1.7, removed in 2.0. A Roslyn code fix (new IoCTools.Generator.Analyzer package) and ioc-tools migrate-inject do the conversion.
• 11 new diagnostics — IOC095-IOC099 and IOC103-IOC108 covering [Inject] deprecation, stale opt-outs, profile validation, glob correctness, and redundant attachments. See diagnostics.md.
• CLI upgrades — graph/why/explain/evidence gain source attribution and --hide-auto-deps / --only-auto-deps filters; doctor adds preflight checks; new profiles (plural) and migrate-inject subcommands.
• Five new MSBuild properties — IoCToolsAutoDepsDisable, IoCToolsAutoDepsExcludeGlob, IoCToolsAutoDepsReport, IoCToolsAutoDetectLogger, IoCToolsInjectDeprecationSeverity.
• First-party migration — IoCTools.Testing, IoCTools.FluentValidation, and the IoCTools.Sample project are all migrated off [Inject]. See docs/migration.md for the 1.5.x → 1.6.x upgrade path.

Getting Started in Three Steps

1. Annotate a partial service

   [DependsOn<ILogger<EmailService>>]
   public partial class EmailService : IEmailService
   {
       public Task SendAsync(string to, string subject, string body) => Task.CompletedTask;
   }
   

   Tip: [Scoped] is implied for partial classes implementing interfaces. Add [Singleton]/[Transient] only when you want to change that default.

   Full getting started guide

2. Build – IoCTools emits Add<YourAssembly>RegisteredServices() into <AssemblyName>.Extensions.Generated.

3. Call the extension during startup

   using YourAssembly.Extensions.Generated;
   
   var builder = WebApplication.CreateBuilder(args);
   builder.Services.AddYourAssemblyRegisteredServices(builder.Configuration);
   

Common Open-Generic Pattern

[Scoped]
[RegisterAsAll]
public partial class Repository<T> : IRepository<T> where T : class
{
}

That common open-generic path is supported. If you ask for InstanceSharing.Shared across open-generic interface aliases, IoCTools emits the secondary IOC095 descriptor and falls back to valid direct registrations because Microsoft.Extensions.DependencyInjection does not support open-generic factory aliases. (In 1.6.0+, the primary IOC095 descriptor is the [Inject] deprecation diagnostic — both ship under the same ID; see diagnostics.md.)

Platform Support

IoCTools works with .NET Framework 4.6.1+, .NET Core 2.0+, and .NET 5+. The generator targets netstandard2.0 internally, but your service code can use any C# features your framework supports. See platform constraints for details.

Testing with IoCTools

The IoCTools.Testing package auto-generates test fixtures, eliminating mock declaration boilerplate.

using IoCTools.Testing.Annotations;

[Cover<UserService>]
public partial class UserServiceTests
{
    [Fact]
    public void Test() {
        var sut = CreateSut(); // Auto-generated
    }
}

Full testing guide

IoCTools CLI

IoCTools.Tools.Cli ships as a dotnet global/local tool (dotnet ioc-tools …). It interrogates your project with the real IoCTools generator.

Installation

dotnet pack IoCTools.Tools.Cli/IoCTools.Tools.Cli.csproj -c Release -o ./artifacts
dotnet tool install --global --add-source ./artifacts IoCTools.Tools.Cli

Commands

Full CLI reference

Before & After: Replacing DI Smells

Legacy (manual, brittle)

public class LegacyBillingService : IBillingService
{
    private readonly ILogger<LegacyBillingService> _logger;
    private readonly IHttpClientFactory _httpClients;
    private readonly BillingOptions _options;
    private readonly IConfiguration _config;

    public LegacyBillingService(
        ILogger<LegacyBillingService> logger,
        IHttpClientFactory httpClients,
        IOptionsMonitor<BillingOptions> options,
        IConfiguration config)
    {
        _logger = logger;
        _httpClients = httpClients;
        _options = options.CurrentValue;
        _config = config;
    }
}

services.AddHttpClient();
services.Configure<BillingOptions>(configuration.GetSection("Billing"));
services.AddScoped<IBillingService, LegacyBillingService>();

Problems: duplicated registrations, runtime config lookups, no analyzer guardrails.

IoCTools (attributes, analyzers, generated DI)

using IoCTools.Abstractions.Annotations;

[Scoped]
[DependsOn<ILogger<BillingService>, IHttpClientFactory, IClock>]
[DependsOnConfiguration<string>("Billing:BaseUrl", Required = true)]
[DependsOnConfiguration<int>("Billing:RetryCount", DefaultValue = "3")]
public partial class BillingService : IBillingService
{
    public async Task ChargeAsync(BillingRequest request)
    {
        using var client = _httpClientFactory.CreateClient("billing");
        // _logger, _httpClientFactory, _clock, _baseUrl, _retryCount all available
    }
}

Generated code creates the constructor, binds configuration, and registers everything via builder.Services.AddYourAssemblyRegisteredServices(configuration).

Attribute Reference

Complete attribute reference: docs/attributes.md

Key attributes: [Scoped], [Singleton], [Transient], [DependsOn<T>], [DependsOnConfiguration<T>], [DependsOnOptions<T>], [RegisterAs<T>], [ConditionalService], and the 1.6.0 auto-deps surface ([assembly: AutoDep<T>], [assembly: AutoDepOpen(...)], [AutoDeps<TProfile>], [NoAutoDeps], …)

Diagnostics Reference

IoCTools provides core diagnostics through IOC108, plus testing diagnostics (TDIAG-01 through TDIAG-05) and FluentValidation diagnostics (IOC100-IOC102). See diagnostics.md for the full list.

Error-Severity Diagnostics

View all diagnostics including warnings and info

Configuration

IoCTools reads configuration from MSBuild properties/.editorconfig. Common knobs:

See configuration reference

Samples & License

• IoCTools.Sample demonstrates every attribute, diagnostic, and configuration scenario
• Licensed under MIT. See LICENSE