sib 0.0.11

A high-performance, secure, and cross-platform modules optimized for efficiency, scalability, and reliability.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# SIB 🚀 powered by Rust 🦀 [![Build](https://github.com/PooyaEimandar/sib/actions/workflows/build.yml/badge.svg)](https://github.com/PooyaEimandar/sib/actions/workflows/build.yml)

**SIB** is a high-performance, secure, and cross-platform modules optimized for efficiency, scalability, and reliability.
it is designed for **real-time networking**, **low-latency streaming**, and **scalable HTTP services**.

> 🏷️ _"Sib" means **apple** in Persian (سیب)._

## ✨ Features

| Feature          | Description                                                |
| ---------------- | ---------------------------------------------------------- |
| `net-h1-server`  | Enable HTTP/1.1 server with coroutine concurrency          |
| `net-h3-server`  | Enable HTTP/3 QUIC-based server with coroutine concurrency |
| `db-fdb`         | FoundationDB bindings (requires `libfdb_c`) on macOS/Linux |
| `stm-sender`     | Real-time video/audio streamer server                      |
| `stm-receiver`   | Real-time video/audio receiver                             |
| `sys-boring-ssl` | BoringSSL backend for secure networking                    |

## 📊 Benchmarks

### 🔬 [HTTP/1.1 TechEmpower Plaintext Benchmark](https://github.com/TechEmpower/FrameworkBenchmarks/tree/master/frameworks/Rust/sib) - **Ready** for production

**Environment:**

- 🧠 12-core CPU
- 🧮 32 GB RAM
- 🐳 Docker container
- ⚙️ `target-cpu=native` on Apple Macbook Pro M2 Max 2023
- Sib HTTP/1.1 uses:
  - [`may`](https://github.com/Xudong-Huang/may) for coroutine scheduling.
  - [`bytes`](https://github.com/tokio-rs/bytes) for zero-copy HTTP parser.
  - [`mimalloc`](https://github.com/microsoft/mimalloc) a compact general purpose allocator with excellent performance.

| Concurrency | Requests/sec  | Latency (avg) | Transfer/sec |
| ----------- | ------------- | ------------- | ------------ |
| 8           | 105,598       | 75.70 µs      | 12.89 MB/s   |
| 512         | 840,036       | 0.99 ms       | 102.54 MB/s  |
| 256         | 5,106,291     | 1.06 ms       | 623.33 MB/s  |
| 1024        | **6,112,892** | 1.71 ms       | 746.20 MB/s  |
| 4096        | 5,890,631     | 5.11 ms       | 719.07 MB/s  |
| 16384       | 5,038,547     | 19.11 ms      | 615.06 MB/s  |

### 🔬 [HTTP/3 Stress Test Benchmark](https://github.com/PooyaEimandar/sib/tree/main//bench/h3_test.py) - **Not ready** for production

**Environment:**

- 🧠 12-core CPU
- 🧮 96 GB RAM
- 💻 Apple Macbook Pro M2 Max 2023
- Sib HTTP/3 uses:
  - [`may`](https://github.com/Xudong-Huang/may) for coroutine scheduling.
  - [`quiche`](https://github.com/cloudflare/quiche) for QUIC + HTTP/3 transport.
  - [`bytes`](https://github.com/tokio-rs/bytes) for zero-copy buffer management.
  - [`mimalloc`](https://github.com/microsoft/mimalloc) compact high-performance allocator.

**Test setup:**

- Download [binary of curl built with HTTP/3](https://github.com/stunnel/static-curl) and place it inside bench folder
- Run the Python script from the bench folder `python3 ./h3_test.py --url https://localhost:8080 --curl-path ./curl --requests 10000 --concurrency 10000 --http3 --insecure`
- 10K requests launched all at once, each over its own QUIC/TLS handshake. This is a hammer test and purpose is validate the stability and tail latency under handshake pressure.

| Total Requests | Concurrency | Success Rate | Avg Latency |
| -------------- | ----------- | ------------ | ----------- |
| 10,000         | 10,000      | **99.97%**   | **1.00 s**  |

# ⚙️ Build note

When building with the `sys-boring-ssl` feature enabled, you’ll need to set up the LLVM toolchain and related libraries first.

## 📦 Prerequisites (Ubuntu/Debian)

```bash
sudo apt install -y clang lld llvm libclang-dev
```

## 📚 Documentation

- 📦 [Crate](https://crates.io/crates/sib)
- 📖 [Docs](https://docs.rs/sib)
- 🧪 [Benchmarks: TechEmpower](https://github.com/TechEmpower/FrameworkBenchmarks)

## 📄 License

SIB is licensed under either of:

- [Apache License, Version 2.0](https://github.com/PooyaEimandar/sib/blob/main/LICENSE-APACHE)
- [MIT license](https://github.com/PooyaEimandar/sib/blob/main/LICENSE-MIT)

at your option.