https://github.com/tim-maes/bindicate
An autowiring library for .NET.
https://github.com/tim-maes/bindicate
attributes autowiring csharp dependency dependency-injection injection ioc ioc-con ioc-container net8 service-collection services
Last synced: 8 months ago
JSON representation
An autowiring library for .NET.
- Host: GitHub
- URL: https://github.com/tim-maes/bindicate
- Owner: Tim-Maes
- License: mit
- Created: 2023-10-09T09:38:58.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-02-17T07:56:50.000Z (over 1 year ago)
- Last Synced: 2025-08-27T06:50:25.378Z (10 months ago)
- Topics: attributes, autowiring, csharp, dependency, dependency-injection, injection, ioc, ioc-con, ioc-container, net8, service-collection, services
- Language: C#
- Homepage:
- Size: 115 KB
- Stars: 31
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
```
'A blend of "Bind" and "Indicate"'.
```
 
## Features 🌟
- Automatic registration of (keyed) services using custom attributes.
- Automatic registration and configuration of options via `IOptions`.
- Provides clear visibility and reduces boilerplate code.
- Simple integration with the built-in .NET IoC container.
- Supports Decorators
### Supported types
| **Type** | **Available** | **Keyed (.NET 8)** | Decorators |Interceptors | Activators |
|--------------------|----------|------------------------------|---------|------------|------------|
|AddTransient |✔️ |✔️ | ✔️|❌ |❌ |
|TryAddTransient |✔️ |❌ | ❌| ❌|❌ |
|AddScoped |✔️ |✔️ |✔️ | ❌| ❌|
|TryAddScoped |✔️ |❌ |❌ |❌ |❌ |
|AddSingleton |✔️ |✔️ | ✔️| ❌| ❌|
|TryAddSingleton |✔️ |❌ |❌ |❌ |❌ |
|TryAddEnumerable |✔️ |❌ | ❌| ❌|❌ |
## Installation 📦
### Via NuGet
```bash
Install-Package Bindicate
```
or
```
dotnet add package Bindicate
```
## Usage
You can check out the [documentation](https://github.com/Tim-Maes/Bindicate/wiki) for examples and more information on how to use Bindicate.
### Quick overview
Add this line in a project to register all decorated services.
To also [configure options](https://github.com/Tim-Maes/Bindicate/wiki/03.-Registering-Options), use `.WithOptions()`.
You can also use the `ServiceCollectionExtension` pattern and use `IConfiguration` as a parameters for your extension method if they have options to register.
**Example in host project**
```csharp
// Register all decorated services for the current assembly
builder.Services
.AddAutowiringForAssembly(Assembly.GetExecutingAssembly())
.Register();
// Also register Keyed Services (.NET 8)
builder.Services
.AddAutowiringForAssembly(Assembly.GetExecutingAssembly())
.ForKeyedServices()
.Register();
// Also register Options as IOptions
builder.Services
.AddAutowiringForAssembly(Assembly.GetExecutingAssembly())
.ForKeyedServices()
.WithOptions(Configuration) //Pass builder.Configuration here
.Register();
```
**Example usage**
```csharp
[AddScoped(typeof(IMyTaskRunner))]
public class TaskRunner : IMyTaskRunner
{
public void Run()
{
// ...
}
}
public interface IMyTaskRunner
{
void Run();
}
```
## License
This project is licensed under the MIT license.