as-http3lib

as-http3lib

An HTTP/1.1 + HTTP/2 + HTTP/3 server library written in pure Go.

Note: The previous version of this lib was written in C++, but has since been rewritten in Golang

Support

1. Currently supports only HTTP/3 traffic
2. Self-signed TLS Certificates
3. All HTTP responses, JSONResponses, Streaming responses

See detailed steps on running in /notes/HOW-TO-RUN.md

See the pipeline of changes in /notes/TODO.md

Installation

Import the Go package in your service using

go mod add github.com/ayushanand18/as-http3lib

Get started with examples in /examples

This project uses quic-go.

Performance

Some stats:

• Minimal version 153x (153 times) faster on startup time than FastAPI based server (equal endpoints and configs).

Benchmarks

During the development of this project, we ran a few benchmarks to evaluate the performance of this library against a few popular libraries. The results are illustrated in the table below.

Machine Information

Boost: v1.84.0

g++: g++ (Ubuntu 9.4.0-1ubuntu1~20.04.2) 9.4.0
Copyright (C) 2019 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

compilation flags: --std=c++2a -Wall -Wextra -pedantic -lboost_system -pthread

make: GNU Make 4.2.1
Built for x86_64-pc-linux-gnu
Copyright (C) 1988-2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Architecture:                       x86_64
CPU op-mode(s):                     32-bit, 64-bit
Byte Order:                         Little Endian
Address sizes:                      48 bits physical, 48 bits virtual
CPU(s):                             2
On-line CPU(s) list:                0,1
Thread(s) per core:                 2
Core(s) per socket:                 1
Socket(s):                          1
NUMA node(s):                       1
Vendor ID:                          AuthenticAMD
CPU family:                         25
Model:                              1
Model name:                         AMD EPYC 7763 64-Core Processor
Stepping:                           1
CPU MHz:                            3239.193
BogoMIPS:                           4890.86
Virtualization:                     AMD-V
Hypervisor vendor:                  Microsoft
Virtualization type:                full
L1d cache:                          32 KiB
L1i cache:                          32 KiB
L2 cache:                           512 KiB
L3 cache:                           32 MiB
NUMA node0 CPU(s):                  0,1

Results

Tested by using time on Linux. These times are an average of 3 consecutive runs so as to offset system load irregularities however these figure might (and probably shall) differ on each and every run.

• Startup Time: 153x faster than FastAPI.
• 50.97% faster than FastAPI (p90).
• 48.65% faster than FastAPI (p95).

Examples

This repository includes examples for building a simple server over HTTP/3.

Acknowledgements

Other performant libraries form the backbone of this repository, and made it possible to build. We utilise the following open source libraries for developing ashttp3lib

• cloudflare/quiche
• google/boringssl

Thanks!