krik 0.1.27

A fast static site generator written in Rust with internationalization, theming, and modern web features
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use crate::error::{CliError, CliErrorKind, KrikError, KrikResult};
use std::fs;
use std::path::{Path, PathBuf};

/// Normalize a path to an absolute canonical path if possible.
/// - If `must_exist` is true, returns an error if the path does not exist.
/// - If `must_exist` is false, returns a best-effort absolute path (without canonicalizing missing path).
pub fn normalize_path<P: AsRef<Path>>(
    path: P,
    must_exist: bool,
    context: &str,
) -> KrikResult<PathBuf> {
    let p = path.as_ref();
    if must_exist {
        if !p.exists() {
            return Err(KrikError::Cli(Box::new(CliError {
                kind: CliErrorKind::PathDoesNotExist,
                path: Some(p.to_path_buf()),
                context: context.to_string(),
            })));
        }
        match fs::canonicalize(p) {
            Ok(abs) => Ok(abs),
            Err(e) => Err(KrikError::Cli(Box::new(CliError {
                kind: CliErrorKind::CanonicalizeFailed(e),
                path: Some(p.to_path_buf()),
                context: context.to_string(),
            }))),
        }
    } else {
        // When the path may not exist yet, we canonicalize the parent if possible.
        if p.exists() {
            return fs::canonicalize(p).map_err(|e| {
                KrikError::Cli(Box::new(CliError {
                    kind: CliErrorKind::CanonicalizeFailed(e),
                    path: Some(p.to_path_buf()),
                    context: context.to_string(),
                }))
            });
        }
        if let Some(parent) = p.parent() {
            let base = if parent.exists() {
                fs::canonicalize(parent).unwrap_or_else(|_| parent.to_path_buf())
            } else {
                std::env::current_dir().unwrap_or_else(|_| PathBuf::from("."))
            };
            Ok(base.join(p.file_name().unwrap_or_default()))
        } else {
            Ok(std::env::current_dir()
                .unwrap_or_else(|_| PathBuf::from("."))
                .join(p))
        }
    }
}

/// Validate that a path exists and is a directory, returning a normalized absolute path.
pub fn validate_directory<P: AsRef<Path>>(path: P, context: &str) -> KrikResult<PathBuf> {
    let p = path.as_ref();
    if !p.exists() {
        return Err(KrikError::Cli(Box::new(CliError {
            kind: CliErrorKind::PathDoesNotExist,
            path: Some(p.to_path_buf()),
            context: context.to_string(),
        })));
    }
    if !p.is_dir() {
        return Err(KrikError::Cli(Box::new(CliError {
            kind: CliErrorKind::NotADirectory,
            path: Some(p.to_path_buf()),
            context: context.to_string(),
        })));
    }
    normalize_path(p, true, context)
}

/// Ensure a directory exists, creating it if missing. Returns the absolute path.
pub fn ensure_directory<P: AsRef<Path>>(path: P, context: &str) -> KrikResult<PathBuf> {
    let p = path.as_ref();
    if p.exists() {
        return validate_directory(p, context);
    }
    if let Err(e) = fs::create_dir_all(p) {
        return Err(KrikError::Cli(Box::new(CliError {
            kind: match e.kind() {
                std::io::ErrorKind::PermissionDenied => CliErrorKind::PermissionDenied,
                _ => CliErrorKind::CreateDirFailed(e),
            },
            path: Some(p.to_path_buf()),
            context: context.to_string(),
        })));
    }
    normalize_path(p, true, context)
}

/// Parse and validate a port value in the range 1..=65535
pub fn parse_port(value: &str, context: &str) -> KrikResult<u16> {
    match value.parse::<u16>() {
        Ok(port) if port >= 1 => Ok(port),
        _ => Err(KrikError::Cli(Box::new(CliError {
            kind: CliErrorKind::InvalidPort(value.to_string()),
            path: None,
            context: context.to_string(),
        }))),
    }
}

/// Validate an optional theme directory, falling back to default if None provided, and return absolute path.
pub fn validate_theme_dir<P: AsRef<Path>>(
    opt_dir: Option<P>,
    context: &str,
) -> KrikResult<Option<PathBuf>> {
    match opt_dir {
        Some(dir) => {
            let p = dir.as_ref();
            if !p.exists() {
                return Err(KrikError::Cli(Box::new(CliError {
                    kind: CliErrorKind::ThemeNotFound,
                    path: Some(p.to_path_buf()),
                    context: context.to_string(),
                })));
            }
            Ok(Some(normalize_path(p, true, context)?))
        }
        None => Ok(None),
    }
}