https://github.com/nurlanvalizada/nlbinjecto
Custom, lightweight, extensible, and testable dependency injection (DI) container for .NET applications. Built from scratch to help you understand DI internals, customize registrations, and extend behavior beyond the built-in .NET DI framework
https://github.com/nurlanvalizada/nlbinjecto
aspnetcore csharp dependency-injection dotnet
Last synced: 5 months ago
JSON representation
Custom, lightweight, extensible, and testable dependency injection (DI) container for .NET applications. Built from scratch to help you understand DI internals, customize registrations, and extend behavior beyond the built-in .NET DI framework
- Host: GitHub
- URL: https://github.com/nurlanvalizada/nlbinjecto
- Owner: nurlanvalizada
- License: mit
- Created: 2024-10-17T06:38:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-06T04:50:59.000Z (over 1 year ago)
- Last Synced: 2025-10-03T05:40:30.071Z (9 months ago)
- Topics: aspnetcore, csharp, dependency-injection, dotnet
- Language: C#
- Homepage: https://www.nuget.org/packages/NLBInjecto
- Size: 42 KB
- Stars: 36
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NLBInjecto - Lightweight DI Container
[](LICENSE)
[](https://www.nuget.org/packages/NLBInjecto/1.0.0)
NlbInjecto is a **custom**, **lightweight**, **extensible**, and **testable** dependency injection (DI) container for .NET applications. Built from scratch to help you **understand** DI internals, **customize** registrations, and **extend** behavior beyond the built-in .NET DI framework.
## Table of Contents
- [NLBInjecto - Lightweight DI Container](#nlbinjecto---lightweight-di-container)
- [Table of Contents](#table-of-contents)
- [Features](#features)
- [Motivation](#motivation)
- [Installation](#installation)
- [Getting Started](#getting-started)
- [Basic Registration \& Resolution](#basic-registration--resolution)
- [Open Generic Registration](#open-generic-registration)
- [Decorators](#decorators)
- [Scopes](#scopes)
- [Keyed Services](#keyed-services)
- [Contributing](#contributing)
- [How to Contribute](#how-to-contribute)
- [License](#license)
---
## Features
- **Open Generic Support**
Register types like `IGenericService` -> `GenericService` and let the container resolve any closed generic at runtime.
- **Decorator Support**
Easily wrap services with decorators (e.g., logging, caching, or cross-cutting concerns) for both non-generic and open-generic services.
- **Multiple Lifetimes**
Supports Singleton, Scoped, and Transient lifetimes. Control exactly how and when your services are instantiated.
- **Named Registrations**
Optionally register services with a name to allow multiple implementations of the same interface.
- **Resolving service with most parametered contructor**
When resolving services NLBInjecto takes contructor with most parameters
- **Testable**
Includes comprehensive unit tests demonstrating behavior and best practices.
---
## Motivation
My motivation for built such repository is to show how we can build complex systems step by step. Maybe this is not a complete solution but it offer most of the functionality which modern DI containers offer.
---
## Installation
1. Clone or download the repository.
2. Open the solution in Visual Studio or JetBrains Rider.
3. Build the project. You’re set to include this library in your application.
*(Alternatively, it is available as a NuGet package. You can add it to your projects like this `dotnet add package NLBInjecto`.)*
---
## Getting Started
### Basic Registration & Resolution
```csharp
var services = new NlbServiceCollection();
// Register: IMyService -> MyService
services.AddScoped();
// Build the provider
var provider = services.BuildServiceProvider();
// Resolve
var myService = provider.GetService();
myService.DoWork();
```
### Open Generic Registration
```csharp
var services = new NlbServiceCollection();
// Register open generic: IGenericService -> GenericService
services.AddSingleton(typeof(IGenericService<>), typeof(GenericService<>));
var provider = services.BuildServiceProvider();
// Resolve closed generics
var intService = provider.GetService>();
var stringService = provider.GetService>();
Console.WriteLine(intService.GetValue());
Console.WriteLine(stringService.GetValue());
```
### Decorators
```csharp
var services = new NlbServiceCollection();
// Base registration
services.AddScoped();
// Decorator registration
services.AddDecorator();
var provider = services.BuildServiceProvider();
var orderService = provider.GetService();
// -> Actually returns OrderServiceLoggingDecorator
// that wraps the real OrderService
```
And for **open generics**:
```csharp
services.AddScoped(typeof(IGenericService<>), typeof(GenericService<>));
services.AddDecorator(typeof(IGenericService<>), typeof(GenericServiceDecorator<>));
```
### Scopes
```csharp
var services = new NlbServiceCollection();
services.AddScoped();
var provider = services.BuildServiceProvider();
// Create first scope
using (var scopeA = provider.CreateScope())
{
var serviceA1 = scopeA.ServiceProvider.GetService();
var serviceA2 = scopeA.ServiceProvider.GetService();
// serviceA1 == serviceA2 (same scope, same instance if scoped)
}
// Create second scope
using (var scopeB = provider.CreateScope())
{
var serviceB1 = scopeB.ServiceProvider.GetService();
// serviceB1 != serviceA1 (different scope, new instance)
}
```
### Keyed Services
```csharp
var services = new NlbServiceCollection();
services.AddTransient("test");
services.AddDecorator();
var provider = services.BuildServiceProvider();
var transientService = serviceProvider.GetService("test");
// transientService here is TransientService
```
## Contributing
**Contributions are welcome!** I’d love to see **pull requests** for:
- New features (e.g., advanced constructor injection, property injection).
- Bug fixes if you find any.
- Enhancements to documentation or samples.
- Performance improvements.
### How to Contribute
1. **Fork** this repository and **clone** it locally.
2. Create a new **branch** for your feature or fix.
3. **Commit** your changes with clear messages.
4. Push the branch to your **fork**.
5. Open a **Pull Request** from your fork’s branch to this repository’s `main` branch.
6. Once reviewed, I’ll **merge** your changes.
Feel free to open an **issue** if you find a bug or have a feature request.
## License
This project is licensed under the [MIT LICENSE](LICENSE). You are free to use it in both commercial and open-source software.