mdbookkit 2.0.1

Support library for mdBook preprocessors in the mdbookkit project
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

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

use anyhow::{Result, bail};
use url::Url;

pub trait ExpectUrl<T> {
    fn expect_url(self) -> T;
}

impl<T> ExpectUrl<T> for Result<T, url::ParseError> {
    #[inline(always)]
    fn expect_url(self) -> T {
        self.expect("should be a valid URL")
    }
}

pub trait UrlToPath {
    fn to_path(&self) -> Result<PathBuf>;

    fn expect_path(&self) -> PathBuf;
}

impl UrlToPath for Url {
    #[inline(always)]
    fn to_path(&self) -> Result<PathBuf> {
        match self.to_file_path() {
            Ok(path) => Ok(path),
            Err(_) => bail!("{self} does not have a valid file path"),
        }
    }

    #[inline(always)]
    fn expect_path(&self) -> PathBuf {
        self.to_path().expect("URL path should be valid")
    }
}

pub trait UrlFromPath {
    fn to_directory_url(&self) -> Url;

    fn to_file_url(&self) -> Url;
}

impl<P: AsRef<Path> + ?Sized> UrlFromPath for P {
    #[inline(always)]
    fn to_directory_url(&self) -> Url {
        Url::from_directory_path(self).expect("should be a valid absolute path")
    }

    #[inline(always)]
    fn to_file_url(&self) -> Url {
        Url::from_file_path(self).expect("should be a valid absolute path")
    }
}