httpageboy 1.0.9

A lightweight library for handling raw HTTP request/response transmission. Good base for APIs. Supports both synchronous and asynchronous programming models.
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

# HTTPageboy

Minimal HTTP server package for handling request/response transmission.
Focuses only on transporting a well formed HTTP message; does not process or decide how the server behaves.
Aspires to become runtime-agnostic, with minimal, solid, and flexible dependencies.

`Request`: any HTTP request.
`Route`: path + method + handler → returns Response.
`Response`: bytes with content-type, sent to browser.

## Example

`lib.rs` is the actual implementation of the server.

`main.rs` is this following example ready for execution. Just run `cargo run` on the terminal and go to [http://127.0.0.1:7878](http://127.0.0.1:7878).

Creating a simple server:

```rust
use httpageboy::{Request, Response, Rt, Server, StatusCode}; // Rt is alias for ResponseType

fn main() {
  let serving_url: &str = "127.0.0.1:7878";
  let threads_number: u8 = 10;
  let mut server = Server::new(serving_url, threads_number, None).unwrap();
  server.add_route("/", Rt::GET, demo_get);
  server.add_files_source("res"); // this points to the /res folder in the project root
  server.run();
}

fn demo_get(_request: &Request) -> Response {
  return Response {
    status: StatusCode::Ok.to_string(),
    content_type: String::new(),
    content: "<!DOCTYPE html><html><head>
        <meta charset=\"utf-8\">\
        </head><body>🤓👉 <a href=\"/HTTPageboy.svg\">IMG</a></body></html>"
      .as_bytes()
      .to_vec(),
  };
}
```

## Testing


//YOU CAN ALSO FIND MANY EXAMPLES HERE

You can run the tests using `cargo test`.

For synchronous tests, simply run:
```bash
cargo test
```

For asynchronous tests, run with the `async_tokio` feature:
```bash
cargo test --features async_tokio --test test_asynctokio
cargo test --features async_tokio --test test_asynctokio
cargo test --features async_tokio --test test_asynctokio
```

## License

Copyright (c) 2025 [fahedsl](https://gitlab.com/fahedsl).
This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).