ufo-gleaner

High-performance UFO/GLIF parser for Python written in Rust

Usage

Install

Install with pip:

python -m pip install ufo-gleaner

Eager Gleaner

Parse all .glif files in one go as a dictionary mapping glyph names to their attributes:

from ufo_gleaner import Gleaner, FileProvider

provider = FileProvider("/path/to/myfont.ufo")
gleaner = Gleaner(provider)

glyphs = gleaner.glean()
print(glyphs["A"]["advance"]["width"])

Lazy Font Object Model

To minimize load time and memory footprint, ufo-gleaner provides a dictionary-like font object with lazy parsing and on-demand access to GLIF files and their attributes:

from ufo_gleaner import Font, FileProvider

provider = FileProvider("/path/to/myfont.ufo")
font = Font(provider)

# Access a single glyph by name
glyph = font["A"]

# Access glyph attributes lazily
anchors = glyph.anchors

Custom Providers

Gleaner can be used with any Python object that implements a read(path: str) -> bytes method, where path is relative to the UFO root. This lets you read from both .ufo directories and .ufoz ZIP archives, for example:

import zipfile
from ufo_gleaner import Gleaner

class UfozProvider:
    def __init__(self, root):
        self.zipfile = zipfile.ZipFile(root, "r")
    
    def read(self, path: str) -> bytes:
        return self.zipfile.read(path)

provider = UfozProvider("/path/to/myfont.ufoz")
gleaner = Gleaner(provider)

glyphs = gleaner.glean()