Bobby

A minimal web framework for Rust.

Note: very much pre-alpha.

Installation

Add Bobby to your Cargo.toml:

[dependencies]
bobby = "0.1.1"

Usage

Basic usage looks like this:

use bobby::{Bobby, Response};

// Create app
let mut app = Bobby::new();

// Config address
app.with_address([127, 0, 0, 1], 3333);

// Routes
app.get("/", |_| Response::html("Hello, <strong>World</strong>"));
app.get("/some/{thing?}", |_| Response::html("An optional route part."));
app.get("/other/{thing}", |_| Response::html("A non-optional route part."));

// Run
app.run().ok();

App configuration

Bobby can be configured using with_ methods.

Address and port

To have Bobby listen on a given address and port, use the with_address method:

app.with_address([127, 0, 0, 1], 3333);

If you don't configure this then Bobby will listen on address 127.0.0.1 and port 8080 by default.

Routing

Routes are added to the instance of Bobby by calling route related methods. An example route looks like this:

app.get("/", |req| {
  Response::html("Hello, World.")
});

Supported methods are:

• get
• post
• put
• delete
• patch
• options
• head

Requests

Each route function gets a Request instance passed to it as its single argument.

Method

You can see the incoming request' method:

app.get("/", |req| {
  let method = req.method();
});

URI

You can see the incoming request' URI:

app.get("/", |req| {
  let uri = req.uri();
});

Parameters

You can get the route parameters:

app.get("/hello/{who}", |req| {
  let who = req.param("who");
});

Responses

Each route must return an instance of Response.

Response: HTML

You can return a HTML response:

app.get("/", |req| {
  Response::html("Hello, World.")
});

Response: JSON

You can return a JSON response:

use serde_json::json;

app.get("/", |req| {
  Response::json(json!({
    "name": "John"
  }))
});

Setting headers

You can set the response headers:

app.get("/", |req| {
  Response::html("Hello, World.")
    .with_header("Content-Type", "text/html")
});

Setting status code

You can set the response status:

app.get("/", |req| {
  Response::html("Not found.")
    .with_header("Content-Type", "text/html")
    .with_status(404)
});