racoon Code
Racoon is a fast, fully customizable web framework for Rust focusing o
Brought to you by:
tejmagar
Menu
▾
▴
Tree [919190] main / History
| File | Date | Author | Commit |
|---|---|---|---|
| .github | 2024-06-07 |
Tej Magar
|
[f15aa0] initial commit |
| src | 2024-07-12 |
Tej Magar
|
[c1890b] feat: add close method in WebSocket |
| .gitignore | 2024-06-26 |
Tej Magar
|
[ca3497] ignore test templates dir |
| Cargo.lock | 2024-07-12 |
Tej Magar
|
[919190] chore: bump version to 0.1.7 |
| Cargo.toml | 2024-07-12 |
Tej Magar
|
[919190] chore: bump version to 0.1.7 |
| LICENSE.md | 2024-06-07 |
Tej Magar
|
[f15aa0] initial commit |
| README.md | 2024-07-12 |
Tej Magar
|
[919190] chore: bump version to 0.1.7 |
| logo.png | 2024-06-24 |
rahul bista
|
[f526ef] Add files via upload |
Read Me
Racoon
Racoon is a fast, fully customizable web framework for Rust focusing on simplicity.
To use Racoon, you need minimal Rust version 1.75.0 and Tokio runtime.
Installation
You will need tokio runtime to run Racoon. Run cargo add tokio to install tokio crate.
[dependencies]
racoon = "0.1.7"
Basic Usage
use racoon::core::path::Path;
use racoon::core::request::Request;
use racoon::core::response::{HttpResponse, Response};
use racoon::core::response::status::ResponseStatus;
use racoon::core::server::Server;
use racoon::view;
async fn home(request: Request) -> Response {
HttpResponse::ok().body("Home")
}
#[tokio::main]
async fn main() {
let paths = vec![
Path::new("/", view!(home))
];
let result = Server::bind("127.0.0.1:8080")
.urls(paths)
.run().await;
println!("Failed to run server: {:?}", result);
}
File Handling
There are multiple ways to handle files in Racoon. The simple way is to use request.parse() method.
use racoon::core::request::Request;
use racoon::core::response::{HttpResponse, Response};
use racoon::core::response::status::ResponseStatus;
use racoon::core::forms::FileField;
use racoon::core::shortcuts::SingleText;
async fn upload_form(request: Request) -> Response {
if request.method == "POST" {
// Parses request body
let (form_data, files) = request.parse().await;
println!("Name: {:?}", form_data.value("name"));
let file = files.value("file");
println!("File: {:?}", file);
return HttpResponse::ok().body("Uploaded");
}
HttpResponse::bad_request().body("Use POST method to upload file.")
}
For more information check form handling guide.
WebSocket example
use racoon::core::path::Path;
use racoon::core::request::Request;
use racoon::core::response::Response;
use racoon::core::server::Server;
use racoon::core::websocket::{Message, WebSocket};
use racoon::view;
async fn ws(request: Request) -> Response {
let (websocket, connected) = WebSocket::from(&request).await;
if !connected {
// WebSocket connection didn't success
return websocket.bad_request().await;
}
println!("WebSocket client connected.");
// Receive incoming messages
while let Some(message) = websocket.message().await {
match message {
Message::Text(text) => {
println!("Message: {}", text);
// Sends received message back
let _ = websocket.send_text(text.as_str()).await;
}
_ => {}
}
}
websocket.exit()
}
#[tokio::main]
async fn main() {
let paths = vec![
Path::new("/ws/", view!(ws))
];
let _ = Server::bind("127.0.0.1:8080")
.urls(paths)
.run().await;
}
Benchmark
wrk -c100 -d8s -t4 http://127.0.0.1:8080
Result on AMD Ryzen 5 7520U with Radeon Graphics.
Running 8s test @ http://127.0.0.1:8080/
4 threads and 100 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 374.62us 219.91us 3.91ms 76.47%
Req/Sec 62.42k 4.25k 70.53k 82.50%
1987462 requests in 8.00s, 140.26MB read
Requests/sec: 248389.96
Transfer/sec: 17.53MB
This benchmark does not make sense in real world.
