Snowboard π
An extremelly simple library for fast & simple TCP servers in rust
[Request a feature/Report a bug]
Quick start
To get started with Snowboard, simply add it to your Cargo.toml file:
[dependencies]
snowboard = "*"
Then, create a new Rust file with the following code:
use snowboard::{response, Server};
fn main() {
let data = "Hello, world!";
Server::new("localhost:8080").run(move |request| {
println!("{:?}", request);
response!(ok, data)
})
}
And that's it! You got yourself a working server on :8080. Examples can be found here.
Async routes
You can use the async feature to change Server::run() so that it supports asynchronous handlers:
# Cargo.toml
[dependencies]
snowboard = { version = "*", features = ["async"] }
// src/main.rs
use snowboard::async_std::task;
use snowboard::{response, Request, Response, Server};
use std::time::Duration;
async fn index(req: Request) -> Response {
println!("{:?}", req);
// Wait 1 second before sending the response
task::sleep(Duration::from_secs(1)).await;
response!(ok, "Async works!")
}
fn main() {
Server::new("localhost:8080").run(index);
}
Routing
Routing can be handled easily using the Url struct as seen in examples/routing.
Why should I use this?
Snowboard is designed and created for people who like coding their own things from little to nothing, like me. This library does not implement what most server libraries have, like an advanced routing system, but rather offers a set of essential tools to create a powerful web server.
Contributing
Check CONTRIBUTING.md for a simple guide on how to help the project.
License
This code is under the MIT license that can be found at LICENSE
4 Feb 19, 2024
41 Dec 22, 2022
98 Jan 4, 2023
8 Mar 2, 2023
5 May 2, 2023
4 Aug 29, 2023
23 Nov 9, 2023
4.1k Jan 6, 2023
162 Dec 31, 2022
247 Jan 27, 2023
4 Dec 1, 2023
8 Nov 14, 2022
6 Sep 15, 2022
2 Sep 12, 2022
4 Mar 5, 2023
9 May 13, 2023
16 Sep 18, 2023
6 Dec 26, 2023