MinimalApiBuilder 4.0.0

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package MinimalApiBuilder --version 4.0.0
NuGet\Install-Package MinimalApiBuilder -Version 4.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MinimalApiBuilder" Version="4.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MinimalApiBuilder --version 4.0.0
#r "nuget: MinimalApiBuilder, 4.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MinimalApiBuilder as a Cake Addin
#addin nuget:?package=MinimalApiBuilder&version=4.0.0

// Install MinimalApiBuilder as a Cake Tool
#tool nuget:?package=MinimalApiBuilder&version=4.0.0

MinimalApiBuilder

nuget

Reflectionless, source-generated, thin abstraction layer over the ASP.NET Core Minimal APIs interface.

How to Use

Based on the Vertical Slice Architecture with Feature folder. There is one class for every API endpoint. A basic example looks like the following:

using Microsoft.AspNetCore.Mvc;
using MinimalApiBuilder;

public partial class BasicEndpoint : MinimalApiBuilderEndpoint
{
    private static string Handle([FromServices] BasicEndpoint endpoint)
    {
        return "Hello, World!";
    }
}

The endpoint class must be partial, inherit from MinimalApiBuilderEndpoint, and have a static Handle or HandleAsync method with the containing type passed from dependency injection. The endpoint is mapped through the typical IEndpointRouteBuilder Map<Verb> extension methods:

app.MapGet<BasicEndpoint>("/hello");

The above is functionally equivalent to:

app.MapGet("/hello", static () => "Hello, World!");

This library depends on FluentValidation >= 11. An endpoint can have a validated request object:

public struct BasicRequest
{
    public required string Name { get; init; }
}

public partial class BasicRequestEndpoint : MinimalApiBuilderEndpoint
{
    private static string Handle([FromServices] BasicRequestEndpoint endpoint,
        [AsParameters] BasicRequest request)
    {
        return $"Hello, {request.Name}!";
    }
}

public class BasicRequestValidator : AbstractValidator<BasicRequest>
{
    public BasicRequestValidator()
    {
        RuleFor(static request => request.Name).MinimumLength(2);
    }
}
app.MapGet<BasicRequestEndpoint>("/hello/{name}");

The incremental generator will generate code to validate the request object before the handler is called and return a 400 Bad Request response if the validation fails. In Program.cs the below

builder.Services.AddMinimalApiBuilderEndpoints();

needs to be added to register the necessary types with dependency injection.

Configuration

Users can add configuration through entries in .editorconfig or with MSBuild properties. The following options are available:

minimalapibuilder_assign_name_to_endpoint (true | false)

If true, the generator will add a unique public const string Name field to the endpoint classes and call the WithName extension method when mapping them.

minimalapibuilder_assign_name_to_endpoint = true
<PropertyGroup>
  <minimalapibuilder_assign_name_to_endpoint>true</minimalapibuilder_assign_name_to_endpoint>
</PropertyGroup>
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.0.0-beta.10 82 1/25/2024
5.0.0-beta.9 51 1/22/2024
5.0.0-beta.8 90 1/3/2024
5.0.0-beta.7 79 12/29/2023
5.0.0-beta.6 63 12/18/2023
5.0.0-beta.5 75 12/15/2023
5.0.0-beta.4 90 11/27/2023
5.0.0-beta.3 80 11/23/2023
5.0.0-beta.2 60 11/23/2023
5.0.0-beta.1 94 11/21/2023
4.0.0 214 11/12/2023
3.1.0 92 11/8/2023
3.0.1 86 11/6/2023
3.0.0 173 11/6/2023
2.0.0 114 10/30/2023
1.4.0 106 10/27/2023
1.3.3 250 5/11/2023
1.3.2 120 5/8/2023
1.3.1 117 5/8/2023
1.3.0 117 5/8/2023
1.2.0 124 5/6/2023
1.1.0 128 5/1/2023
1.0.1 311 2/10/2023
1.0.0 329 1/5/2023
0.1.0-beta.12 95 1/5/2023
0.1.0-beta.11 88 1/5/2023
0.1.0-beta.10 83 1/5/2023
0.1.0-beta.9 96 1/5/2023
0.1.0-beta.8 103 1/5/2023
0.1.0-beta.7 93 1/4/2023
0.1.0-beta.6 95 1/4/2023
0.1.0-beta.5 87 1/4/2023
0.1.0-beta.4 92 1/4/2023
0.1.0-beta.3 91 1/4/2023
0.1.0-beta.2 93 12/31/2022
0.1.0-beta.1 96 12/30/2022