scan-fonts 1.0.0

Recursively list which fonts are available in a directory.
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

#![forbid(unsafe_code, future_incompatible)]
#![forbid(rust_2018_idioms, rust_2018_compatibility)]
#![deny(missing_debug_implementations, bad_style)]
#![deny(missing_docs)]
#![cfg_attr(test, deny(warnings))]
#![feature(try_from)]

//! ## Example
//! ```rust
//! use scan_fonts::scan_fonts;
//!
//! # fn main () -> Result<(), failure::Error> {
//!   for font in scan_fonts(".")? {
//!     println!("font {:?}", font);
//!   }
//! # Ok(())}
//! ```

use failure::{Error, ResultExt};
use std::{convert::AsRef, path::Path};

mod font;
mod font_style;
mod iterator;

pub use self::font::Font;
pub use self::font_style::FontStyle;
pub use self::iterator::FontIterator;

/// Recursively find all fonts in the path.
pub fn scan_fonts(path: impl AsRef<Path>) -> Result<FontIterator, Error> {
  let path = path.as_ref();
  let iter =
    FontIterator::open(path).context("Could not create font iterator")?;
  Ok(iter)
}