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.

Creating a simple server:

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:

cargo test

For asynchronous tests, run with the async_tokio feature:

cargo test --features async_tokio --test test_asynctokio
cargo test --features async_tokio --test test_asynctokio
cargo test --features async_tokio --test test_asynctokio

httpageboy 1.0.9

HTTPageboy

Example

Testing

License