AutoCtor 2.4.5
dotnet add package AutoCtor --version 2.4.5
NuGet\Install-Package AutoCtor -Version 2.4.5
<PackageReference Include="AutoCtor" Version="2.4.5" />
paket add AutoCtor --version 2.4.5
#r "nuget: AutoCtor, 2.4.5"
// Install AutoCtor as a Cake Addin #addin nuget:?package=AutoCtor&version=2.4.5 // Install AutoCtor as a Cake Tool #tool nuget:?package=AutoCtor&version=2.4.5
AutoCtor
AutoCtor is a Roslyn Source Generator that will automatically create a constructor for your class for use with constructor Dependency Injection.
Contents
- NuGet packages
- Usage
- More Features
- More examples
- Embedding the attributes in your project
- Preserving usage of the
[AutoConstruct]
attribute - Stats
NuGet packages
https://nuget.org/packages/AutoCtor/
Usage
Your code
<a id='snippet-Basic'></a>
[AutoConstruct]
public partial class ExampleClass
{
private readonly IService _service;
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L6-L14' title='Snippet source file'>snippet source</a> | <a href='#snippet-Basic' title='Start of snippet'>anchor</a></sup>
What gets generated
<a id='snippet-BasicGeneratedCode'></a>
public ExampleClass(IService service)
{
_service = service;
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L18-L23' title='Snippet source file'>snippet source</a> | <a href='#snippet-BasicGeneratedCode' title='Start of snippet'>anchor</a></sup>
More Features
Post constructor Initialisation
You can mark a method to be called at the end of the constructor with the attribute [AutoPostConstruct]
. This method must return void.
<a id='snippet-PostConstruct'></a>
[AutoConstruct]
public partial class PostConstructMethod
{
private readonly IService _service;
[AutoPostConstruct]
private void Initialize()
{
}
}
<sup><a href='/src/AutoCtor.Example/PostConstructExamples.cs#L6-L19' title='Snippet source file'>snippet source</a> | <a href='#snippet-PostConstruct' title='Start of snippet'>anchor</a></sup>
<a id='snippet-PostConstructGeneratedCode'></a>
public PostConstructMethod(IService service)
{
_service = service;
Initialize();
}
<sup><a href='/src/AutoCtor.Example/PostConstructExamples.cs#L24-L30' title='Snippet source file'>snippet source</a> | <a href='#snippet-PostConstructGeneratedCode' title='Start of snippet'>anchor</a></sup>
Post constructor methods can also take parameters. These parameters will be passed in from the constructor.
<a id='snippet-PostConstructWithParameters'></a>
public partial class PostConstructMethodWithParameters
{
private readonly IService _service;
[AutoPostConstruct]
private void Initialize(IInitialiseService initialiseService)
{
}
}
<sup><a href='/src/AutoCtor.Example/PostConstructExamples.cs#L33-L45' title='Snippet source file'>snippet source</a> | <a href='#snippet-PostConstructWithParameters' title='Start of snippet'>anchor</a></sup>
<a id='snippet-PostConstructWithParametersGeneratedCode'></a>
public PostConstructMethodWithParameters(IService service, IInitialiseService initialiseService)
{
_service = service;
Initialize(initialiseService);
}
<sup><a href='/src/AutoCtor.Example/PostConstructExamples.cs#L50-L56' title='Snippet source file'>snippet source</a> | <a href='#snippet-PostConstructWithParametersGeneratedCode' title='Start of snippet'>anchor</a></sup>
Argument Guards
Null guards for the arguments to the constructor can be added in 2 ways.
In your project you can add a AutoCtorGuards
property.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<AutoCtorGuards>true</AutoCtorGuards>
</PropertyGroup>
</Project>
In each AutoConstruct
attribute you can add a setting to enable/disable guards.
<a id='snippet-Guards'></a>
[AutoConstruct(GuardSetting.Enabled)]
public partial class GuardedClass
{
private readonly Service _service;
}
<sup><a href='/src/AutoCtor.Example/GuardsExamples.cs#L5-L13' title='Snippet source file'>snippet source</a> | <a href='#snippet-Guards' title='Start of snippet'>anchor</a></sup>
<a id='snippet-GuardsGeneratedCode'></a>
public GuardedClass(Service service)
{
_service = service ?? throw new ArgumentNullException(nameof(service));
}
<sup><a href='/src/AutoCtor.Example/GuardsExamples.cs#L18-L23' title='Snippet source file'>snippet source</a> | <a href='#snippet-GuardsGeneratedCode' title='Start of snippet'>anchor</a></sup>
Property Initialisation
AutoCtor can set properties that are considered as read only properties.
<a id='snippet-PropertyExamples'></a>
// AutoCtor will initialise these
public string GetProperty { get; }
protected string ProtectedProperty { get; }
public string InitProperty { get; init; }
public required string RequiredProperty { get; set; }
// AutoCtor will ignore these
public string InitializerProperty { get; } = "Constant";
public string GetSetProperty { get; set; }
public string FixedProperty => "Constant";
public string RedirectedProperty => InitializerProperty;
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L80-L94' title='Snippet source file'>snippet source</a> | <a href='#snippet-PropertyExamples' title='Start of snippet'>anchor</a></sup>
More examples
You can also initialize readonly fields, and AutoCtor will not include them in the constructor.
<a id='snippet-PresetField'></a>
[AutoConstruct]
public partial class ClassWithPresetField
{
private readonly IService _service;
private readonly IList<string> _list = new List<string>();
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L26-L35' title='Snippet source file'>snippet source</a> | <a href='#snippet-PresetField' title='Start of snippet'>anchor</a></sup>
<a id='snippet-PresetFieldGeneratedCode'></a>
public ClassWithPresetField(IService service)
{
_service = service;
// no code to set _list
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L39-L45' title='Snippet source file'>snippet source</a> | <a href='#snippet-PresetFieldGeneratedCode' title='Start of snippet'>anchor</a></sup>
If there is a single base constructor with parameters, AutoCtor will include that base constructor in the constructor it creates.
<a id='snippet-Inherit'></a>
public abstract class BaseClass
{
protected IAnotherService _anotherService;
public BaseClass(IAnotherService anotherService)
{
_anotherService = anotherService;
}
}
[AutoConstruct]
public partial class ClassWithBase : BaseClass
{
private readonly IService _service;
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L48-L66' title='Snippet source file'>snippet source</a> | <a href='#snippet-Inherit' title='Start of snippet'>anchor</a></sup>
<a id='snippet-InheritGeneratedCode'></a>
public ClassWithBase(IAnotherService anotherService, IService service) : base(anotherService)
{
_service = service;
}
<sup><a href='/src/AutoCtor.Example/BasicExamples.cs#L70-L75' title='Snippet source file'>snippet source</a> | <a href='#snippet-InheritGeneratedCode' title='Start of snippet'>anchor</a></sup>
Embedding the attributes in your project
By default, the [AutoConstruct]
attributes referenced in your project are contained in an external dll. It is also possible to embed the attributes directly in your project. To do this, you must do two things:
- Define the MSBuild constant
AUTOCTOR_EMBED_ATTRIBUTES
. This ensures the attributes are embedded in your project. - Add
compile
to the list of excluded assets in your<PackageReference>
element. This ensures the attributes in your project are referenced, insted of the AutoCtor.Attributes.dll library.
Your project file should look like this:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<DefineConstants>AUTOCTOR_EMBED_ATTRIBUTES</DefineConstants>
</PropertyGroup>
<PackageReference Include="AutoCtor"
PrivateAssets="all"
ExcludeAssets="compile;runtime" />
</Project>
Preserving usage of the [AutoConstruct]
attribute
The [AutoConstruct]
attributes are decorated with the [Conditional]
attribute, so their usage will not appear in the build output of your project. If you use reflection at runtime you will not find the [AutoConstruct]
attributes.
If you wish to preserve these attributes in the build output, you can define the AUTOCTOR_USAGES
MSBuild variable.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<DefineConstants>AUTOCTOR_USAGES</DefineConstants>
</PropertyGroup>
<PackageReference Include="AutoCtor" PrivateAssets="all" />
</Project>
Stats
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on AutoCtor:
Repository | Stars |
---|---|
LykosAI/StabilityMatrix
Multi-Platform Package Manager for Stable Diffusion
|
Version | Downloads | Last updated |
---|---|---|
2.4.5 | 939 | 11/27/2024 |
2.4.4 | 93 | 11/26/2024 |
2.4.3 | 3,779 | 9/21/2024 |
2.4.2 | 2,437 | 8/10/2024 |
2.4.1 | 3,499 | 7/25/2024 |
2.4.0 | 5,442 | 5/26/2024 |
2.3.0 | 4,571 | 4/15/2024 |
2.3.0-alpha.1 | 71 | 4/9/2024 |
2.2.0 | 8,181 | 3/13/2024 |
2.2.0-alpha.2 | 69 | 3/7/2024 |
2.2.0-alpha.1 | 68 | 3/7/2024 |
2.1.1 | 3,564 | 2/6/2024 |
2.1.0 | 3,742 | 12/29/2023 |
2.1.0-rc.1 | 170 | 11/4/2023 |
2.0.1-alpha.1 | 78 | 10/4/2023 |
2.0.0 | 4,826 | 9/12/2023 |
2.0.0-alpha.4 | 1,544 | 9/4/2023 |
2.0.0-alpha.3 | 86 | 9/4/2023 |
2.0.0-alpha.1 | 184 | 9/1/2023 |
1.3.0-initialize-1 | 133 | 8/15/2023 |
1.2.0 | 1,522 | 8/4/2023 |
1.1.1 | 3,387 | 5/28/2023 |
1.1.0 | 158 | 5/27/2023 |
1.0.0 | 7,792 | 3/29/2023 |
0.9.0 | 246 | 3/15/2023 |
0.8.0 | 1,279 | 1/18/2023 |
0.7.1 | 360 | 12/26/2022 |
0.7.0 | 304 | 12/26/2022 |
0.6.1 | 1,197 | 11/21/2022 |
0.6.0 | 333 | 11/19/2022 |
0.5.0 | 1,249 | 10/6/2022 |
0.4.0 | 1,824 | 7/22/2022 |
0.3.0 | 482 | 7/12/2022 |
0.2.2 | 445 | 7/12/2022 |
0.2.1 | 460 | 7/11/2022 |
0.2.0 | 432 | 7/11/2022 |
0.1.2 | 433 | 7/9/2022 |
0.1.1 | 442 | 7/9/2022 |
0.1.0 | 513 | 7/9/2022 |