1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! # hyper-static - a static file handler for Rust/Hyper with minimal logic
//! 
//! Crate: <https://crates.io/crates/hyper-static>
//! Repository: <https://github.com/alttch/hyper-static>
//! 
//! The idea is to have a static file handler with no overhead. Make any handler
//! function for Hyper, with own logic, if static file needs to be returned - give
//! the crate a path and that is it.
//! 
//! * serves large files with zero-copy buffers
//! * correctly processes partial requests (Content-Range)
//! * crate errors can be transformed directly into Hyper results
//! 
//! Example:
//! 
//! ```rust,ignore
//! // define some hyper handler
//! async fn handler(req: Request<Body>) -> Result<Response<Body>, http::Error> {
//!     // ....
//!     // serve a file when necessary
//!     // in a simple way
//!     let path = std::path::Path::new("/path/to/file");
//!     return match serve::file(
//!         &path,
//!         Some("text/html"), // mime type
//!         &req.headers(), // hyper request header map
//!         65536 // buffer size
//!     )
//!     .await
//!     {
//!         Ok(v) => v, // return it
//!         Err(e) => e.into(), // transform the error and return
//!     };
//!     // more complicated - analyze errors, e.g. log them
//!     return match static_file(
//!         &path,
//!         Some("text/html"),
//!         &parts.headers,
//!         65536
//!     )
//!     .await
//!     {
//!         Ok(v) => {
//!             debug!(
//!                 r#""GET {}" {}"#,
//!                 uri,
//!                 v.as_ref().map_or(0, |res| res.status().as_u16())
//!             );
//!             v
//!         }
//!         Err(e) => {
//!             let resp: Result<Response<Body>, http::Error> = e.into();
//!             warn!(
//!                 r#""GET {}" {}"#,
//!                 uri,
//!                 resp.as_ref().map_or(0, |res| res.status().as_u16())
//!             );
//!             resp
//!         }
//!     };
//! }
//! ```
pub mod serve;
pub mod streamer;