N.SourceGenerators.UnionTypes 0.5.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package N.SourceGenerators.UnionTypes --version 0.5.0
                    
NuGet\Install-Package N.SourceGenerators.UnionTypes -Version 0.5.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="N.SourceGenerators.UnionTypes" Version="0.5.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="N.SourceGenerators.UnionTypes" Version="0.5.0" />
                    
Directory.Packages.props
<PackageReference Include="N.SourceGenerators.UnionTypes" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add N.SourceGenerators.UnionTypes --version 0.5.0
                    
#r "nuget: N.SourceGenerators.UnionTypes, 0.5.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package N.SourceGenerators.UnionTypes@0.5.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=N.SourceGenerators.UnionTypes&version=0.5.0
                    
Install as a Cake Addin
#tool nuget:?package=N.SourceGenerators.UnionTypes&version=0.5.0
                    
Install as a Cake Tool

N.SourceGenerators.UnionTypes

Discriminated union type source generator

Motivation

C# doesn't support discriminated unions yet. This source generator helps automate writing union types.

Using

Add package reference to N.SourceGenerators.UnionTypes

dotnet add package N.SourceGenerators.UnionTypes

Create a partial class that will be used as a union type

public partial class FooResult
{
}

Add types you want to use in a discriminated union

public record Success(int Value);
public record ValidationError(string Message);
public record NotFoundError;

public partial class FooResult
{
}

Add N.SourceGenerators.UnionTypes.UnionTypeAttribute to a union type.

using N.SourceGenerators.UnionTypes;

public record Success(int Value);
public record ValidationError(string Message);
public record NotFoundError;

[UnionType(typeof(Success))]
[UnionType(typeof(ValidationError))]
[UnionType(typeof(NotFoundError))]
public partial class FooResult
{
}

Examples

All examples can be found in examples project

Implicit conversion

public FooResult ImplicitReturn()
{
    // you can return any union type variation without creating FooResult
    return new NotFoundError();
}

Explicit conversion

public ValidationError ExplicitCast(FooResult result)
{
    return (ValidationError)result;
}

Match and MatchAsync methods force you to handle all possible variations

public IActionResult MatchMethod(FooResult result)
{
    return result.Match<IActionResult>(
        success => new OkResult(),
        validationError => new BadRequestResult(),
        notFoundError => new NotFoundResult()
    );
}

public async Task<IActionResult> MatchAsyncMethod(FooResult result, CancellationToken cancellationToken)
{
    return await result.MatchAsync<IActionResult>(
        static async (success, ct) =>
        {
            await SomeWork(ct);
            return new OkResult();
        }, static async (validationError, ct) =>
        {
            await SomeWork(ct);
            return new BadRequestResult();
        }, static async (notFoundError, ct) =>
        {
            await SomeWork(ct);
            return new NotFoundResult();
        }, cancellationToken);

    static Task SomeWork(CancellationToken ct)
    {
        return Task.Delay(100, ct);
    }
}
There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on N.SourceGenerators.UnionTypes:

Package Downloads
Zomp.SyncMethodGenerator

Generates synchronized method from async method

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.28.0 11,085 5/2/2024
0.28.0-rc.61 49 5/2/2024
0.28.0-rc.60 36 5/2/2024
0.27.0 1,530 3/19/2024
0.27.0-rc.58 78 3/19/2024
0.27.0-rc.57 97 3/13/2024
0.26.0 47,666 10/26/2023
0.26.0-rc.55 88 11/16/2023
0.26.0-rc.53 92 10/30/2023
0.26.0-rc.52 82 10/30/2023
0.26.0-rc.51 85 10/30/2023
0.26.0-rc.50 78 10/30/2023
0.26.0-rc.48 98 10/26/2023
0.25.3 382 10/18/2023
0.25.3-rc.41 92 10/18/2023
0.25.1-rc.40 347 10/17/2023
0.25.0-rc.39 103 10/17/2023
0.24.0 1,039 10/17/2023
0.24.0-rc.37 146 10/16/2023
0.23.0 727 10/3/2023
0.23.0-rc.35 315 10/2/2023
0.22.0 334 10/2/2023
0.22.0-rc.33 90 10/2/2023
0.21.0 298 10/2/2023
0.21.0-rc.31 101 10/2/2023
0.21.0-rc.30 97 9/28/2023
0.20.0-rc.29 929 9/6/2023
0.20.0-rc.28 87 9/6/2023
0.19.0 697 8/3/2023
0.18.0 555 2/5/2023
0.17.0 395 2/2/2023
0.16.0 367 1/30/2023
0.15.0 400 1/29/2023
0.14.0 391 1/21/2023
0.13.0 416 1/20/2023
0.12.0 424 1/20/2023
0.11.0 409 1/18/2023
0.10.0 415 1/18/2023
0.9.0 415 1/17/2023
0.8.0 385 1/17/2023
0.7.0 378 1/17/2023
0.6.0 393 1/15/2023
0.5.1 394 1/15/2023
0.5.0 415 1/15/2023
0.4.0 430 1/15/2023
0.3.0 458 1/15/2023
0.2.0 439 1/15/2023
0.1.0 505 1/15/2023