Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Xudong-Huang/may_minihttp
mini http implemented on top of may
https://github.com/Xudong-Huang/may_minihttp
Last synced: 3 months ago
JSON representation
mini http implemented on top of may
- Host: GitHub
- URL: https://github.com/Xudong-Huang/may_minihttp
- Owner: Xudong-Huang
- License: apache-2.0
- Created: 2018-01-15T14:38:21.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T03:05:41.000Z (7 months ago)
- Last Synced: 2024-04-14T00:47:48.660Z (7 months ago)
- Language: Rust
- Homepage:
- Size: 132 KB
- Stars: 473
- Watchers: 9
- Forks: 35
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# may_minihttp
Mini http server that implemented on top of [may](https://github.com/Xudong-Huang/may)
This crate is ported from [tokio_minihttp](https://github.com/tokio-rs/tokio-minihttp).
But with much ease of use, you can call `MAY` block APIs directly in your service.
[](https://github.com/Xudong-Huang/may_minihttp/actions?query=workflow%3ACI+branch%3Amaster)
[](https://crates.io/crates/may_minihttp)
## Usage
First, add this to your `Cargo.toml`:
```toml
[dependencies]
may_minihttp = "0.1"
```
Then just simply implement your http service
```rust,no_run
extern crate may_minihttp;
use std::io;
use may_minihttp::{HttpServer, HttpService, Request, Response};
#[derive(Clone)]
struct HelloWorld;
impl HttpService for HelloWorld {
fn call(&mut self, _req: Request, res: &mut Response) -> io::Result<()> {
res.body("Hello, world!");
Ok(())
}
}
// Start the server in `main`.
fn main() {
let server = HttpServer(HelloWorld).start("0.0.0.0:8080").unwrap();
server.join().unwrap();
}
```
## Performance
Tested with only one working thread on my laptop
Both with the following command to start the server.
```
$ cargo run --example=hello-world --release
```
**tokio_minihttp**
```sh
$ wrk http://127.0.0.1:8080 -d 10 -t 1 -c 200
Running 10s test @ http://127.0.0.1:8080
1 threads and 200 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 1.98ms 284.06us 12.53ms 98.92%
Req/Sec 101.64k 1.76k 103.69k 91.00%
1011679 requests in 10.05s, 99.38MB read
Requests/sec: 100650.94
Transfer/sec: 9.89MB
```
**may_minihttp**
```sh
$ wrk http://127.0.0.1:8080 -d 10 -t 1 -c 200
Running 10s test @ http://127.0.0.1:8080
1 threads and 200 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 1.70ms 812.42us 20.17ms 97.94%
Req/Sec 117.65k 7.52k 123.40k 88.00%
1171118 requests in 10.08s, 115.04MB read
Requests/sec: 116181.73
Transfer/sec: 11.41MB
```
## Benchmarks
One of the fastest web frameworks available according to the [TechEmpower Framework Benchmark](https://www.techempower.com/benchmarks/#section=data-r22&test=composite&hw=ph).
# License
This project is licensed under either of
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
http://opensource.org/licenses/MIT)
at your option.