DecoWeaver 1.0.0-beta.4

DecoWeaver

Compile-time decorator registration for .NET dependency injection

DecoWeaver is a .NET incremental source generator that brings compile-time decorator registration to your dependency injection setup. Using C# 11+ interceptors, it automatically wraps your service implementations with decorators at build time—eliminating runtime reflection, assembly scanning, and manual factory wiring.

Why DecoWeaver?

• ⚡ Zero runtime overhead - No reflection or assembly scanning at startup
• 🎯 Type-safe - Catches configuration errors at compile time
• 🚀 Fast - Incremental generation with Roslyn
• 🔧 Simple - Just add [DecoratedBy<T>] attributes
• 📦 Clean - Generates readable, debuggable interceptor code

📚 View Full Documentation

Installation

Install the NuGet package:

dotnet add package DecoWeaver --prerelease

Ensure your project uses C# 11 or later:

<PropertyGroup>
  <LangVersion>11</LangVersion>
  
</PropertyGroup>

Quick Start

1. Mark your implementation with the decorator to apply

using DecoWeaver.Attributes;

[DecoratedBy<LoggingRepository>]
public class UserRepository : IUserRepository
{
    // Your implementation
}

2. Register your service normally

services.AddScoped<IUserRepository, UserRepository>();

3. That's it!

At compile time, DecoWeaver automatically generates interceptor code that wraps UserRepository with LoggingRepository. When you resolve IUserRepository, you'll get the decorated instance.

LoggingRepository
  └─ UserRepository

For more examples including open generics, multiple decorators, and ordering, see the Quick Start Guide.

Key Features

• Multiple Decorators: Stack multiple decorators with explicit ordering
• Open Generic Support: Works with IRepository<T>, ICommand<T>, etc.
• Type-Safe: Compile-time validation catches errors early
• Zero Configuration: No runtime registration or setup needed
• Debuggable: Generated code is readable and inspectable

Learn more in the Core Concepts documentation.

Requirements

• C# 11+ (for interceptors support)
• .NET 8.0+ (for keyed services)
• .NET SDK 8.0.400+ (Visual Studio 2022 17.11+)

See the Requirements page for full details.

Documentation

📖 Full Documentation - Comprehensive guides and API reference

Key sections:

• Installation - Get started with DecoWeaver
• Quick Start - Your first decorator in 5 minutes
• Core Concepts - Understand how it works
• Usage Guide - Detailed usage patterns
• Examples - Real-world scenarios

Contributing

Contributions are welcome! See our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ⚡ by the LayeredCraft team