SourceInject 0.1.12
dotnet add package SourceInject --version 0.1.12
NuGet\Install-Package SourceInject -Version 0.1.12
<PackageReference Include="SourceInject" Version="0.1.12" />
paket add SourceInject --version 0.1.12
#r "nuget: SourceInject, 0.1.12"
// Install SourceInject as a Cake Addin #addin nuget:?package=SourceInject&version=0.1.12 // Install SourceInject as a Cake Tool #tool nuget:?package=SourceInject&version=0.1.12
Source Inject
A source generator for C# that uses Roslyn (the C# compiler) to allow you to generate your dependencies injection during compile time. By doing this you avoid using reflection and services are automatically registered.
How to use it
Install it and add an attribute to the classes you want injected in your service provider, like so:
[Inject]
public class ExampleService
{
private readonly AnotherService anotherService;
public ExampleService(AnotherService anotherService) =>
this.anotherService = anotherService;
public string GetValue() => anotherService.Value;
}
[Inject(ServiceLifetime.Singleton)]
public class AnotherService
{
public string Value => "Hello World!";
}
As you can see above you can define the lifetime. The default lifetime is transient. You can also use the following attributes:
InjectSingletonAttribute
InjectScopedAttribute
InjectTransientAttribute
The last one is the same as using Inject
without any arguments.
You then have to call the Discover
method so these classes are found and the source is generated.
You can then require them using constructor injection or service locator, for example:
var services = new ServiceCollection();
services.Discover();
var serviceProvider = services.BuildServiceProvider();
var exampleService = serviceProvider.GetRequiredService<ExampleService>();
You can also discover services in other assemblies. To be able to do this you have to call
the method DiscoverIn<AssemblyName>
or <AssemblyName>Discoverer.Discover(services)
. If your
assembly name has dots .
in them they will be replaced by underscore _
.
All these methods (Discover
et all) and attributes will be generated in your project for you.
You can see the generated code using Visual Studio. See here for an example.
Installing
The package is available (on NuGet. To install from the command line:
dotnet add package sourceinject
Or use the Package Manager in Visual Studio.
Contributing
The main supported IDE for development is Visual Studio 2019.
Questions, comments, bug reports, and pull requests are all welcome. Bug reports that include steps to reproduce (including code) are preferred. Even better, make them in the form of pull requests. Before you start to work on an existing issue, check if it is not assigned to anyone yet, and if it is, talk to that person.
Maintainers/Core team
- Giovanni Bassi, aka Giggio, Lambda3, @giovannibassi
Contributors can be found at the contributors page on Github.
License
This software is open source, licensed under the MIT License. See LICENSE for details. Check out the terms of the license before you contribute, fork, copy or do anything with the code. If you decide to contribute you agree to grant copyright of all your contribution to this project and agree to mention clearly if do not agree to these terms. Your work will be licensed with the project at MIT, along the rest of the code.
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.1.12 | 1,344 | 3/23/2022 |