webfont-generator 0.11.0

Generate webfonts (SVG, TTF, EOT, WOFF, WOFF2) from SVG icons
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

#[cfg(feature = "fs")]
use std::path::{Component, Path, PathBuf};

/// Join a base URL with a file name, normalizing slashes.
///
/// When `base_url` consists only of slashes (e.g. `"/"`), the leading slash
/// is preserved so absolute-from-root references like `cssFontsUrl: "/"`
/// produce URLs such as `"/iconfont.woff2"` rather than collapsing to a
/// relative path.
pub(crate) fn join_url(base_url: &str, file_name: &str) -> String {
    if base_url.is_empty() {
        return file_name.trim_start_matches('/').to_owned();
    }
    let trimmed_base = base_url.trim_end_matches('/');
    let trimmed_file = file_name.trim_start_matches('/');
    if trimmed_base.is_empty() {
        format!("/{trimmed_file}")
    } else {
        format!("{trimmed_base}/{trimmed_file}")
    }
}

/// Compute a relative path from `from` to `to`.
#[cfg(feature = "fs")]
pub(crate) fn relative_path(from: &Path, to: &Path) -> PathBuf {
    let from_components = from.components().collect::<Vec<_>>();
    let to_components = to.components().collect::<Vec<_>>();
    let common_prefix_len = from_components
        .iter()
        .zip(&to_components)
        .take_while(|(left, right)| left == right)
        .count();

    let mut result = PathBuf::new();
    for _ in &from_components[common_prefix_len..] {
        result.push("..");
    }
    for component in &to_components[common_prefix_len..] {
        match component {
            Component::Normal(value) => result.push(value),
            Component::CurDir => result.push("."),
            Component::ParentDir => result.push(".."),
            Component::RootDir | Component::Prefix(_) => {}
        }
    }
    result
}

/// Convert a path to use forward slashes (for URLs on Windows).
#[inline]
#[cfg(feature = "fs")]
pub(crate) fn path_to_slashes(path: PathBuf) -> String {
    path.to_string_lossy().replace('\\', "/")
}

#[cfg(test)]
mod tests {
    use super::join_url;

    #[test]
    fn join_url_returns_file_name_when_base_is_empty() {
        assert_eq!(join_url("", "iconfont.woff2"), "iconfont.woff2");
        assert_eq!(join_url("", "/iconfont.woff2"), "iconfont.woff2");
    }

    #[test]
    fn join_url_preserves_leading_slash_when_base_is_root() {
        assert_eq!(join_url("/", "iconfont.woff2"), "/iconfont.woff2");
        assert_eq!(join_url("/", "/iconfont.woff2"), "/iconfont.woff2");
        assert_eq!(join_url("//", "iconfont.woff2"), "/iconfont.woff2");
    }

    #[test]
    fn join_url_joins_relative_and_absolute_paths() {
        assert_eq!(join_url("/foo", "iconfont.woff2"), "/foo/iconfont.woff2");
        assert_eq!(join_url("/foo/", "iconfont.woff2"), "/foo/iconfont.woff2");
        assert_eq!(join_url("foo", "iconfont.woff2"), "foo/iconfont.woff2");
        assert_eq!(join_url("foo/", "iconfont.woff2"), "foo/iconfont.woff2");
        assert_eq!(join_url("/foo", "/iconfont.woff2"), "/foo/iconfont.woff2");
    }

    #[test]
    fn join_url_preserves_absolute_url_origins() {
        assert_eq!(
            join_url("https://cdn.example.com", "iconfont.woff2"),
            "https://cdn.example.com/iconfont.woff2"
        );
        assert_eq!(
            join_url("https://cdn.example.com/", "iconfont.woff2"),
            "https://cdn.example.com/iconfont.woff2"
        );
        assert_eq!(
            join_url("https://cdn.example.com/assets", "iconfont.woff2"),
            "https://cdn.example.com/assets/iconfont.woff2"
        );
    }
}