use crate::{ExportError, WalkDirError}; use ignore::{DirEntry, Walk, WalkBuilder}; use snafu::ResultExt; use std::fmt; use std::path::{Path, PathBuf}; type Result = std::result::Result; type FilterFn = dyn Fn(&DirEntry) -> bool + Send + Sync + 'static; #[derive(Clone)] /// WalkOptions specifies how an Obsidian vault directory is scanned for eligible files to export. pub struct WalkOptions<'a> { /// The filename for ignore files, following the /// [gitignore](https://git-scm.com/docs/gitignore) syntax. /// /// By default `.export-ignore` is used. pub ignore_filename: &'a str, /// Whether to ignore hidden files. /// /// This is enabled by default. pub ignore_hidden: bool, /// Whether to honor git's ignore rules (`.gitignore` files, `.git/config/exclude`, etc) if /// the target is within a git repository. /// /// This is enabled by default. pub honor_gitignore: bool, /// An optional custom filter function which is called for each directory entry to determine if /// it should be included or not. /// /// This is passed to [`ignore::WalkBuilder::filter_entry`]. pub filter_fn: Option<&'static FilterFn>, } impl<'a> fmt::Debug for WalkOptions<'a> { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { let filter_fn_fmt = match self.filter_fn { Some(_) => "", None => "", }; f.debug_struct("WalkOptions") .field("ignore_filename", &self.ignore_filename) .field("ignore_hidden", &self.ignore_hidden) .field("honor_gitignore", &self.honor_gitignore) .field("filter_fn", &filter_fn_fmt) .finish() } } impl<'a> WalkOptions<'a> { /// Create a new set of options using default values. pub fn new() -> WalkOptions<'a> { WalkOptions { ignore_filename: ".export-ignore", ignore_hidden: true, honor_gitignore: true, filter_fn: None, } } fn build_walker(self, path: &Path) -> Walk { let mut walker = WalkBuilder::new(path); walker .standard_filters(false) .parents(true) .hidden(self.ignore_hidden) .add_custom_ignore_filename(self.ignore_filename) .require_git(true) .git_ignore(self.honor_gitignore) .git_global(self.honor_gitignore) .git_exclude(self.honor_gitignore); if let Some(filter) = self.filter_fn { walker.filter_entry(filter); } walker.build() } } impl<'a> Default for WalkOptions<'a> { fn default() -> Self { Self::new() } } /// `vault_contents` returns all of the files in an Obsidian vault located at `path` which would be /// exported when using the given [WalkOptions]. pub fn vault_contents(path: &Path, opts: WalkOptions) -> Result> { let mut contents = Vec::new(); let walker = opts.build_walker(path); for entry in walker { let entry = entry.context(WalkDirError { path })?; let path = entry.path(); let metadata = entry.metadata().context(WalkDirError { path })?; if metadata.is_dir() { continue; } contents.push(path.to_path_buf()); } Ok(contents) }