Getting started
Rust Web Framework (Rwf for short) is a framework for building web applications using the Rust programming language. It aims to be comprehensive by providing all necessary features for building modern, fast, and secure web apps.
Rwf has very few dependencies and is easy use with new or existing Rust applications.
Install Rust
If you haven't already, install the Rust compiler and tools from rust-lang.org. Rwf doesn't use any nightly or experimental features, so the stable version of the compiler will work.
Create a project
Rwf can be used with any Rust binary or library project. If you don't have one already, you can create it with Cargo1:
Add Rwf
Rwf primarily consists of the rwf crate2. You can add it to your project with Cargo:
Build an application
With the rwf crate added, you're ready to build your first web application in Rust.
Rwf is MVC (model-view-controller),
so to get started let's create a simple controller:
use rwf::prelude::*;
#[controller]
async fn index() -> Response {
Response::new().html("<h1>My first Rwf app!</h1>")
}
rwf::prelude::* includes most types, traits and functions you'll need to build applications.
Adding this declaration to your source code will make things easier, but it's not required.
#[controller] macro creates a controller from any async function that returns a Response.
Launch the server
With a controller ready to go, let's create a route and launch the Rwf HTTP server:
use rwf::http::{self, Server};
#[tokio::main]
async fn main() -> Result<(), http::Error> {
// Configure the logger.
Logger::init();
// Define routes.
let routes = vec![
route!("/" => index),
];
// Launch the HTTP server.
Server::new(routes)
.launch()
.await
}
Your application is ready. You can launch it with Cargo:
Once the server is running, your web application will be available at http://localhost:8000. The full code for this is available on GitHub.