Lage.AutoBuilder 1.1.0

Lage.AutoBuilder

🔧 基于 Roslyn 增量源生成器（IIncrementalGenerator）的编译期 Builder 模式自动代码生成器。

只需一个 [Buildable] 特性，自动为你的类生成 Builder 类，告别手写繁琐的建造者代码。

✨ 特性

📦 安装

dotnet add package Lage.AutoBuilder

编译要求：.NET 6.0 SDK 及以上 | 生成的代码兼容 .NET 5.0+ 运行时

🚀 快速开始

1. 标记类 + 属性

using Lage.AutoBuilder.Core.Attributes;

[Buildable]
public partial class Person
{
    public string Name { get; set; } = null!;
    public string Password { get; set; } = null!;

    [BuildIgnore]                      // 该属性不出现在 Builder 中
    public string InternalId { get; set; } = null!;

    public int Age { get; set; }
    public string? Email { get; set; }
}

2. 使用生成的 Builder

var person = Person.CreateBuilder()
    .WithName("张三")
    .WithPassword("abc123456")
    .WithAge(28)
    .WithEmail("zhangsan@example.com")
    .Build();

3. 静态工厂方法 [BuildMethod]

[Buildable]
public partial class Order
{
    public string Id { get; }
    public decimal Amount { get; }
    public DateTime CreatedAt { get; }

    private Order(string id, decimal amount, DateTime createdAt)
    {
        Id = id;
        Amount = amount;
        CreatedAt = createdAt;
    }

    [BuildMethod]
    public static Order Create(string id, decimal amount, DateTime createdAt)
        => new(id, amount, createdAt);
}

// 生成：
var order = Order.CreateBuilder()
    .WithId("ORD-001")
    .WithAmount(99.99m)
    .WithCreatedAt(DateTime.Now)
    .Build();

🏗️ 项目结构

Lage.AutoBuilder/
├── src/
│   ├── Lage.AutoBuilder.Core/         # 特性定义（netstandard2.0）
│   │   └── Attributes/
│   │       ├── BuildableAttribute.cs
│   │       ├── BuildIgnoreAttribute.cs
│   │       └── BuildMethodAttribute.cs
│   ├── Lage.AutoBuilder.Generator/    # 源生成器（netstandard2.0）
│   │   ├── Generator.cs               # IIncrementalGenerator 入口
│   │   ├── ClassInfo.cs               # 数据模型
│   │   ├── PropertyInfo.cs            # 属性元数据
│   │   ├── MethodInfo.cs              # 工厂方法元数据
│   │   ├── ValidationInfo.cs          # 验证规则 + Collector（预留）
│   │   ├── StringBuilderExtensions.cs # 缩进统一管理
│   │   └── IsExternalInit.cs          # netstandard2.0 polyfill
│   └── Lage.AutoBuilder/              # NuGet 打包项目
├── test/
│   └── ConsoleTest/                   # 集成测试
└── README.md

🔧 技术栈

• Roslyn Source Generators (IIncrementalGenerator)
• netstandard2.0 → 兼容 .NET 6.0 / 7.0 / 8.0 / 9.0 / 10.0
• 编译期零反射、零运行时开销
• ForAttributeWithMetadataName 增量管线

📝 更新日志

v1.1.0

• ✅ CreateBuilder() 入口（替代 new XxxBuilder()）
• ✅ [BuildIgnore] 跳过属性
• ✅ [BuildMethod] 工厂方法模式
• ✅ 全量 global:: 命名空间 + 作用域一致
• ✅ ValidationInfo.Collector 流式 API

v1.0.0

• ✅ [Buildable] 属性复制模式

📄 License

MIT © LageYang