A library of reusable types for implementing Clean Architecture in .NET and ASP.NET Core applications, based heavily on the work of Steve Smith in the following open-source projects:
For the core functionality, only the F23.Kernel library is needed. This library provides types for events, results, query and command handlers, validation, and messaging. For smoother integration with ASP.NET Core, the F23.Kernel.AspNetCore library can be used for easily mapping between core result types and ASP.NET Core IActionResult and model state.
WARNING: This library is currently in a pre-release state, and breaking changes may occur before reaching version 1.0.
What if your day job was contributing to open-source projects and custom AI solutions — and you got paid for it?
We're hiring remote engineers to contribute to cutting-edge AI and custom software projects. 100% remote, 100% real impact. https://www.feature23.com/careers
dotnet add package F23.Kernel
dotnet add package F23.Kernel.AspNetCore
class GetWeatherForecastQueryResult { public required IReadOnlyList<WeatherForecast> Forecast { get; init; } } class GetWeatherForecastQuery : IQuery<GetWeatherForecastQueryResult> { public int DaysIntoTheFuture { get; init; } = 5; } record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary) { public int TemperatureF => 32 + (int)(TemperatureC / 0.5556); } class GetWeatherForecastQueryHandler(IValidator<GetWeatherForecastQuery> validator, IWeatherForecastRepository repository) : IQueryHandler<GetWeatherForecastQuery, GetWeatherForecastQueryResult> { public async Task<Result<GetWeatherForecastQueryResult>> Handle(GetWeatherForecastQuery query, CancellationToken cancellationToken = default) { if (await validator.Validate(query, cancellationToken) is ValidationFailedResult failed) { return Result<GetWeatherForecastQueryResult>.ValidationFailed(failed.Errors); } var forecast = await repository.GetForecast(query.DaysIntoTheFuture, cancellationToken); var result = new GetWeatherForecastQueryResult { Forecast = forecast }; return Result<GetWeatherForecastQueryResult>.Success(result); } }
builder.Services.RegisterQueryHandler<GetWeatherForecastQuery, GetWeatherForecastQueryResult, GetWeatherForecastQueryHandler>(); // Other code omitted for brevity app.MapGet("/weatherforecast", async (IQueryHandler<GetWeatherForecastQuery, GetWeatherForecastQueryResult> queryHandler) => { var result = await queryHandler.Handle(new GetWeatherForecastQuery()); return result.ToMinimalApiResult(); }) .WithName("GetWeatherForecast") .WithOpenApi();
TODO
TODO