DotEmilu 1.0.0

DotEmilu

A simple, easy-to-use .NET library designed for handling HTTP requests and responses.

Features

• Supports GET, POST, PUT, and DELETE requests.
• Handles HTTP responses with status codes and error handling.
• Built with .NET 8 for cross-platform compatibility (Windows, Linux, macOS).
• Supports async/await for non-blocking HTTP calls.

How to Use

Build your logic from your previously created request and expected response

public class SampleUseCase(IVerifier<SampleRequest> verifier, IPresenter presenter)
    : Handler<SampleRequest, SampleResponse>(verifier, presenter)
{
    private readonly IPresenter _presenter = presenter;
    private readonly IVerifier<SampleRequest> _verifier = verifier;

    protected override async Task<SampleResponse?> HandleResponseAsync(SampleRequest request,
        CancellationToken cancellationToken = default)
    {
        var result = await SomeMethod(request, cancellationToken);

        // Add custom validations
        if (string.IsNullOrEmpty(request.Note))
        {
            _verifier.AddError("request", "invalid request");
            return null;
        }

        // To custom response you can use Results
        if (request.Date.Year == 2024)
            return ResultIn(Results.Ok($"Congratulations! {result}"));

        // Or standard response defined in IPresenter
        if (request.Category >= 10)
            return ResultIn(_presenter.Success($"{result}. Account: {request.Account}. Category: {request.Category}"));

        // By default you need return the TResponse
        return new SampleResponse(result);
    }

    private async Task<string> SomeMethod(SampleRequest request, CancellationToken cancellationToken = default)
    {
        // Some logic
    }
}

Then add your endpoint using minimal api or controller.

app.MapPost("/api/sample", async ([FromBody] SampleRequest request,
    IHandler<SampleRequest> handler,
    CancellationToken cancellationToken) => await handler.HandleAsync(request, cancellationToken));

Finally register your dependencies

builder.Services
    .AddDotEmilu()
    .AddScoped<IHandler<SampleRequest>, SampleUseCase>()
    .AddValidatorsFromAssembly(Assembly.GetExecutingAssembly());

For a complete example

Notes:

You need to add the response messages for bad request (400) and server error (500)

{
  "ResultMessage": {
    "ValidationError": {
      "Title": "Bad Request",
      "Detail": "One or more errors"
    },
    "ServerError": {
      "Title": "Server Error",
      "Detail": "Please contact to administrator"
    }
  }
}

And for complex validation use fluent validation

public class SampleValidator : AbstractValidator<SampleRequest>
{
    public SampleValidator()
    {
        RuleFor(s => s.Date)
            .GreaterThanOrEqualTo(DateOnly.FromDateTime(DateTime.Now));

        RuleFor(s => s.Amount)
            .GreaterThan(0);
    }
}