sark 0.11.0

Simple Asynchronous Rust webKit - Server
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
70
71
72

//! Canonical path validation and asset sibling resolution.

use std::path::{Path, PathBuf};

use super::encoding::Encoding;

pub(super) struct Resolver<'a> {
    root: &'a Path,
}

impl<'a> Resolver<'a> {
    pub(super) fn new(root: &'a Path) -> Self {
        Self { root }
    }

    pub(super) fn relative(bytes: &[u8]) -> Option<&str> {
        if bytes.is_empty() || bytes.iter().any(|&byte| byte == 0 || byte == b'\\') {
            return None;
        }
        let relative = std::str::from_utf8(bytes).ok()?;
        if relative.starts_with('/') {
            return None;
        }
        let mut found = false;
        for segment in relative.split('/') {
            if segment.is_empty() || segment == "." {
                continue;
            }
            if segment == ".." {
                return None;
            }
            found = true;
        }
        found.then_some(relative)
    }

    pub(super) fn resolve(&self, relative: &str) -> PathBuf {
        let mut path = self.root.to_path_buf();
        for segment in relative.split('/') {
            if !segment.is_empty() && segment != "." {
                path.push(segment);
            }
        }
        path
    }

    pub(super) fn sibling(base: &Path, encoding: Encoding) -> PathBuf {
        let mut name = base.as_os_str().to_owned();
        name.push(encoding.suffix());
        PathBuf::from(name)
    }

    pub(super) fn content_type(path: &Path) -> &'static str {
        let Some(extension) = path.extension().and_then(|extension| extension.to_str()) else {
            return "application/octet-stream";
        };
        match extension.to_ascii_lowercase().as_str() {
            "css" => "text/css",
            "js" => "application/javascript",
            "html" => "text/html; charset=UTF-8",
            "json" => "application/json",
            "svg" => "image/svg+xml",
            "woff2" => "font/woff2",
            "woff" => "font/woff",
            "webp" => "image/webp",
            "png" => "image/png",
            "jpg" | "jpeg" => "image/jpeg",
            "txt" => "text/plain",
            _ => "application/octet-stream",
        }
    }
}