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
.