Up and running in five minutes.

Define a module

A module is a class that registers routes against the framework’s route builder. Implement IArgusModule, map a verb + path to a handler, and you’re done:

using System.Threading.Tasks;
using ArgusTransfer.Protocol;
using ArgusTransfer.Routing;

public class HelloModule : IArgusModule
{
    public void AddRoutes(IArgusRouteBuilder app)
    {
        app.MapGet("/hello", context =>
        {
            context.Response = new ArgusResponse
            {
                StatusCode = ArgusStatusCode.Ok,
                Body       = "Hello from ArgusTransfer!"
            };
            return Task.CompletedTask;
        });
    }
}

Host the pipe

Wire everything up in Program.cs. AddArgusModules() discovers your HelloModule automatically, AddArgusPipeHost opens the named pipe, and AddArgusClient registers a client for the same pipe so you can call yourself for the demo:

using ArgusTransfer.Extensions;
using ArgusTransfer.Routing;

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddArgusModules();
        services.AddArgusPipeHost(o => o.PipeName = "demo");
        services.AddArgusClient("demo");
        services.AddHostedService<DemoClientService>();
    })
    .Build()
    .Run();

Call from a client

The client uses verb-named methods that mirror the module side — GetAsync, PostAsync, PutAsync, etc. — and gives you back a typed ArgusResponse:

using ArgusTransfer.Client;
using Microsoft.Extensions.Hosting;

public class DemoClientService : BackgroundService
{
    private readonly IArgusClient client;
    private readonly IHostApplicationLifetime lifetime;

    public DemoClientService(IArgusClient client, IHostApplicationLifetime lifetime)
    {
        this.client   = client;
        this.lifetime = lifetime;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        await Task.Delay(1000, stoppingToken);

        var response = await this.client.GetAsync("/hello", cancellationToken: stoppingToken);

        Console.WriteLine($"Status: {(int)response.StatusCode} {response.StatusCode}");
        Console.WriteLine($"Body:   {response.Body}");

        this.lifetime.StopApplication();
    }
}

Run it with dotnet run:

Status: 200 Ok
Body:   Hello from ArgusTransfer!