nanoserve 0.1.0

Ground-up implementation of a nano HTTP server from TCP sockets
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

# nanoserve

[![GitHub License](https://img.shields.io/github/license/PRO-2684/nanoserve?logo=opensourceinitiative)](https://github.com/PRO-2684/nanoserve/blob/main/LICENSE)
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/PRO-2684/nanoserve/release.yml?logo=githubactions)](https://github.com/PRO-2684/nanoserve/blob/main/.github/workflows/release.yml)
[![GitHub Release](https://img.shields.io/github/v/release/PRO-2684/nanoserve?logo=githubactions)](https://github.com/PRO-2684/nanoserve/releases)
[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/PRO-2684/nanoserve/total?logo=github)](https://github.com/PRO-2684/nanoserve/releases)
[![Crates.io Version](https://img.shields.io/crates/v/nanoserve?logo=rust)](https://crates.io/crates/nanoserve)
[![Crates.io Total Downloads](https://img.shields.io/crates/d/nanoserve?logo=rust)](https://crates.io/crates/nanoserve)
[![docs.rs](https://img.shields.io/docsrs/nanoserve?logo=rust)](https://docs.rs/nanoserve)

> [!NOTE]
> This is a toy project, primarily used as my handin for the course [Computer Networks](https://jwcg.ucas.ac.cn/public/courseOutlines?courseId=289907).

Nanoserve is a lightweight, educational HTTP/1.1 server implementation built using TCP sockets and modern Rust async I/O. It demonstrates HTTP protocol fundamentals, asynchronous networking, and systems programming best practices. This server supports core HTTP/1.1 features including GET requests, range requests (partial content), graceful shutdown, and efficient file serving.

## 📥 Installation

### Using [`binstall`](https://github.com/cargo-bins/cargo-binstall)

```shell
cargo binstall nanoserve
```

### Downloading from Releases

Navigate to the [Releases page](https://github.com/PRO-2684/nanoserve/releases) and download respective binary for your platform. Make sure to give it execute permissions.

### Compiling from Source

```shell
cargo install nanoserve
```

## 💡 Examples

TODO

## 📖 Usage

TODO

## ✅ TODO

- [ ] Accept `HEAD` and `OPTIONS`, returning file metadata
- [ ] `Content-Length` header

## 🎉 Credits

TODO