A Rocket responder for types implementing the AsyncRead + AsyncSeek
traits, such as files and rocket::futures::io::Cursor
, that will respond to range requests with a 206 Partial Content response. The Content-Type
can optionally be inferred by taking a sample of bytes from the beginning of the stream, or given manually. An Accept-Ranges: bytes
header will be sent in all responses to notify browsers that range requests are supported for the resource.
This supports both single and multipart/byterange requests. https://tools.ietf.org/html/rfc7233
Add this to your dependencies.
rocket_seek_stream = {git="https://github.com/rydz/rocket_seek_stream"}
Serving a file from the disk
#![feature(proc_macro_hygiene, decl_macro)]
#[macro_use]
extern crate rocket;
use rocket_seek_stream::SeekStream;
#[get("/")]
fn home<'a>() -> std::io::Result<SeekStream<'a>> {
SeekStream::from_path("kosmodrom.webm")
}
#[rocket::main]
async fn main() {
match rocket::build().mount("/", routes![home]).launch().await {
Ok(_) => (),
Err(e) => {
eprintln!("Rocket stopped unexpectedly. (Error {})", e);
}
};
}
Serving an in memory buffer
#[get("/")]
fn cursor<'a>() -> SeekStream<'a> {
let bytes = &include_bytes!("./fly_me_to_the_moon.webm")[..];
let len = bytes.len();
let stream = std::io::Cursor::new(bytes);
SeekStream::with_opts(stream, len as u64, "video/webm")
}
Use cargo run --example server
to run the example. run examples/download.sh
to download the media it depends on using yt-dlp.
- Write some tests
I've compared the output of the Golang stdlib http router's multipart response to what I output here and it looks about the same except for a small difference in whitespace.