# 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]