🎯 Atc Source Generators

A collection of Roslyn C# source generators for .NET that eliminate boilerplate code and improve developer productivity. All generators are designed with Native AOT compatibility in focus, enabling faster startup times, smaller deployment sizes, and optimal performance for modern cloud-native applications.

Why Choose Atc Source Generators?

• 🎯 Zero boilerplate - Attribute-based approach eliminates repetitive code
• ⚡ Compile-time generation - Catch errors during build, not at runtime
• 🚀 Native AOT ready - Zero reflection, fully trimming-safe for modern .NET
• 🧩 Multi-project architecture - Smart naming for clean layered applications
• 🛡️ Type-safe - Full IntelliSense and compile-time validation
• 📦 Single package - Install once, use all generators

🚀 Source Generators

Generator	Attribute	What It Does
⚡ DependencyRegistration	[Registration]	Automatic DI service registration with auto-detection, keyed services, factories, decorators
⚙️ OptionsBinding	[OptionsBinding]	Configuration binding with validation, change callbacks, named options
🗺️ ObjectMapping	[MapTo(typeof(T))]	Object-to-object mapping with bidirectional, nested, and collection support
🔄 EnumMapping	[MapTo(typeof(T))]	Enum-to-enum mapping with special case detection (None ↔ Unknown)
📋 AnnotationConstants	(automatic)	Compile-time access to DataAnnotation metadata without reflection

✨ See It In Action

All generators work together seamlessly in a typical 3-layer architecture:

// 1️⃣ Domain Layer - Your business logic
[MapTo(typeof(PetStatusDto), Bidirectional = true)]
public enum PetStatus { Available, Adopted }

[MapTo(typeof(PetDto))]
public partial class Pet
{
    public Guid Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public PetStatus Status { get; set; }
}

[Registration(Lifetime.Scoped)]
public class PetService : IPetService
{
    public async Task<Pet> GetPetAsync(Guid id) { /* ... */ }
}

[OptionsBinding("PetStore")]
public partial class PetStoreOptions
{
    [Required] public int MaxPetsPerPage { get; set; }
}

// 2️⃣ Program.cs - One line per concern
using Atc.DependencyInjection;
using Atc.Mapping;

builder.Services.AddDependencyRegistrationsFromDomain();
builder.Services.AddOptionsFromDomain(builder.Configuration);

// 3️⃣ Usage - Clean and type-safe
app.MapGet("/pets/{id}", async (Guid id, IPetService service) =>
{
    var pet = await service.GetPetAsync(id);
    return Results.Ok(pet.MapToPetDto());  // ✨ Generated mapping
});

Result: Zero boilerplate, full type safety, Native AOT ready! 🚀

📦 Installation

dotnet add package Atc.SourceGenerators

Optional (recommended for better IntelliSense):

dotnet add package Atc.SourceGenerators.Annotations

⚙️ Requirements

• .NET 10 SDK required at build time (Roslyn 5.0.0)
• Projects can still target .NET 9, .NET 8, or earlier
• This is a build-time requirement only, not a runtime requirement

📖 Documentation

Full documentation is available in the Wiki:

Page	Description
Getting Started	Installation, packages, and SDK requirements
Dependency Registration	Automatic DI with [Registration] — auto-detection, keyed services, factories, decorators, transitive registration
Options Binding	Configuration binding with [OptionsBinding] — validation, change callbacks, named options, child sections
Object Mapping	Object mapping with [MapTo] — bidirectional, nested objects, collections, projections, property strategies
Enum Mapping	Enum mapping with [MapTo] — special case detection, bidirectional, case-insensitive
Annotation Constants	Compile-time DataAnnotation metadata — zero reflection, Blazor-ready, Native AOT
Sample Projects	Working code examples for each generator
PetStore API Example	Full application using all generators with OpenAPI/Scalar

🔨 Building

dotnet build

🧪 Testing

dotnet test

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

[License information here]