How kirov-opensource/nautowired works
Project Type and Purpose
• This is a .NET-based dependency-injection framework/library (NAutowired) with multiple integration layers:
• NAutowired.Core – the core attribute- and reflection-based injector
• NAutowired – ASP.NET Core integration (IControllerActivator replacement)
• NAutowired.Console – console-host integration
• Sample applications (ASP.NET Core 3.x, ASP.NET Core 6, Console)
• Unit tests for injection scenarios
File-Structure Analysis
• Top-level solution “NAutowired.sln” aggregates four main projects plus Samples and scripts.
• NAutowired.Core: Attributes, Models, Extensions, Exceptions, Startup base class
• NAutowired.Console: ConsoleHost builder and default host implementation
• NAutowired: ASP.NET Core controller activator and attribute for ServiceFilter
• NAutowired.Console.Test: unit tests covering injection scenarios, lifetime, circular deps
• Sample folder: three sample apps demonstrating WebAPI (3.x & 6) and Console usage
• Build/deployment scripts under “scripts/” and CI workflows under “.github/workflows”
README Insights
• The library “ports”/.extends the default .NET Core container, adding field injection via [Autowired]
• ASP.NET Core sample replaces default IControllerActivator with NAutowiredControllerActivator
• ConsoleHost (NAutowired.Console) bootstraps the Core DI container and injects into Startup.Run
• Supports automatic registration (AutoRegisterDependency), attributes ([Service], [Repository], etc.), and manual registration
Main Components & Their Interactions (to include
A. Developer Application (two variants):
1. WebAPI Host
• ASP.NET Core runtime builds IServiceCollection
• Extension methods: AddControllersAsServices(), Replace(IControllerActivator → NAutowiredControllerActivator)
• Calls AutoRegisterDependency or manual services.AddScoped<…>()
2. Console Host
• ConsoleHost.CreateDefaultBuilder(assemblies, args)
• Builds IServiceCollection via Startup (inherits NAutowired.Core.Startup)
3. Common: Startup.ConfigureServices adds registrations, then builds ServiceProvider
B. NAutowired.Core Library
• Scans assemblies based on attribute markers or manual registration
• Builds internal DependencyTreeModels, enforces lifetimes, resolves types via reflection
• Provides extension methods: GetServiceWithAutowired, WithAutowired
C. NAutowired (ASP.NET Integration)
• NAutowiredControllerActivator intercepts controller creation
• Uses Core’s field-injection engine to set [Autowired] properties/fields
• ServiceFilter attribute triggers resolution of filters from ServiceProvider
D. NAutowired.Console
• DefaultConsoleHostBuilder → constructs ServiceProvider and runs Startup.Run(args)
• Injects [Autowired] fields into the Startup instance before Run()
E. DI Container (IServiceCollection → IServiceProvider)
• Central registry of ServiceDescriptors (manual + auto)
• Holds Transient, Scoped, Singleton lifetimes
Architectural Patterns & Design Principles
• Attribute-based field injection (similar to Spring but layered over .NET Core DI)
• Extension-method based container registration (fluent builder pattern)
• Decorator/Strategy for IControllerActivator replacement
• Reflection-driven auto-scanner for annotated classes
• Hosted-service pattern for console (ConsoleHost builder)