docs: def com_google_fonts_check_metatada_canonical_style_names(ttFont, font_metadata):
    """METADATA.pb: Font styles are named canonically?"""
    from fontbakery.constants import MacStyle
  
    def find_italic_in_name_table():
      for entry in ttFont["name"].names:
        if entry.nameID < 256 and "italic" in entry.string.decode(entry.getEncoding()).lower():
          return True
      return False
  
    def is_italic():
      return (ttFont["head"].macStyle & MacStyle.ITALIC or
              ttFont["post"].italicAngle or
              find_italic_in_name_table())
  
    if font_metadata.style not in ["italic", "normal"]:
      yield SKIP, ("This check only applies to font styles declared"
                   " as \"italic\" or \"regular\" on METADATA.pb.")
    else:
      if is_italic() and font_metadata.style != "italic":
        yield FAIL, ("The font style is {}"
                     " but it should be italic").format(font_metadata.style)
      elif not is_italic() and font_metadata.style != "normal":
        yield FAIL, ("The font style is {}"
                     " but it should be normal").format(font_metadata.style)
      else:
        yield PASS, "Font styles are named canonically."