NetActive.CleanArchitecture.Template 6.0.7

NetActive.CleanArchitecture

NetActive.CleanArchitecture is a set of libraries supporting Clean Architecture development in .NET (6+).

Source code and examples can be found on GitHub. The NuGet packages, including debug symbols, can be found on NuGet.

Inspired by the video series Clean Architecture: Patterns, Practices and Principles on PluralSight by Matthew Renze, I started creating these libraries around the idea of Clean Architecture a few years ago.

The open source community has given me so much over the past decade, I decided it was time to give something back. Since I find them very practicle and I recently ported them to .NET 6 and Entity Framework Core 6, I felt it was the right time to share these Clean Architecture libraries with the rest of the world.

Focus is on simplifying implementation of and support for these Clean Architecture patterns and practices in new .NET projects. These libraries have already been under active development for a few years and applied in real life production applications many times.

Please check them out and feel free to share your thoughts and ideas by contacting me or submitting a pull request.

Besides the source code you'll also find practicle examples on how to use these libraries in Console applications, Web applications or API's. Here's a quick example (from the Example.Console.CommandAdd example project) of what your application code could look like:

using Autofac;
using Example.Application.Manufacturer.Commands.AddManufacturer;
using Example.Application.Manufacturer.Commands.AddManufacturer.Models;
using MediatR;

// Build single-instance DI container.
var builder = new ContainerBuilder();
Example.Shared.AutofacConfig.RegisterComponents(builder, singleInstance: true);
var container = builder.Build();

using (var scope = container.BeginLifetimeScope())
{
    // Create manufacturer model.
    var manufacturerName = $"My Manufacturer ({DateTime.Now:yyyyMMddHHmmsssmmm})";
    var manufacturerToAdd = new AddManufacturerCommandModel(manufacturerName)
        {
            Contact =
                {
                    FamilyName = "Brink",
                    GivenName = "Raymond" // Optional
                }
        };

    // Execute add manufacturer command.
    var command = new AddManufacturerCommand(manufacturerToAdd);
    var result = await scope.Resolve<ISender>().Send(command);

    Console.WriteLine($"Added: {result}: {manufacturerToAdd.ManufacturerName}");
    Console.WriteLine();
}

Under the hood these libraries try to apply the following principles and patterns:

• Clean Code
• Don't Repeat Yourself
• SOLID:
  • Single Responsibility Principle
  • Open-Closed Principle
  • Liskov Substitution Principle
  • Interface Segregation Principle
  • Dependency Inversion Principle
• Command and Query Responsibility Segregation (CQRS)
• Facade Pattern
• Factory Method Pattern
• Repository and Unit of Work Patterns

If you're a programmer and you haven't heared of these yet, please check out Uncle Bob Martin and Martin Fowler. You might learn a thing or two 😉

Also check out these projects as they are priceless and essential for these libraries to shine:

• Autofac
• AutoMapper
• Entity Framework Core
• FluentValidation
• LINQKit
• MediatR

Happy coding!