markupwright 0.1.3

Template-driven workspace documentation generator
Documentation
use std::path::{Path, PathBuf};

#[derive(Debug, thiserror::Error)]
#[error("failed to walk repository {}: {source}", root.display())]
pub(crate) struct Error {
    root: PathBuf,
    #[source]
    source: ignore::Error,
}

#[derive(Debug)]
pub(crate) struct WalkReport {
    files: Vec<PathBuf>,
    failures: Vec<Error>,
}

impl WalkReport {
    #[must_use]
    pub(crate) fn into_parts(self) -> (Vec<PathBuf>, Vec<Error>) {
        (self.files, self.failures)
    }
}

#[must_use]
pub(crate) fn workspace_source_files(root: &Path) -> WalkReport {
    let git_directory = root.join(".git");
    let cache_directory = root.join(crate::layout::CACHE);
    let mut builder = ignore::WalkBuilder::new(root);

    builder
        .hidden(false)
        .parents(true)
        .git_ignore(true)
        .require_git(false)
        .git_global(false)
        .git_exclude(false)
        .filter_entry(move |entry| {
            !entry.path().starts_with(&git_directory) && !entry.path().starts_with(&cache_directory)
        });

    let mut files = Vec::new();
    let mut failures = Vec::new();

    for entry in builder.build() {
        match entry {
            Ok(entry) if entry.file_type().is_some_and(|kind| kind.is_file()) => {
                files.push(entry.into_path());
            }

            Ok(_) => {}

            Err(source) => failures.push(Error {
                root: root.to_path_buf(),
                source,
            }),
        }
    }

    files.sort();
    failures.sort_by_cached_key(ToString::to_string);

    WalkReport { files, failures }
}