Struct Options 

pub struct Options {
    pub progname: String,
    pub engine: String,
    pub selfautoloc: Option<PathBuf>,
    pub cache_dir: Option<PathBuf>,
    pub cnf_lines: Vec<String>,
}

Configuration for constructing a Kpathsea instance.

Fields

progname: String

The program name ($progname), e.g. lualatex.

engine: String

The engine name ($engine), e.g. luahbtex.

selfautoloc: Option<PathBuf>

The directory standing in for $SELFAUTOLOC (the directory containing the TeX binaries). None locates kpsewhich on PATH.

cache_dir: Option<PathBuf>

A directory where parsed ls-R databases are cached between runs.

cnf_lines: Vec<String>

Configuration lines given on the command line (-cnf-line); they take precedence over the texmf.cnf files.

Implementations

impl Options

pub fn lualatex() -> Self

Options for the lualatex program run by the luahbtex engine.

Examples found in repository

examples/kpsewhich.rs (line 13)

fn main() {
    let args: Vec<String> = std::env::args().collect();
    let fmt = match args.get(1).map(String::as_str) {
        Some("lua") => FileFormat::Lua,
        Some("fmt") => FileFormat::Fmt,
        Some("otf") => FileFormat::OpenType,
        Some("tfm") => FileFormat::Tfm,
        _ => FileFormat::Tex,
    };
    let mut k = Kpathsea::new(Options::lualatex()).unwrap();
    let t = std::time::Instant::now();
    let found = k.find_file(&args[2], fmt);
    eprintln!("path: {:?}", k.search_path(fmt));
    println!("{found:?} ({:?})", t.elapsed());
}

examples/kpsetime.rs (line 6)

fn main() {
    let t = std::time::Instant::now();
    let mut o = Options::lualatex();
    o.cache_dir = Some(std::env::temp_dir().join("retex-kpse-test"));
    let mut k = Kpathsea::new(o).unwrap();
    let init = t.elapsed();
    let t = std::time::Instant::now();
    for n in [
        "latex.ltx",
        "article.cls",
        "size10.clo",
        "lmroman10-regular.otf",
        "ltluatex.lua",
    ] {
        let f = if n.ends_with(".otf") {
            FileFormat::OpenType
        } else if n.ends_with(".lua") {
            FileFormat::Lua
        } else {
            FileFormat::Tex
        };
        let _ = k.find_file(n, f);
    }
    println!("init {init:?}, 5 lookups {:?}", t.elapsed());
}

Trait Implementations

impl Clone for Options

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.