PrimaryConstructor - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #golang #deep-learning #java #windows #cli #awesome-list #security #ios #mcp

PrimaryConstructor

(★ 108)

Generate primary constructor from readonly fields

File Explorer

Download Latest Version (.zip)

- IgnorePrimaryConstructorAttribute.cs
- IncludePrimaryConstructorAttribute.cs
- PrimaryConstructor.csproj
- PrimaryConstructorAttribute.cs
- PrimaryConstructorGenerator.cs
- SyntaxReceiver.cs
- PrimaryConstructor.Sample.csproj
- Program.cs
.editorconfig
.gitignore
LICENSE
PrimaryConstructor.sln
README.md

# Installation Guide

1. Get the code

git clone https://github.com/chaowlert/PrimaryConstructor

Downloads the entire project code from GitHub to your computer.

cd PrimaryConstructor

Moves into the project folder you just downloaded.

2. .NET

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
.NET SDK The SDK required for the dotnet command.

cd PrimaryConstructor.Sample

This project's files live in a subfolder, so move into it first.

dotnet restore

Downloads the packages the project depends on.

dotnet run

Builds the project and runs it immediately.

✅ After dotnet run, check the message or address shown in the terminal.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PrimaryConstructor
Generate primary constructor from readonly fields & properties

[![NuGet](https://img.shields.io/nuget/v/PrimaryConstructor.svg)](https://www.nuget.org/packages/PrimaryConstructor)

![image](https://user-images.githubusercontent.com/5763993/97197488-4b65ad80-17e0-11eb-9eef-305ce284eb78.png)

### Get it
```
PM> Install-Package PrimaryConstructor
```

### Prerequisites

Visual Studio version 16.8 and above is required as its first version to support source generators.

### Usage

Declare class with `partial`, and annotate with `[PrimaryConstructor]`.  
And then you can declare your dependencies with readonly fields.

```csharp
[PrimaryConstructor]
public partial class MyService
{
    private readonly MyDependency _myDependency;

...
}
```

When compile, following source will be injected.

```csharp
partial class MyService
{
    public MyService(MyDependency myDependency)
    {
        this._myDependency = myDependency;
    }
}
```

### Rules

1. **readonly** fields & properties **without initializer** will be automatically injected.
2. if the service has based type, based type must also annotated with `PrimaryConstructor` in order to inject members from based type.
3. you can exclude members from injection by annotated with `IgnorePrimaryConstructor`.
4. you can include members to injection by annotated with `IncludePrimaryConstructor`.

### Emit generated files

Visual Studio still not fully support source generator, it sometimes shows error marker on symbols referred to the generated code.
Emitting the generated files will allow you to see the code, and also solve Visual Studio error marker problem.

To emit generated files, add following code to your `csproj` file.

```xml
<PropertyGroup>
  <CompilerGeneratedFilesOutputPath>$(MSBuildProjectDirectory)/generated</CompilerGeneratedFilesOutputPath>
  <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
</PropertyGroup>

<Target Name="ExcludeGenerated" BeforeTargets="AssignTargetPaths">
  <ItemGroup>
    <Generated Include="generated/**/*.g.cs" />
    <Compile Remove="@(Generated)" />
  </ItemGroup>
  <Delete Files="@(Generated)" />
</Target>
```

Please check [PrimaryConstructor.Sample.csproj](https://github.com/chaowlert/PrimaryConstructor/blob/main/PrimaryConstructor.Sample/PrimaryConstructor.Sample.csproj) for sample.