ddoc 0.18.0

doc site generator
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

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

#[derive(Debug, Default)]
pub struct InitValues {
    pub title: Option<String>,
    pub description: Option<String>,
    pub index: Option<PathBuf>,
    pub github_repo: Option<String>,
    pub plugins: Vec<EmbeddedPlugin>,
}

impl InitValues {
    pub fn guess(project_dir: &Path) -> DdResult<Self> {
        let Some(parent_dir) = project_dir.parent() else {
            return Ok(InitValues::default());
        };
        let mut init_values = Self::default();
        if let Some(cargo_toml) = CargoToml::in_dir(parent_dir) {
            if init_values.title.is_none() {
                init_values.title = Some(cargo_toml.project_name().to_owned());
            }
            if init_values.description.is_none() {
                if let Some(desc) = cargo_toml.project_description() {
                    init_values.description = Some(desc.to_owned());
                }
            }
            if init_values.github_repo.is_none() {
                init_values.github_repo = cargo_toml.github_repository();
            }
        }
        if let Some(readme_path) = find_file_ignore_case(parent_dir, "README.md") {
            if init_values.index.is_none() {
                init_values.index = Some(readme_path);
            }
        }
        init_values.plugins = EmbeddedPlugin::all();
        Ok(init_values)
    }
}

pub fn find_file_ignore_case(
    dir: &Path,
    filename: &str,
) -> Option<PathBuf> {
    let filename_lower = filename.to_lowercase();
    let Ok(read_dir) = std::fs::read_dir(dir) else {
        return None;
    };
    for entry in read_dir.flatten() {
        let file_name_os = entry.file_name();
        let Some(file_name_str) = file_name_os.to_str() else {
            continue;
        };
        if file_name_str.to_lowercase() == filename_lower {
            return Some(entry.path());
        }
    }
    None
}