peisar 1.0.0

A practical Markdown parser written in Rust
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

//! File discovery for the cache module: the extension allow-lists and the
//! recursive directory walks that feed
//! [`PeisarCache`](super::PeisarCache).

use std::env;
use std::fs;
use std::io;
use std::path::{Path, PathBuf};

/// File extensions recognized as Markdown, mirroring the
/// [`markdown-extensions`](https://github.com/sindresorhus/markdown-extensions)
/// list. Files with one of these extensions are cached as UTF-8 text.
pub const MARKDOWN_EXTENSIONS: &[&str] = &[
    "md", "markdown", "mdown", "mkdn", "mkd", "mdwn", "mkdown", "ron",
];

/// Asset extensions discovered under the assets directory: images,
/// scripts, styles, fonts, and audio/video files.
pub const ASSET_EXTENSIONS: &[&str] = &[
    // images
    "png", "jpg", "jpeg", "gif", "svg", "webp", "avif", "ico", "bmp", "tiff",
    // scripts & styles
    "js", "css", "map", // fonts
    "woff", "woff2", "ttf", "eot", // audio/video
    "mp3", "wav", "ogg", "mp4", "webm",
];

/// Subset of [`ASSET_EXTENSIONS`] considered binary: such files are cached
/// as raw bytes and never read as UTF-8. Asset extensions not listed here
/// (`js`, `css`, `map`, `svg`) are cached as text.
pub const ASSET_BINARY_EXTENSIONS: &[&str] = &[
    "png", "jpg", "jpeg", "gif", "webp", "avif", "ico", "bmp", "tiff", "woff", "woff2", "ttf",
    "eot", "mp3", "wav", "ogg", "mp4", "webm",
];

/// Recursively collect every Markdown file under `entry_dir`.
///
/// Relative directories are resolved against the current working
/// directory. Returns absolute paths; a missing or non-directory path
/// yields an empty vector.
pub fn collect_markdown_files<P: AsRef<Path>>(entry_dir: P) -> io::Result<Vec<PathBuf>> {
    let current_dir = env::current_dir().unwrap_or(PathBuf::from("."));
    let dir_path = current_dir.join(entry_dir.as_ref());
    let mut markdown_files: Vec<PathBuf> = Vec::new();

    if dir_path.is_dir() {
        for entry in fs::read_dir(&dir_path)? {
            let entry = entry?;
            let path = entry.path();

            if path.is_dir() {
                // Recurse into subdirectory; PathBuf implements AsRef<Path>
                let nested = collect_markdown_files(path)?;
                markdown_files.extend(nested);
            } else if path.is_file()
                && let Some(ext) = path.extension().and_then(|e| e.to_str())
                && MARKDOWN_EXTENSIONS.contains(&ext)
            {
                markdown_files.push(path);
            }
        }
    }

    Ok(markdown_files)
}

/// Recursively collect every asset file under `entry_dir` (see
/// [`ASSET_EXTENSIONS`]).
///
/// Relative directories are resolved against the current working
/// directory. Returns absolute paths; a missing or non-directory path
/// yields an empty vector.
pub fn collect_asset_files<P: AsRef<Path>>(entry_dir: P) -> io::Result<Vec<PathBuf>> {
    let current_dir = env::current_dir().unwrap_or(PathBuf::from("."));
    let dir_path = current_dir.join(entry_dir.as_ref());
    let mut asset_files: Vec<PathBuf> = Vec::new();

    if dir_path.is_dir() {
        for entry in fs::read_dir(&dir_path)? {
            let entry = entry?;
            let path = entry.path();

            if path.is_dir() {
                // Recurse
                let nested = collect_asset_files(path)?;
                asset_files.extend(nested);
            } else if path.is_file()
                && let Some(ext) = path.extension().and_then(|e| e.to_str())
                && ASSET_EXTENSIONS.contains(&ext)
            {
                asset_files.push(path);
            }
        }
    }

    Ok(asset_files)
}