Unions.Pure.Csharp
1.0.8
See the version list below for details.
dotnet add package Unions.Pure.Csharp --version 1.0.8
NuGet\Install-Package Unions.Pure.Csharp -Version 1.0.8
<PackageReference Include="Unions.Pure.Csharp" Version="1.0.8" />
<PackageVersion Include="Unions.Pure.Csharp" Version="1.0.8" />
<PackageReference Include="Unions.Pure.Csharp" />
paket add Unions.Pure.Csharp --version 1.0.8
#r "nuget: Unions.Pure.Csharp, 1.0.8"
#:package Unions.Pure.Csharp@1.0.8
#addin nuget:?package=Unions.Pure.Csharp&version=1.0.8
#tool nuget:?package=Unions.Pure.Csharp&version=1.0.8
C# Pure Unions
Roslyn source generator for minimal-overhead discriminated unions. Add [UnionMember] attributes to a partial type and the generator emits a compact tag enum, factory helpers, and Match/Switch helpers without extra allocations.
Getting started
- Install the package in your project:
dotnet add package Unions.Pure.Csharp
- Annotate a partial type with the union members you need:
using Unions.Pure.Csharp;
namespace Sample;
[UnionMember(typeof(string))]
[UnionMember(typeof(int))]
[UnionGenerator(GenerateTarget.Visitor | GenerateTarget.TryOut)]
public partial record struct PaymentStatus;
- Use the generated factories and helpers:
var paid = PaymentStatus.FromInt32(200);
var message = paid.Match(
onString: s => $"Message: {s}",
onInt32: code => $"Code: {code}");
[UnionMember] is injected by the generator; no manual reference is required beyond the package itself.
API choices (performance vs ergonomics)
Generated unions expose three ways to consume values:
GenerateTarget.IndirectLambdas: delegate-basedMatch/Switch(Func<>/Action<>)- Pros: nicest call site; familiar functional style.
- Cons: still does delegate
Invoke(typically an indirect call); capturing lambdas allocate (closures/delegates).
GenerateTarget.Visitor: visitor-basedMatch<TVisitor, TResult>/Switch<TVisitor>(genericstructvisitors)- Pros: avoids delegate
Invoke; JIT can inline; no allocations. - Cons: requires a small
structvisitor type (can be local/private).
- Pros: avoids delegate
GenerateTarget.TryOut: inlineIsX()/TryGetX(out ...)- Pros: “plain C#”
if/else; no delegates; no visitors; no indirect calls. - Cons: more boilerplate at call site vs
Match.
- Pros: “plain C#”
Note on OneOf (comparison)
OneOf is a solid library, but for hot paths it has the same core drawback as any delegate-based API: Match/Switch ultimately invoke delegates (indirect calls), and capturing lambdas allocate. It also needs to handle invalid state (cold path that throws).
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- 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 |
|---|---|---|
| 2.0.12 | 5,234 | 6/18/2026 |
| 2.0.11 | 168 | 6/18/2026 |
| 2.0.10 | 318 | 5/15/2026 |
| 2.0.9 | 124 | 5/15/2026 |
| 2.0.8 | 127 | 5/15/2026 |
| 2.0.7 | 126 | 5/15/2026 |
| 2.0.6 | 139 | 5/15/2026 |
| 2.0.5 | 149 | 2/18/2026 |
| 2.0.4 | 133 | 2/18/2026 |
| 2.0.3 | 2,628 | 1/15/2026 |
| 2.0.2 | 338 | 12/18/2025 |
| 2.0.1 | 315 | 12/18/2025 |
| 2.0.0 | 752 | 12/15/2025 |
| 1.1.0 | 296 | 12/15/2025 |
| 1.0.10 | 271 | 12/15/2025 |
| 1.0.8 | 259 | 12/14/2025 |
| 1.0.7 | 252 | 12/14/2025 |
| 1.0.6 | 261 | 12/14/2025 |
| 1.0.5 | 259 | 12/14/2025 |
| 1.0.4 | 256 | 12/14/2025 |