Projects
See also this blog: mstack.nl - source-generators.
CSharp.SourceGenerators.Extensions
See this page.
FluentBuilder
A project which uses Source Generation to create a FluentBuilder for a specified model or DTO.
This project is based on Tom Phan : "auto-generate-builders-using-source-generator-in-net-5".
Install
You can install from NuGet using the following command in the package manager window:
Install-Package FluentBuilder
Or via the Visual Studio NuGet package manager or if you use the dotnet
command:
dotnet add package FluentBuilder
Usage
Annotate
Annotate a class with [FluentBuilder.AutoGenerateBuilder]
to indicate that a FluentBuilder should be generated for this class:
[FluentBuilder.AutoGenerateBuilder]
public class User
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Date { get; set; }
}
Use FluentBuilder
using System;
namespace Test
{
class Program
{
static void Main(string[] args)
{
var user = new FluentBuilder.UserBuilder()
.WithFirstName("Test")
.WithLastName("User")
.Build();
Console.WriteLine($"{user.FirstName} {user.LastName}");
}
}
}
Use FluentBuilder when the class has a default constructor
[FluentBuilder.AutoGenerateBuilder]
public class User
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Date { get; set; }
public User()
{
FirstName = "test";
}
}
using System;
namespace Test
{
class Program
{
static void Main(string[] args)
{
var user = new FluentBuilder.UserBuilder()
.WithLastName("User")
.Build(false); // β Provide `false` for `useObjectInitializer` here.
Console.WriteLine($"{user.FirstName} {user.LastName}");
}
}
}
Array
or IEnumerable<T>
property
Using FluentBuilder when a class has an [FluentBuilder.AutoGenerateBuilder]
public class UserDto
{
public IEnumerable<EmailDto> SecondaryEmails { get; set; }
public int[] IntArray { get; set; }
}
var user = new FluentBuilder.UserDtoBuilder()
.WithIntArray(ib => ib // π Use a Integer Array Builder
.Add(1) // Add a normal integer
.Add(() => 2) // Add an integer with a Func<>
.Build()
)
.WithSecondaryEmails(sb => sb // π Use a EmailDto IEnumerable Builder
.Add(new EmailDto()) // Add a normal EmailDto using new() constructor
.Add(() => new EmailDto()) // Add an EmailDto using Func<>
.Add(eb => eb // π Use a EmailDto IEnumerable Builder to add an EmailDto
.WithPrimary(true)
.Build()
)
.Build()
)
.Build();
IDictionary<TKey, TValue>
property
Using FluentBuilder when a class has an [FluentBuilder.AutoGenerateBuilder]
public class UserDto
{
public IDictionary<string, int> Tags { get; set; }
}
var user = new FluentBuilder.UserDtoBuilder()
.WithTags(db => db // π Use a Dictionary<TKey, TValue> Builder
.Add("test", 123) // Add a key with value
.Add(() => new KeyValuePair<string, int>("x", 42)) // Add a KeyValuePair with a Func<>
.Build()
)
.Build();