A web framework for Rust.
Go to file
Sergio Benitez 46f73ed57c Renamed macros to codegen. 2016-09-08 20:38:58 -07:00
codegen Renamed macros to codegen. 2016-09-08 20:38:58 -07:00
docs Initial commit. Checking for method and path arguments in route. Not storing the info anywhere yet. 2016-03-07 11:28:04 -08:00
examples Renamed macros to codegen. 2016-09-08 20:38:58 -07:00
lib Use a generic ToString object in new. 2016-09-08 00:25:40 -07:00
scripts Renamed macros to codegen. 2016-09-08 20:38:58 -07:00
.gitignore Fixed todo example. Testing script now bootstraps when needed. 2016-08-06 19:57:44 -07:00
.travis.yml Added a travis file. 2016-03-17 20:18:16 -07:00
Cargo.toml Add query params to Rocket. Use Ident for attribute params. 2016-09-04 19:18:08 -07:00
README.md Renamed macros to codegen. 2016-09-08 20:38:58 -07:00
rustfmt.toml Complete rewrite of macro parsing and item generation. 2016-09-04 01:05:17 -07:00

README.md

Rocket

Build Status

Rocket is a work-in-progress web framework for Rust (nightly) with a focus on ease-of-use, expressability, and speed. Here's an example of a complete Rocket application:

#![feature(plugin)]
#![plugin(rocket_codegen)]

extern crate rocket;
use rocket::Rocket;

#[get("/<name>/<age>")]
fn hello(name: &str, age: u8) -> String {
    format!("Hello, {} year old named {}!", age, name)
}

fn main() {
    Rocket::new("localhost", 8000).mount_and_launch("/hello", routes![hello]);
}

Visiting localhost:8000/hello/John/58, for example, will trigger the hello route resulting in the string Hello, 58 year old named John! being sent to the browser. If an <age> string was passed in that can't be parsed as a u8, the route won't get called, resulting in a 404 error.

Building

Nightly

Rocket requires a nightly version of Rust as it makes heavy use of syntax extensions. This also means that the first two unwieldly lines in the Rust file above are required.

Examples

Try running the examples in the examples/ folder. For instance, the following sequence of commands builds and runs the Hello, world! example:

cd examples/hello_world
cargo run

Then visit localhost:8000. You should see Hello, world!.

OS X

Apple has stopped shipping openssl with OS X.11. As such, if your build fails to compile with some openssl related errors, you'll need to install openssl, cargo clean, and then cargo build again. Here are some lightweight instructions:

brew install openssl
brew link --force openssl
export OPENSSL_INCLUDE_DIR=`brew --prefix openssl`/include
export OPENSSL_LIB_DIR=`brew --prefix openssl`/lib