#http-server #web-framework #web-server #http #web #server #web-apps

just_serve_it

A lightweight and multithreaded backend web-framework for Rust

1 stable release

1.0.0 May 30, 2024

#2311 in Web programming

GPL-3.0 license

26KB
674 lines

just_serve_it

just_serve_it is a lightweight and multithreaded web framework written in Rust. It is designed to handle HTTP requests efficiently, providing a robust foundation for building web applications and APIs. just_serve_it focuses on simplicity and performance, offering essential features for routing, middleware, and static file serving.

Features

  • HTTP Request Handling: just_serve_it processes HTTP requests, making it suitable for applications that do not require HTTPS.
  • Multithreaded: Efficiently handles multiple requests simultaneously using Rust's powerful concurrency features.
  • Routing: Define routes for different HTTP methods (GET, POST, etc.) and handle requests based on URL patterns.
  • Middleware Support: Use middleware to process requests and responses, enabling functionalities like logging, authentication, and body parsing.
  • Static File Serving: Serve static files from specified directories, such as HTML, CSS, and JavaScript files.
  • Error Handling: Customizable error handling to provide user-friendly responses for different error conditions.

Installation

cargo add just_serve_it

Usage

Below is an example demonstrating how to use the just_serve_it framework.

use just_serve_it;
use just_serve_it::{middleware, path::Path, request::Request, response::Response, Server};
use std::io::Result;
use std::thread::sleep;
use std::time::Duration;

fn main() -> Result<()> {
    let mut server = Server::new("HTTP Server");

    server.not_found(not_found)?;
    server._use_(middleware::ServeStatic::dir("public"));
    server._use_(middleware::BodyParser::json());
    server._use_(middleware::BodyParser::url_encoded());

    server.get("/", root_handler)?;
    server.get("/about", about_handler)?;
    server.post("/", root_post_handler)?;

    server.listen("127.0.0.1", 8080, || {
        println!("Listening on 127.0.0.1:8080");
        Ok(())
    })?;

    Ok(())
}

fn root_handler(_req: Request, mut res: Response) -> Result<()> {
    res.send("/> Home Page!")?;
    Ok(())
}

fn about_handler(_req: Request, mut res: Response) -> Result<()> {
    sleep(Duration::from_secs(4));
    res.send("/about> About Page!")?;
    Ok(())
}

fn not_found(_req: Request, mut res: Response) -> Result<()> {
    res.status.status_code = 404;
    let path = Path::new("public");
    res.send_file(path.join("NotFound.html").to_str())?;
    Ok(())
}

fn root_post_handler(req: Request, mut res: Response) -> Result<()> {
    if let Some(body) = req.body {
        println!("RAW: {:?}", body.raw.unwrap());

        if let Some(json_data) = body.json {
            println!("JSON: {:?}", json_data);
        }

        if let Some(url_encoded_data) = body.url_encoded {
            println!("URL-ENCODED: {:?}", url_encoded_data);
        }

        let path = Path::new("public");
        res.send_file(path.join("home.html").to_str())?;
    } else {
        res.send("No Data!")?;
    }

    Ok(())
}

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

Dependencies

~0.5–1MB
~22K SLoC