oranda 0.6.5

🎁 generate beautiful landing pages for your projects
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

use crate::errors;
use crate::errors::OrandaError;
use camino::{Utf8Path, Utf8PathBuf};

/// Creates a workspace-safe relative path. Takes the following arguments:
/// - The root path of the workspace (or single project)
/// - An optional workspace member path
/// - The path itself, usually extracted from the configuration
/// Member path and the path itself can be relative or absolute .
/// The function will attempt to lazily build the smallest possible absolute and canonicalized path,
/// before diffing it with the root path to create a path that's always relative to the workspace root.
///
/// Some example scenarios:
/// 1. root path = "/my/directory", member path = None, path = "myfile.md"
///    Output = "myfile.md"
/// 2. root path = "/my/directory", member path = "member", path = "myfile.md"
///    Output = "member/myfile.md"
/// 3. root path= "/my/directory", member path = "/my/directory/member", path = "../root.md"
///    Output = "root.md"
pub fn determine_path(
    root_path: impl AsRef<Utf8Path>,
    member_path: &Option<impl AsRef<Utf8Path>>,
    path: impl AsRef<Utf8Path>,
) -> errors::Result<Option<Utf8PathBuf>> {
    let root_path = root_path.as_ref();
    let member_path = member_path.as_ref().map(|p| p.as_ref());
    let path = path.as_ref();
    if path.is_absolute() {
        // If absolute, return the path
        return Ok(Some(path.to_owned()));
    }

    // If the member path exists and is absolute, construct `member_path/path`.
    // If the member path exists and isn't absolute, construct `root_path/member_path/path`.
    // If the member path doesn't exist, construct `root_path/path`.
    let path_plus_member = if let Some(member_path) = member_path {
        if member_path.is_absolute() {
            let mut owned = Utf8PathBuf::new();
            owned.push(member_path);
            owned.push(path);
            owned.canonicalize_utf8()
        } else {
            let mut owned = Utf8PathBuf::new();
            owned.push(root_path);
            owned.push(member_path);
            owned.push(path);
            owned.canonicalize_utf8()
        }
    } else {
        let mut owned = Utf8PathBuf::new();
        owned.push(root_path);
        owned.push(path);
        owned.canonicalize_utf8()
    };

    match path_plus_member {
        Ok(path) => {
            // Create a relative path from difference between root and created path.
            Ok(Some(pathdiff::diff_utf8_paths(&path, root_path).ok_or(
                OrandaError::PathdiffError {
                    root_path: root_path.to_string(),
                    path: path.to_string(),
                },
            )?))
        }
        Err(_) => {
            // The path doesn't exist, return None
            Ok(None)
        }
    }
}