Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guorg/gu.inject
A minimal container.
https://github.com/guorg/gu.inject
Last synced: about 4 hours ago
JSON representation
A minimal container.
- Host: GitHub
- URL: https://github.com/guorg/gu.inject
- Owner: GuOrg
- License: mit
- Created: 2017-04-05T22:28:40.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-03T17:48:52.000Z (9 months ago)
- Last Synced: 2024-11-16T08:15:56.644Z (4 days ago)
- Language: C#
- Homepage:
- Size: 714 KB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: License
Awesome Lists containing this project
README
# Gu.Inject
A dependency injection library with no features. The lack of features is the main feature!
[](https://ci.appveyor.com/project/GuOrg/gu-inject/branch/master)
[](https://dev.azure.com/guorg/Gu.Inject/_build/latest?definitionId=2&branchName=master)
[](https://gitter.im/JohanLarsson/Gu.Inject?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
# Defaults
- Concrete types with one constructor are resolved by default.
- One public constructor.
- Params parameter not supported.
- Class.
- Everything from the container is singleton.
- Constructor injection only unless providing custom factory functions.
- Require explicit bindings for interfaces and abstract types. Only one binding per type.
- Bind not allowed after resolving. Throws exception.
- Rebind shipped in a separate nuget to enforce that it is only used by tests.
- Dispose all things created by the container.
# Usage
```cs
using var kernel = new Kernel();
var root = kernel.Get();
```
## Bind interface
```cs
using var kernel = new Kernel()
.Bind();
var root = kernel.Get();
```
Note that:
```cs
using var kernel = new Kernel()
.Bind()
.Bind(); // throws binding IFoo a second time.
```
Also note:
```cs
using var kernel = new Kernel();
var root = kernel.Get();
kernal.Bind(() => new Foo()); // throws binding after Get.
```
## Bind factory
```cs
using var kernel = new Kernel()
.Bind(() => Foo.Create()); // this instance is disposed when the container is disposed
var root = kernel.Get();
kernel.Bind(); // throws as we did Get meaning bind no longer allowed.
```
Also allowed:
```cs
using var kernel = new Kernel()
.Bind(() => Foo.Create()); // this instance is disposed when the container is disposed
var root = kernel.Get();
```
## Bind resolver factory
```cs
using var kernel = new Kernel()
.Bind(c => Foo.Create(c.Get())); // this instance is disposed when the container is disposed
var root = kernel.Get();
```
Also allowed:
```cs
using var kernel = new Kernel()
.Bind(c => Foo.Create(c.Get())); // this instance is disposed when the container is disposed
var root = kernel.Get();
```
## Bind instance
```cs
using var kernel = new Kernel()
.Bind(Foo.Instance); // this instance is not disposed when the container is disposed
var root = kernel.Get();
```
Also allowed:
```cs
using var kernel = new Kernel()
.Bind(new Foo()); // this instance is not disposed when the container is disposed
```
## Events
### Kernel.Creating
Notifies before the container creates an instance. The event arguments contains the type that is about to be created.
### Kernel.Created
Notifies after the container created an instance. The event arguments contains the instance that was created.
### Kernel.Disposing
Notifies after calling kernel.Dispose() before an instance is removed. The event arguments contains the instance.
This can be used if there is additional cleanup needed.
Note that it is called for all instances not just for types that implement `IDisposable`
# Benchmark
Creating a container and resolving a graph with 50 types.
https://github.com/GuOrg/Gu.Inject/blob/master/Gu.Inject.Benchmarks/Benchmarks/GetGraph50.cs
```
| Method | Mean | Ratio | Allocated |
|------------------ |------------:|-------:|----------:|
| Ninject | 7,748.16 μs | 365.83 | 239.35 KB |
| SimpleInjector | 6,592.05 μs | 296.92 | 202.58 KB |
| DryIoc | 182.59 μs | 8.25 | 73.82 KB |
| ServiceCollection | 41.37 μs | 1.86 | 20.68 KB |
| Gu.Inject | 22.14 μs | 1.00 | 8.11 KB |
```