Canister.IoC
5.1.6
See the version list below for details.
dotnet add package Canister.IoC --version 5.1.6
NuGet\Install-Package Canister.IoC -Version 5.1.6
<PackageReference Include="Canister.IoC" Version="5.1.6" />
paket add Canister.IoC --version 5.1.6
#r "nuget: Canister.IoC, 5.1.6"
// Install Canister.IoC as a Cake Addin #addin nuget:?package=Canister.IoC&version=5.1.6 // Install Canister.IoC as a Cake Tool #tool nuget:?package=Canister.IoC&version=5.1.6
Canister
Canister is one of the easiest ways to get IoC configuration under control. No longer do you have to search for that one class that you forgot to register. Instead use Canister to handle discovery and registration for you using a simple interface.
Basic Usage
The system has a fairly simple interface and only a couple of functions that need explaining. The first is setup:
public void ConfigureServices(IServiceCollection services)
{
...
services.AddCanisterModules();
}
AddCanisterModules will automatically scan assemblies for modules and load them accordingly. Or if you're doing a desktop app:
var Services = new ServiceCollection().AddCanisterModules();
Note that if you like, you can control which assemblies are searched:
public void ConfigureServices(IServiceCollection services)
{
...
services.AddCanisterModules(configure => configure.AddAssembly(typeof(Startup).Assembly));
}
It's recommended that you do this for security reasons as the default will search all assemblies found in the entry assembly's top level directory.
Modules
Canister uses the concept of modules to wire things up. This allows you to place registration code in libraries that your system is using instead of worrying about it in every application. Simply add your library and Canister will automatically wire it up for you. In order to do this, under Canister.Interfaces there is the IModule interface. This interface, when implemented, has two items in it. The first is a property called Order. This determines the order that the modules are loaded in. The second is a function called Load:
public class TestModule : IModule
{
public int Order => 1;
public void Load(IServiceCollection bootstrapper)
{
bootstrapper.AddAllTransient<IMyInterface>();
bootstrapper.AddTransient<MyType>();
}
}
The module above is loaded automatically by the system and will have the Load function called at initialization time. At this point you should be able to resolve and register classes using the bootstrapper parameter. The service collection also has a couple of extra extension methods: AddAllTransient, AddAllScoped, AddAllSingleton:
bootstrapper.AddAllTransient<IMyInterface>();
The AddAllxxxx functions will find everything that implements a class or interface in the Assemblies that you tell it to look in and will register them with the service collection.
Working With Other IoC Containers
While the library assumes you are using the built in ServiceCollection, it is possible to work with IoC containers. All that is required is that it implements the IServiceCollection interface.
Using Canister in Your library
If you wish to use Canister in your library it is recommended that you build an extension method off of the ICanisterConfiguration interface that will allow you to register your needed assemblies for the user to make the experience a bit simpler when they want to control configuration themselves.
Installation
The library is available via Nuget with the package name "Canister.IoC". To install it run the following command in the Package Manager Console:
Install-Package Canister.IoC
Build Process
In order to build the library you may require the following:
- Visual Studio 2022
Other than that, just clone the project and you should be able to load the solution and build without too much effort.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- Fast.Activator (>= 2.0.21)
- Microsoft.Extensions.DependencyInjection (>= 7.0.0)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Canister.IoC:
Package | Downloads |
---|---|
Aspectus
Aspectus is an advanced Aspect-Oriented Programming (AOP) library that simplifies the injection of cross-cutting concerns into your codebase. It empowers you to write clean and maintainable code by separating cross-cutting concerns from the core logic of your application. |
|
ObjectCartographer
ObjectCartographer is a high-performance, convention-based C# object-to-object mapping library designed to simplify the process of copying data between objects. It eliminates the tedious task of manually writing code for data copying by providing a developer-friendly approach. |
|
SerialBox
SerialBox is a simple serialization wrapper. It acts as a wrapper around various serialization libraries, thus giving them a common interface to deal with. |
|
SimpleHtmlToPdf
.Net wrapper of wkhtmltopdf library to convert HTML pages to PDF. |
|
FileCurator.Windows
FileCurator.Windows is a set of formats that are only available using the full version of the .Net framework. If an alternative is built in .Net Standard these will be replaced. So consider this a hold over. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
5.3.13 | 1,600 | 8/22/2024 |
5.3.12 | 4,503 | 8/1/2024 |
5.3.11 | 5,308 | 6/24/2024 |
5.3.10 | 13,952 | 6/17/2024 |
5.3.9 | 8,277 | 5/6/2024 |
5.3.8 | 1,894 | 5/1/2024 |
5.3.7 | 1,509 | 4/30/2024 |
5.3.6 | 5,976 | 3/27/2024 |
5.3.5 | 2,952 | 3/14/2024 |
5.3.4 | 991 | 3/13/2024 |
5.3.3 | 2,446 | 3/4/2024 |
5.3.2 | 4,563 | 2/26/2024 |
5.3.1 | 2,973 | 2/21/2024 |
5.3.0 | 1,606 | 2/19/2024 |
5.2.4 | 5,187 | 2/2/2024 |
5.2.3 | 6,049 | 1/29/2024 |
5.2.2 | 4,103 | 1/19/2024 |
5.2.1 | 8,292 | 12/11/2023 |
5.2.0 | 407 | 12/10/2023 |
5.1.17 | 4,998 | 11/17/2023 |
5.1.16 | 1,831 | 11/16/2023 |
5.1.15 | 3,311 | 11/6/2023 |
5.1.14 | 2,763 | 10/30/2023 |
5.1.13 | 5,689 | 9/18/2023 |
5.1.12 | 3,496 | 9/11/2023 |
5.1.11 | 3,002 | 9/5/2023 |
5.1.10 | 1,741 | 9/4/2023 |
5.1.9 | 2,580 | 8/31/2023 |
5.1.8 | 2,063 | 8/30/2023 |
5.1.7 | 1,722 | 8/29/2023 |
5.1.6 | 6,987 | 8/8/2023 |
5.1.5 | 1,865 | 8/7/2023 |
5.1.4 | 5,818 | 7/13/2023 |
5.1.3 | 1,493 | 7/12/2023 |
5.1.2 | 1,741 | 7/10/2023 |
5.1.1 | 2,246 | 7/7/2023 |
5.1.0 | 544 | 7/7/2023 |
5.0.1 | 8,181 | 12/10/2022 |
5.0.0 | 677 | 12/10/2022 |
4.0.14 | 2,360 | 8/16/2022 |
4.0.13 | 800 | 8/16/2022 |
4.0.12 | 803 | 8/16/2022 |
4.0.11 | 12,876 | 3/22/2022 |
4.0.6 | 13,447 | 1/11/2022 |
4.0.5 | 698 | 1/11/2022 |
4.0.3 | 5,508 | 8/24/2021 |
4.0.2 | 10,975 | 6/15/2021 |
4.0.1 | 10,892 | 4/30/2021 |
4.0.0 | 13,456 | 1/6/2021 |
3.0.7 | 6,395 | 11/16/2020 |
3.0.4 | 8,236 | 9/13/2020 |
3.0.3 | 27,750 | 3/29/2020 |
3.0.2 | 33,038 | 2/16/2020 |
3.0.1 | 2,375 | 12/27/2019 |
3.0.0 | 10,344 | 11/23/2019 |
2.1.6 | 1,763 | 6/19/2019 |
2.1.5 | 8,421 | 4/16/2019 |
2.1.4 | 1,094 | 4/16/2019 |
2.1.3 | 8,968 | 2/21/2019 |
2.1.2 | 19,994 | 5/31/2018 |
2.1.1 | 6,756 | 5/31/2018 |
2.0.3 | 2,790 | 5/22/2018 |
2.0.2 | 4,874 | 5/21/2018 |
2.0.1 | 8,484 | 2/2/2018 |
2.0.0 | 10,291 | 1/2/2018 |
1.0.50 | 15,932 | 9/29/2017 |
1.0.49 | 27,539 | 8/24/2017 |
1.0.46 | 21,954 | 6/8/2017 |
1.0.45 | 1,411 | 6/8/2017 |
1.0.44 | 1,439 | 6/8/2017 |
1.0.43 | 1,380 | 6/8/2017 |
1.0.42 | 25,835 | 5/17/2017 |
1.0.41 | 9,449 | 3/22/2017 |
1.0.40 | 1,383 | 3/22/2017 |
1.0.35 | 7,243 | 1/23/2017 |
1.0.34 | 1,456 | 1/23/2017 |
1.0.33 | 1,694 | 1/18/2017 |
1.0.32 | 1,433 | 12/9/2016 |
1.0.31 | 5,817 | 12/9/2016 |
1.0.30 | 1,426 | 12/9/2016 |
1.0.26 | 5,537 | 11/18/2016 |
1.0.23 | 1,382 | 11/18/2016 |
1.0.21 | 1,441 | 11/18/2016 |
1.0.20 | 1,472 | 11/18/2016 |
1.0.19 | 2,158 | 10/28/2016 |
1.0.18 | 1,435 | 10/28/2016 |
1.0.17 | 1,440 | 10/28/2016 |
1.0.16 | 1,477 | 10/28/2016 |
1.0.15 | 1,425 | 10/28/2016 |
1.0.0 | 1,518 | 10/28/2016 |