Struct PathDiscovery 

pub struct PathDiscovery { /* private fields */ }

Discovers fonts by walking filesystem paths.

Give it one or more root directories. It recurses into every subdirectory, checks each file’s extension, and collects anything that looks like a font.

Symlink behavior matters in practice: macOS /System/Library/Fonts contains symlinks into sealed system volumes, and many Linux setups symlink font directories across partitions. Enable follow_symlinks when you want to reach fonts behind those links. Leave it off (the default) to avoid infinite loops from circular symlinks.

Example

use typg_core::discovery::{PathDiscovery, FontDiscovery};

let fonts = PathDiscovery::new(["/usr/share/fonts", "/home/me/.fonts"])
    .follow_symlinks(true)
    .discover()?;

println!("Found {} font files", fonts.len());

Implementations

impl PathDiscovery

pub fn new<I, P>(roots: I) -> Self

where I: IntoIterator<Item = P>, P: Into<PathBuf>,

Create a discovery instance for the given root paths.

Each path should be a directory. If you pass a file path, walkdir will yield just that one file (which is fine for single-file checks).

pub fn follow_symlinks(self, follow: bool) -> Self

Enable or disable symlink following during traversal.

Trait Implementations

impl Clone for PathDiscovery

fn clone(&self) -> PathDiscovery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PathDiscovery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FontDiscovery for PathDiscovery

fn discover(&self) -> Result<Vec<TypgFontSourceRef>>

Walk all root paths and return every font file found.

The walk is resilient: directories that can’t be read (permission denied, broken symlinks, vanished network mounts) are silently skipped. One unreadable folder won’t abort a scan of thousands.

Returns Err only if a root path itself doesn’t exist — that’s likely a typo, and the caller should know about it.