Sisk.HttpServer 0.3.0

X-Powered-By: Sisk

Sisk is a powerful micro-framework for building powerful Restful web APIs. It was written using .NET 6 and Microsoft-HTTPAPI/2.0 as their HTTP Engines. Currently, this micro-framework is suitable for building restful APIs, in a structured and object-oriented way. There is no native support for frontend rendering, templates or database connection. You can extend it as you see fit.

Features

• Lightning fast response/second average;
• A routing system, supporting handlers ("Middlewares"), names, parameters and contexts;
• Easy CORS integration;
• Request and response handlers and helpers;
• Multiplatform (credits to .NET 6).

Note: this micro-framework only works for HTTP and not HTTPS. To use it over TLS/HTTPS, use a reverse proxy.

Documentation

Documentation for Sisk aren't ready yet. Use this readme for now.

Installation

Nuget package ins't published yet. Come back soon or you can build it from source.

Example

using Sisk;

internal class Program
{
    static void Main(string[] args)
    {
        Router router = new ();
        router.SetRoute(RouteMethod.Get, "/", (req) =>
        {
            return HttpResponse.CreateOK("Hello, world!");
        });

        HttpServer server = new (router)
        {
            ListeningPort = 5555,
            Verbose = true
        };

        Console.WriteLine("Sisk is listening on HTTP localhost:{0}", server.ListeningPort);
        server.Start();

        while(true) { }
    }
}

Benchmark

Used tool: https://github.com/grafana/k6

> cat .\test.js
import http from "k6/http";

export default function () {
    let response = http.get("http://localhost:5555/");
};

> k6 run .\test.js --vus 512 --duration 10s

data_received..................: 57 MB  5.7 MB/s
data_sent......................: 26 MB  2.6 MB/s
http_req_blocked...............: avg=21.15µs min=0s med=0s      max=55.39ms  p(90)=0s      p(95)=0s
http_req_connecting............: avg=18.5µs  min=0s med=0s      max=22.1ms   p(90)=0s      p(95)=0s
http_req_duration..............: avg=15.58ms min=0s med=14.26ms max=171.71ms p(90)=22.28ms p(95)=26.78ms
{ expected_response:true }...: avg=15.58ms min=0s med=14.26ms max=171.71ms p(90)=22.28ms p(95)=26.78ms
http_req_failed................: 0.00%  ✓ 0            ✗ 325652
http_req_receiving.............: avg=40.33µs min=0s med=0s      max=65.37ms  p(90)=0s      p(95)=0s
http_req_sending...............: avg=14.27µs min=0s med=0s      max=51.2ms   p(90)=0s      p(95)=0s
http_req_tls_handshaking.......: avg=0s      min=0s med=0s      max=0s       p(90)=0s      p(95)=0s
http_req_waiting...............: avg=15.52ms min=0s med=14.23ms max=168.2ms  p(90)=22.2ms  p(95)=26.65ms
http_reqs......................: 325652 32515.685439/s
iteration_duration.............: avg=15.69ms min=0s med=14.32ms max=185.77ms p(90)=22.46ms p(95)=27.11ms
iterations.....................: 325652 32515.685439/s
vus............................: 512    min=512        max=512
vus_max........................: 512    min=512        max=512