static

Static file-serving handler for the Iron web framework.

Example

This example uses the mounting handler to serve files from several directories.

let mut mount = Mount::new();

// Serve the shared JS/CSS at /
mount.mount("/", Static::new(Path::new("target/doc/")));
// Serve the static file docs at /doc/
mount.mount("/doc/", Static::new(Path::new("target/doc/static/")));
// Serve the source code at /src/
mount.mount("/src/", Static::new(Path::new("target/doc/src/static/src/lib.rs.html")));

Iron::new(mount).listen(Ipv4Addr(127, 0, 0, 1), 3000);

Note that static is a reserved keyword, so the crate will need to be imported as extern crate "static" as static_file;.

See examples/doc_server.rs for a complete example that you can compile.

Overview

static is a part of Iron’s core bundle.

• Serve static files from a given path.

It works well in combination with the mounting handler.

Installation

If you’re using a Cargo.toml to manage dependencies, just add the static package to the toml:

[dependencies.static]

git = "https://github.com/iron/static.git"

Otherwise, cargo build, and the rlib will be in your target directory.

Documentation

Along with the online documentation,
you can build a local copy with cargo doc.

Get Help

One of us (@reem, @zzmp,
@theptrk, @mcreinhard)
is usually on #iron on the mozilla irc. Come say hi and ask any questions you might have.
We are also usually on #rust and #rust-webdev.