utils: Miscellaneous UFO helper functions

This module contains miscellaneous helpers.

It is not considered part of the public ufoLib API. It does, however, define the deprecated decorator that is used elsewhere in the module.

fontTools.ufoLib.utils.deprecated(msg: str = '') → Callable[[F], F]

Decorator factory to mark functions as deprecated with given message.

>>> @deprecated("Enough!")
... def some_function():
...    "I just print 'hello world'."
...    print("hello world")
>>> some_function()
hello world
>>> some_function.__doc__ == "I just print 'hello world'."
True

fontTools.ufoLib.utils.normalizeFormatVersion(value: int | tuple[int, int] | FormatVersion | None, cls: Type[FormatVersion]) → FormatVersion

class fontTools.ufoLib.utils.BaseFormatVersion(new_class_name, /, names, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: tuple[int, int], Enum

value: tuple[int, int]

property major: int

property minor: int

classmethod default() → FormatVersion

classmethod supported_versions() → frozenset[FormatVersion]