Function findFont

Lib/pagebot/fonttoolbox/objects/font.py:147–186

Answers the font the has name fontName. >>> f = findFont('Roboto-Regular') >>> f >>> notSkiaFont = findFont('Skia-cannot-be-found') >>> notSkiaFont is None True >>> # Default is a font. >>> # Set RobotoFont as default. >>> notSkiaFont = find

(fontPath, default=None, lazy=True)

    return fonts

def findFont(fontPath, default=None, lazy=True):
    """Answers the font the has name fontName.

    >>> f = findFont('Roboto-Regular')
    >>> f
    <Font Roboto-Regular>
    >>> notSkiaFont = findFont('Skia-cannot-be-found')
    >>> notSkiaFont is None
    True
    >>> # Default is a font.
    >>> # Set RobotoFont as default.
    >>> notSkiaFont = findFont('Skia-cannot-be-found', default=f)
    >>> notSkiaFont is f # Found robotoFont instead
    True
    >>> # Default is a name.
    >>> f = findFont('Skia-cannot-be-found', default='Roboto-Regular') # Found default RobotoFont instead
    >>> f
    <Font Roboto-Regular>
    """
    if isinstance(fontPath, Font): # It's already a Font instance, just answer it.
        return fontPath

    fontPaths = getFontPaths() # Otherwise, let's see if we can find it by name.
    if fontPath in fontPaths:
        font = getFont(fontPaths[fontPath], lazy=lazy)
        if font is not None:
            return font

    font = getFont(fontPath)
    if font is not None:
        return font

    # A default is defined. If it's a string, try to find it. Avoid c76ircular
    # calls.
    if isinstance(default, str) and default != fontPath:
        return findFont(default, lazy=lazy)

    assert default is None or isinstance(default, Font)
    # Otherwise assume it is a Font instance or None.
    return default

def getFontPath(font):
    """Answer the font file path for @font.