sib 0.0.12

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

# 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 (cross platform)     |
| `net-h2-server`  | Enable HTTP/2 server with io_uring (only on Linux kernel 5.6+)                        |
| `net-h3-server`  | Enable HTTP/3 QUIC-based server with io_uring (only on Linux kernel 5.6+)              |
| `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                             |

## 📊 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  |

# ⚙️ Build note

When building H1 with the `net-h1-server` feature enabled, you’ll need to set up the LLVM toolchain and related libraries first for boringSSL.

## 📦 Prerequisites (Ubuntu/Debian)

```bash
sudo apt install -y cmake 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.