Tagada.Swagger 0.1.0-alpha

Tagada

Be careful, this library is not production-ready yet.

Tagada is a lightweight functional framework to create a .NET Core Web API without effort. And of course it tastes good.

For those who dream to make an ASP.NET Core Web API in one line of code

Features

• Add routes based on HTTP methods GET, POST, PUT, DELETE
• Add routes based on generic input and output <TQuery>, <TQuery, TResult>, <TCommand>, <TCommand, TResult>
• Execute code AfterEach() or AfterEach<T>()
• Add swagger documentation

Get started

A simple Hello World

public void ConfigureServices(IServiceCollection services)
{
    services.AddRouting();
}

public void Configure(IApplicationBuilder app)
{
    app.Map("/api")
        .Get("/hello", () => "Hello world!")
        .Use();
}

Add Swagger documentation

public void ConfigureServices(IServiceCollection services)
{
    services.AddRouting();

    services.AddSwaggerGen(c =>
    {
        c.GenerateTagadaSwaggerDoc();
    });
}

public void Configure(IApplicationBuilder app)
{
    app.Map("/api")
        .Get("/hello", () => "Hello world!")
        .AddSwagger()
        .Use();
}

CQRS-ready

public void ConfigureServices(IServiceCollection services)
{
    services.AddRouting();
}

public void Configure(IApplicationBuilder app)
{
    app.Map("/api")
        .Get<GetContactsQuery>("/contacts", GetContacts)
        .Get<GetContactByIdQuery>("/contacts/{id}", GetContactById)
        .Post<CreateContactCommand>("/contacts", CreateContact)
        .Use();
}

public class GetContactsQuery { }

public class GetContactByIdQuery
{
    public int Id { get; set; }
}

public class CreateContactCommand
{
    public string Name { get; set; }
}

Storing Events in a single line of code

public void ConfigureServices(IServiceCollection services)
{
    services.AddRouting();
}

public void Configure(IApplicationBuilder app)
{
    app.Map("/api")
        .Get<GetContactsQuery>("/contacts", GetContacts)
        .Get<GetContactByIdQuery>("/contacts/{id}", GetContactById)
        .Post<CreateContactCommand>("/contacts", CreateContact)
        .AfterEach(route => Events.Add(route))
        .Use();
}

Roadmap

Short term

• Fully featured HTTP methods
• Fully featured Swagger generation
• Cache Reflection methods (on TQuery, TCommand and TResult)
• Benchmark Tagada VS traditional approach

Long term

• Offer a way to detect API endpoints for frontend developers
• Add Realtime methods On(), OnConnect(), OnDisconnect() and OnReconnect() (if possible)
• Add Reactive / Observable methods (if possible)