static-file-resolver 10.3.0

A library that resolves the file a request asks for under a root directory. It refuses a path that climbs out of the root, so a request cannot reach a file the root does not hold.
Documentation 
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
65
66
67
68
69

use super::*;

#[test]
fn resolves_a_path_under_the_root() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver {
        root: Path::new("/srv/public"),
        index: "index.html",
    };
    let file: Option<PathBuf> = resolver.resolve("assets/app.js");
    assert_eq!(file, Some(PathBuf::from("/srv/public/assets/app.js")));
}

#[test]
fn refuses_a_path_that_climbs_out_of_the_root() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver {
        root: Path::new("/srv/public"),
        index: "index.html",
    };
    let file: Option<PathBuf> = resolver.resolve("../../etc/passwd");
    assert!(file.is_none());
}

#[test]
fn refuses_a_segment_that_names_its_directory() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver::default();
    let file: Option<PathBuf> = resolver.resolve("assets/./app.js");
    assert!(file.is_none());
}

#[test]
fn refuses_a_segment_that_holds_a_backslash() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver::default();
    let file: Option<PathBuf> = resolver.resolve("assets\\app.js");
    assert!(file.is_none());
}

#[test]
fn refuses_an_empty_segment() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver::default();
    let file: Option<PathBuf> = resolver.resolve("assets//app.js");
    assert!(file.is_none());
}

#[test]
fn answers_a_directory_with_the_index_file() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver {
        root: Path::new("/srv/public"),
        index: "index.html",
    };
    let file: Option<PathBuf> = resolver.resolve("");
    assert_eq!(file, Some(PathBuf::from("/srv/public/index.html")));
}

#[test]
fn answers_a_directory_with_the_index_it_was_given() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver {
        root: Path::new("/srv/public"),
        index: "home.html",
    };
    let file: Option<PathBuf> = resolver.resolve("");
    assert_eq!(file, Some(PathBuf::from("/srv/public/home.html")));
}

#[test]
fn serves_the_current_directory_by_default() {
    let resolver: StaticFileResolver<'_> = StaticFileResolver::default();
    assert_eq!(resolver.get_root(), Path::new("."));
    assert_eq!(resolver.get_index(), "index.html");
}