Struct TexmfResources 

pub struct TexmfResources { /* private fields */ }

Resource provider over a TeX Live texmf-dist tree by exact file name, through its ls-R index.

Implementations

impl TexmfResources

pub fn from_root(root: impl Into<PathBuf>) -> Result<Self, TexmfError>

Reads the ls-R index of root, a texmf-dist directory.

pub fn discover() -> Result<Self, TexmfError>

Finds the tree through MATHTEX_TEXMF_ROOT, else kpsewhich -var-value TEXMFDIST.

Examples found in repository

examples/bake_format.rs (line 17)

fn main() -> ExitCode {
    let mut args = std::env::args_os().skip(1);
    let (Some(output), None) = (args.next().map(PathBuf::from), args.next()) else {
        eprintln!("usage: bake_format <output.pkg>");
        return ExitCode::FAILURE;
    };
    let texmf = match TexmfResources::discover() {
        Ok(texmf) => texmf,
        Err(error) => {
            eprintln!("bake_format: {error}");
            return ExitCode::FAILURE;
        }
    };
    let fonts = ResourceFontLoader::new(&texmf);
    let format = match FormatBuilder::new(PREAMBLE)
        .kernel("latex.ltx")
        .build(&texmf, &fonts)
    {
        Ok(format) => format,
        Err(error) => {
            eprintln!("bake_format: {error}");
            return ExitCode::FAILURE;
        }
    };
    if let Err(error) = std::fs::write(&output, &format) {
        eprintln!("bake_format: cannot write {}: {error}", output.display());
        return ExitCode::FAILURE;
    }
    eprintln!(
        "bake_format: wrote {} bytes to {}",
        format.len(),
        output.display()
    );
    ExitCode::SUCCESS
}

pub fn root(&self) -> &Path

The tree’s root directory.

pub fn len(&self) -> usize

Number of distinct file names in the index.

pub fn is_empty(&self) -> bool

Whether the index holds no file names, never true for a provider that was built.

pub fn resolve(&self, request: &ResourceRequest) -> Option<PathBuf>

The file a request names, found in the highest priority directory of its search path.

Trait Implementations

impl Clone for TexmfResources

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 TexmfResources

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

Formats the value using the given formatter.

impl ResourceProvider for TexmfResources

fn read_request( &self, request: &ResourceRequest, ) -> Result<Resource, ResourceError>

Resolves the file request names, by its exact name, the engine tries suffixed names itself.

fn read( &self, name: &str, kind: ResourceKind, ) -> Result<Resource, ResourceError>

Resolves name as a resource of the given kind.