blob: 1d308df00ef75a65eb817c7d0dc9b1a77a6ae404 [file] [log] [blame]
Roozbeh Pournader0e969e22016-03-09 23:08:45 -08001#!/usr/bin/env python
2
3import collections
Roozbeh Pournader5dde0872016-03-31 13:54:56 -07004import copy
Roozbeh Pournader0e969e22016-03-09 23:08:45 -08005import glob
6from os import path
Seigo Nonaka56811242021-04-16 00:11:43 -07007import re
Roozbeh Pournader0e969e22016-03-09 23:08:45 -08008import sys
9from xml.etree import ElementTree
10
11from fontTools import ttLib
12
Roozbeh Pournader5dde0872016-03-31 13:54:56 -070013EMOJI_VS = 0xFE0F
14
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080015LANG_TO_SCRIPT = {
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070016 'as': 'Beng',
Roozbeh Pournader7e04dd12017-10-13 17:41:31 -070017 'be': 'Cyrl',
Roozbeh Pournader033b2222017-02-22 18:53:39 -080018 'bg': 'Cyrl',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070019 'bn': 'Beng',
Roozbeh Pournader033b2222017-02-22 18:53:39 -080020 'cu': 'Cyrl',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070021 'cy': 'Latn',
22 'da': 'Latn',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080023 'de': 'Latn',
24 'en': 'Latn',
25 'es': 'Latn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070026 'et': 'Latn',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080027 'eu': 'Latn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070028 'fr': 'Latn',
29 'ga': 'Latn',
30 'gu': 'Gujr',
31 'hi': 'Deva',
32 'hr': 'Latn',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080033 'hu': 'Latn',
34 'hy': 'Armn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070035 'ja': 'Jpan',
36 'kn': 'Knda',
37 'ko': 'Kore',
Roozbeh Pournader7e04dd12017-10-13 17:41:31 -070038 'la': 'Latn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070039 'ml': 'Mlym',
40 'mn': 'Cyrl',
41 'mr': 'Deva',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080042 'nb': 'Latn',
43 'nn': 'Latn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070044 'or': 'Orya',
45 'pa': 'Guru',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080046 'pt': 'Latn',
Jungshik Shin6c4f9e02016-03-19 09:32:34 -070047 'sl': 'Latn',
48 'ta': 'Taml',
49 'te': 'Telu',
50 'tk': 'Latn',
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080051}
52
53def lang_to_script(lang_code):
54 lang = lang_code.lower()
55 while lang not in LANG_TO_SCRIPT:
56 hyphen_idx = lang.rfind('-')
57 assert hyphen_idx != -1, (
58 'We do not know what script the "%s" language is written in.'
59 % lang_code)
60 assumed_script = lang[hyphen_idx+1:]
61 if len(assumed_script) == 4 and assumed_script.isalpha():
62 # This is actually the script
63 return assumed_script.title()
64 lang = lang[:hyphen_idx]
65 return LANG_TO_SCRIPT[lang]
66
67
Roozbeh Pournader5dde0872016-03-31 13:54:56 -070068def printable(inp):
69 if type(inp) is set: # set of character sequences
70 return '{' + ', '.join([printable(seq) for seq in inp]) + '}'
71 if type(inp) is tuple: # character sequence
72 return '<' + (', '.join([printable(ch) for ch in inp])) + '>'
73 else: # single character
74 return 'U+%04X' % inp
75
76
77def open_font(font):
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080078 font_file, index = font
79 font_path = path.join(_fonts_dir, font_file)
80 if index is not None:
Roozbeh Pournader5dde0872016-03-31 13:54:56 -070081 return ttLib.TTFont(font_path, fontNumber=index)
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080082 else:
Roozbeh Pournader5dde0872016-03-31 13:54:56 -070083 return ttLib.TTFont(font_path)
84
85
86def get_best_cmap(font):
87 ttfont = open_font(font)
Roozbeh Pournader0e969e22016-03-09 23:08:45 -080088 all_unicode_cmap = None
89 bmp_cmap = None
90 for cmap in ttfont['cmap'].tables:
91 specifier = (cmap.format, cmap.platformID, cmap.platEncID)
92 if specifier == (4, 3, 1):
93 assert bmp_cmap is None, 'More than one BMP cmap in %s' % (font, )
94 bmp_cmap = cmap
95 elif specifier == (12, 3, 10):
96 assert all_unicode_cmap is None, (
97 'More than one UCS-4 cmap in %s' % (font, ))
98 all_unicode_cmap = cmap
99
100 return all_unicode_cmap.cmap if all_unicode_cmap else bmp_cmap.cmap
101
102
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700103def get_variation_sequences_cmap(font):
104 ttfont = open_font(font)
105 vs_cmap = None
106 for cmap in ttfont['cmap'].tables:
107 specifier = (cmap.format, cmap.platformID, cmap.platEncID)
108 if specifier == (14, 0, 5):
109 assert vs_cmap is None, 'More than one VS cmap in %s' % (font, )
110 vs_cmap = cmap
111 return vs_cmap
112
113
114def get_emoji_map(font):
115 # Add normal characters
116 emoji_map = copy.copy(get_best_cmap(font))
117 reverse_cmap = {glyph: code for code, glyph in emoji_map.items()}
118
119 # Add variation sequences
120 vs_dict = get_variation_sequences_cmap(font).uvsDict
121 for vs in vs_dict:
122 for base, glyph in vs_dict[vs]:
123 if glyph is None:
124 emoji_map[(base, vs)] = emoji_map[base]
125 else:
126 emoji_map[(base, vs)] = glyph
127
128 # Add GSUB rules
129 ttfont = open_font(font)
130 for lookup in ttfont['GSUB'].table.LookupList.Lookup:
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700131 if lookup.LookupType != 4:
132 # Other lookups are used in the emoji font for fallback.
133 # We ignore them for now.
134 continue
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700135 for subtable in lookup.SubTable:
136 ligatures = subtable.ligatures
137 for first_glyph in ligatures:
138 for ligature in ligatures[first_glyph]:
139 sequence = [first_glyph] + ligature.Component
140 sequence = [reverse_cmap[glyph] for glyph in sequence]
141 sequence = tuple(sequence)
142 # Make sure no starting subsequence of 'sequence' has been
143 # seen before.
144 for sub_len in range(2, len(sequence)+1):
145 subsequence = sequence[:sub_len]
146 assert subsequence not in emoji_map
147 emoji_map[sequence] = ligature.LigGlyph
148
149 return emoji_map
150
151
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800152def assert_font_supports_any_of_chars(font, chars):
153 best_cmap = get_best_cmap(font)
154 for char in chars:
155 if char in best_cmap:
156 return
157 sys.exit('None of characters in %s were found in %s' % (chars, font))
158
159
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700160def assert_font_supports_all_of_chars(font, chars):
161 best_cmap = get_best_cmap(font)
162 for char in chars:
163 assert char in best_cmap, (
164 'U+%04X was not found in %s' % (char, font))
165
166
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700167def assert_font_supports_none_of_chars(font, chars, fallbackName):
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700168 best_cmap = get_best_cmap(font)
169 for char in chars:
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700170 if fallbackName:
171 assert char not in best_cmap, 'U+%04X was found in %s' % (char, font)
172 else:
173 assert char not in best_cmap, (
174 'U+%04X was found in %s in fallback %s' % (char, font, fallbackName))
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700175
176
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700177def assert_font_supports_all_sequences(font, sequences):
178 vs_dict = get_variation_sequences_cmap(font).uvsDict
179 for base, vs in sorted(sequences):
180 assert vs in vs_dict and (base, None) in vs_dict[vs], (
181 '<U+%04X, U+%04X> was not found in %s' % (base, vs, font))
182
183
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800184def check_hyphens(hyphens_dir):
185 # Find all the scripts that need automatic hyphenation
186 scripts = set()
187 for hyb_file in glob.iglob(path.join(hyphens_dir, '*.hyb')):
188 hyb_file = path.basename(hyb_file)
189 assert hyb_file.startswith('hyph-'), (
190 'Unknown hyphenation file %s' % hyb_file)
191 lang_code = hyb_file[hyb_file.index('-')+1:hyb_file.index('.')]
192 scripts.add(lang_to_script(lang_code))
193
194 HYPHENS = {0x002D, 0x2010}
195 for script in scripts:
196 fonts = _script_to_font_map[script]
197 assert fonts, 'No fonts found for the "%s" script' % script
198 for font in fonts:
199 assert_font_supports_any_of_chars(font, HYPHENS)
200
201
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700202class FontRecord(object):
Seigo Nonaka56811242021-04-16 00:11:43 -0700203 def __init__(self, name, psName, scripts, variant, weight, style, fallback_for, font):
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700204 self.name = name
Seigo Nonaka56811242021-04-16 00:11:43 -0700205 self.psName = psName
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700206 self.scripts = scripts
207 self.variant = variant
208 self.weight = weight
209 self.style = style
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700210 self.fallback_for = fallback_for
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700211 self.font = font
212
213
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800214def parse_fonts_xml(fonts_xml_path):
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700215 global _script_to_font_map, _fallback_chains, _all_fonts
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800216 _script_to_font_map = collections.defaultdict(set)
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700217 _fallback_chains = {}
218 _all_fonts = []
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800219 tree = ElementTree.parse(fonts_xml_path)
Seigo Nonaka9092dc22017-01-06 16:54:52 +0900220 families = tree.findall('family')
221 # Minikin supports up to 254 but users can place their own font at the first
222 # place. Thus, 253 is the maximum allowed number of font families in the
223 # default collection.
224 assert len(families) < 254, (
225 'System font collection can contains up to 253 font families.')
226 for family in families:
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800227 name = family.get('name')
228 variant = family.get('variant')
229 langs = family.get('lang')
230 if name:
231 assert variant is None, (
232 'No variant expected for LGC font %s.' % name)
233 assert langs is None, (
234 'No language expected for LGC fonts %s.' % name)
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700235 assert name not in _fallback_chains, 'Duplicated name entry %s' % name
236 _fallback_chains[name] = []
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800237 else:
238 assert variant in {None, 'elegant', 'compact'}, (
239 'Unexpected value for variant: %s' % variant)
240
Seigo Nonaka56811242021-04-16 00:11:43 -0700241 trim_re = re.compile(r"^[ \n\r\t]*(.+)[ \n\r\t]*$")
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700242 for family in families:
243 name = family.get('name')
244 variant = family.get('variant')
245 langs = family.get('lang')
246
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800247 if langs:
248 langs = langs.split()
249 scripts = {lang_to_script(lang) for lang in langs}
250 else:
251 scripts = set()
252
253 for child in family:
254 assert child.tag == 'font', (
255 'Unknown tag <%s>' % child.tag)
Jungshik Shin88b11142017-03-17 14:56:17 -0700256 font_file = child.text.rstrip()
Seigo Nonaka56811242021-04-16 00:11:43 -0700257
258 m = trim_re.match(font_file)
259 font_file = m.group(1)
260
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800261 weight = int(child.get('weight'))
262 assert weight % 100 == 0, (
263 'Font weight "%d" is not a multiple of 100.' % weight)
264
265 style = child.get('style')
266 assert style in {'normal', 'italic'}, (
267 'Unknown style "%s"' % style)
268
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700269 fallback_for = child.get('fallbackFor')
270
271 assert not name or not fallback_for, (
272 'name and fallbackFor cannot be present at the same time')
273 assert not fallback_for or fallback_for in _fallback_chains, (
274 'Unknown fallback name: %s' % fallback_for)
275
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800276 index = child.get('index')
277 if index:
278 index = int(index)
279
Seigo Nonaka56811242021-04-16 00:11:43 -0700280 if not path.exists(path.join(_fonts_dir, m.group(1))):
Seigo Nonaka1403ff22018-01-18 17:24:31 -0800281 continue # Missing font is a valid case. Just ignore the missing font files.
282
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700283 record = FontRecord(
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800284 name,
Seigo Nonaka56811242021-04-16 00:11:43 -0700285 child.get('postScriptName'),
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800286 frozenset(scripts),
287 variant,
288 weight,
289 style,
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700290 fallback_for,
291 (font_file, index))
292
293 _all_fonts.append(record)
294
295 if not fallback_for:
296 if not name or name == 'sans-serif':
Haibo Huang715857d2020-03-05 11:58:47 -0800297 for _, fallback in _fallback_chains.items():
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700298 fallback.append(record)
299 else:
300 _fallback_chains[name].append(record)
301 else:
302 _fallback_chains[fallback_for].append(record)
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800303
304 if name: # non-empty names are used for default LGC fonts
305 map_scripts = {'Latn', 'Grek', 'Cyrl'}
306 else:
307 map_scripts = scripts
308 for script in map_scripts:
309 _script_to_font_map[script].add((font_file, index))
310
311
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700312def check_emoji_coverage(all_emoji, equivalent_emoji):
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700313 emoji_font = get_emoji_font()
314 check_emoji_font_coverage(emoji_font, all_emoji, equivalent_emoji)
Doug Feltf874a192016-07-08 17:42:15 -0700315
316
317def get_emoji_font():
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700318 emoji_fonts = [
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700319 record.font for record in _all_fonts
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700320 if 'Zsye' in record.scripts]
Roozbeh Pournader27ec3ac2016-03-31 13:05:32 -0700321 assert len(emoji_fonts) == 1, 'There are %d emoji fonts.' % len(emoji_fonts)
Doug Feltf874a192016-07-08 17:42:15 -0700322 return emoji_fonts[0]
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700323
Doug Feltf874a192016-07-08 17:42:15 -0700324
325def check_emoji_font_coverage(emoji_font, all_emoji, equivalent_emoji):
326 coverage = get_emoji_map(emoji_font)
Rod Se34a19d2020-03-16 00:01:15 -0700327
328 errors = []
329
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700330 for sequence in all_emoji:
Rod Se34a19d2020-03-16 00:01:15 -0700331 if not sequence in coverage:
332 errors.append('%s is not supported in the emoji font.' % printable(sequence))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700333
334 for sequence in coverage:
335 if sequence in {0x0000, 0x000D, 0x0020}:
336 # The font needs to support a few extra characters, which is OK
337 continue
Rod Se34a19d2020-03-16 00:01:15 -0700338 if sequence not in all_emoji:
339 errors.append('%s support unexpected in the emoji font.' % printable(sequence))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700340
Haibo Huang715857d2020-03-05 11:58:47 -0800341 for first, second in equivalent_emoji.items():
Rod Se34a19d2020-03-16 00:01:15 -0700342 if first not in coverage or second not in coverage:
343 continue # sequence will be reported missing
344 if coverage[first] != coverage[second]:
345 errors.append('%s and %s should map to the same glyph.' % (
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700346 printable(first),
347 printable(second)))
348
349 for glyph in set(coverage.values()):
350 maps_to_glyph = [seq for seq in coverage if coverage[seq] == glyph]
351 if len(maps_to_glyph) > 1:
352 # There are more than one sequences mapping to the same glyph. We
353 # need to make sure they were expected to be equivalent.
354 equivalent_seqs = set()
355 for seq in maps_to_glyph:
356 equivalent_seq = seq
357 while equivalent_seq in equivalent_emoji:
358 equivalent_seq = equivalent_emoji[equivalent_seq]
359 equivalent_seqs.add(equivalent_seq)
Rod Se34a19d2020-03-16 00:01:15 -0700360 if len(equivalent_seqs) != 1:
361 errors.append('The sequences %s should not result in the same glyph %s' % (
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700362 printable(equivalent_seqs),
363 glyph))
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700364
Rod Se34a19d2020-03-16 00:01:15 -0700365 assert not errors, '%d emoji font errors:\n%s\n%d emoji font coverage errors' % (len(errors), '\n'.join(errors), len(errors))
366
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700367
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700368def check_emoji_defaults(default_emoji):
369 missing_text_chars = _emoji_properties['Emoji'] - default_emoji
Haibo Huang715857d2020-03-05 11:58:47 -0800370 for name, fallback_chain in _fallback_chains.items():
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700371 emoji_font_seen = False
372 for record in fallback_chain:
373 if 'Zsye' in record.scripts:
374 emoji_font_seen = True
375 # No need to check the emoji font
376 continue
377 # For later fonts, we only check them if they have a script
378 # defined, since the defined script may get them to a higher
379 # score even if they appear after the emoji font. However,
380 # we should skip checking the text symbols font, since
381 # symbol fonts should be able to override the emoji display
382 # style when 'Zsym' is explicitly specified by the user.
383 if emoji_font_seen and (not record.scripts or 'Zsym' in record.scripts):
384 continue
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700385
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700386 # Check default emoji-style characters
Haibo Huang715857d2020-03-05 11:58:47 -0800387 assert_font_supports_none_of_chars(record.font, default_emoji, name)
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700388
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700389 # Mark default text-style characters appearing in fonts above the emoji
390 # font as seen
391 if not emoji_font_seen:
392 missing_text_chars -= set(get_best_cmap(record.font))
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700393
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700394 # Noto does not have monochrome glyphs for Unicode 7.0 wingdings and
395 # webdings yet.
396 missing_text_chars -= _chars_by_age['7.0']
397 assert missing_text_chars == set(), (
398 'Text style version of some emoji characters are missing: ' +
399 repr(missing_text_chars))
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700400
401
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700402# Setting reverse to true returns a dictionary that maps the values to sets of
403# characters, useful for some binary properties. Otherwise, we get a
404# dictionary that maps characters to the property values, assuming there's only
405# one property in the file.
406def parse_unicode_datafile(file_path, reverse=False):
407 if reverse:
408 output_dict = collections.defaultdict(set)
409 else:
410 output_dict = {}
411 with open(file_path) as datafile:
412 for line in datafile:
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700413 if '#' in line:
414 line = line[:line.index('#')]
415 line = line.strip()
416 if not line:
417 continue
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700418
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700419 chars, prop = line.split(';')[:2]
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700420 chars = chars.strip()
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700421 prop = prop.strip()
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700422
423 if ' ' in chars: # character sequence
424 sequence = [int(ch, 16) for ch in chars.split(' ')]
425 additions = [tuple(sequence)]
426 elif '..' in chars: # character range
427 char_start, char_end = chars.split('..')
428 char_start = int(char_start, 16)
429 char_end = int(char_end, 16)
Haibo Huang715857d2020-03-05 11:58:47 -0800430 additions = range(char_start, char_end+1)
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700431 else: # singe character
432 additions = [int(chars, 16)]
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700433 if reverse:
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700434 output_dict[prop].update(additions)
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700435 else:
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700436 for addition in additions:
437 assert addition not in output_dict
438 output_dict[addition] = prop
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700439 return output_dict
440
441
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700442def parse_emoji_variants(file_path):
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700443 emoji_set = set()
444 text_set = set()
445 with open(file_path) as datafile:
446 for line in datafile:
447 if '#' in line:
448 line = line[:line.index('#')]
449 line = line.strip()
450 if not line:
451 continue
452 sequence, description, _ = line.split(';')
453 sequence = sequence.strip().split(' ')
454 base = int(sequence[0], 16)
455 vs = int(sequence[1], 16)
456 description = description.strip()
457 if description == 'text style':
458 text_set.add((base, vs))
459 elif description == 'emoji style':
460 emoji_set.add((base, vs))
461 return text_set, emoji_set
462
463
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700464def parse_ucd(ucd_path):
465 global _emoji_properties, _chars_by_age
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700466 global _text_variation_sequences, _emoji_variation_sequences
467 global _emoji_sequences, _emoji_zwj_sequences
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700468 _emoji_properties = parse_unicode_datafile(
469 path.join(ucd_path, 'emoji-data.txt'), reverse=True)
Roozbeh Pournaderf7a68c12017-04-04 18:59:31 -0700470 emoji_properties_additions = parse_unicode_datafile(
471 path.join(ucd_path, 'additions', 'emoji-data.txt'), reverse=True)
472 for prop in emoji_properties_additions.keys():
473 _emoji_properties[prop].update(emoji_properties_additions[prop])
474
Roozbeh Pournader7b822e52016-03-16 18:55:32 -0700475 _chars_by_age = parse_unicode_datafile(
476 path.join(ucd_path, 'DerivedAge.txt'), reverse=True)
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700477 sequences = parse_emoji_variants(
478 path.join(ucd_path, 'emoji-variation-sequences.txt'))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700479 _text_variation_sequences, _emoji_variation_sequences = sequences
480 _emoji_sequences = parse_unicode_datafile(
481 path.join(ucd_path, 'emoji-sequences.txt'))
Siyamed Sinir6e06ad02017-04-19 18:18:35 -0700482 _emoji_sequences.update(parse_unicode_datafile(
483 path.join(ucd_path, 'additions', 'emoji-sequences.txt')))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700484 _emoji_zwj_sequences = parse_unicode_datafile(
485 path.join(ucd_path, 'emoji-zwj-sequences.txt'))
Roozbeh Pournader1800ba42017-03-17 18:23:23 -0700486 _emoji_zwj_sequences.update(parse_unicode_datafile(
487 path.join(ucd_path, 'additions', 'emoji-zwj-sequences.txt')))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700488
Siyamed Sinird97df5a2018-04-12 13:11:42 -0700489 exclusions = parse_unicode_datafile(path.join(ucd_path, 'additions', 'emoji-exclusions.txt'))
490 _emoji_sequences = remove_emoji_exclude(_emoji_sequences, exclusions)
491 _emoji_zwj_sequences = remove_emoji_exclude(_emoji_zwj_sequences, exclusions)
492 _emoji_variation_sequences = remove_emoji_variation_exclude(_emoji_variation_sequences, exclusions)
Qingqing Deng5e987712019-03-25 16:53:34 -0700493 # Unicode 12.0 adds Basic_Emoji in emoji-sequences.txt. We ignore them here since we are already
494 # checking the emoji presentations with emoji-variation-sequences.txt.
495 # Please refer to http://unicode.org/reports/tr51/#def_basic_emoji_set .
Haibo Huang715857d2020-03-05 11:58:47 -0800496 _emoji_sequences = {k: v for k, v in _emoji_sequences.items() if not v == 'Basic_Emoji' }
Qingqing Deng5e987712019-03-25 16:53:34 -0700497
Siyamed Sinird97df5a2018-04-12 13:11:42 -0700498
499def remove_emoji_variation_exclude(source, items):
500 return source.difference(items.keys())
501
502def remove_emoji_exclude(source, items):
503 return {k: v for k, v in source.items() if k not in items}
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700504
505def flag_sequence(territory_code):
506 return tuple(0x1F1E6 + ord(ch) - ord('A') for ch in territory_code)
507
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700508EQUIVALENT_FLAGS = {
509 flag_sequence('BV'): flag_sequence('NO'),
510 flag_sequence('CP'): flag_sequence('FR'),
511 flag_sequence('HM'): flag_sequence('AU'),
512 flag_sequence('SJ'): flag_sequence('NO'),
513 flag_sequence('UM'): flag_sequence('US'),
514}
515
516COMBINING_KEYCAP = 0x20E3
517
518LEGACY_ANDROID_EMOJI = {
519 0xFE4E5: flag_sequence('JP'),
520 0xFE4E6: flag_sequence('US'),
521 0xFE4E7: flag_sequence('FR'),
522 0xFE4E8: flag_sequence('DE'),
523 0xFE4E9: flag_sequence('IT'),
524 0xFE4EA: flag_sequence('GB'),
525 0xFE4EB: flag_sequence('ES'),
526 0xFE4EC: flag_sequence('RU'),
527 0xFE4ED: flag_sequence('CN'),
528 0xFE4EE: flag_sequence('KR'),
529 0xFE82C: (ord('#'), COMBINING_KEYCAP),
530 0xFE82E: (ord('1'), COMBINING_KEYCAP),
531 0xFE82F: (ord('2'), COMBINING_KEYCAP),
532 0xFE830: (ord('3'), COMBINING_KEYCAP),
533 0xFE831: (ord('4'), COMBINING_KEYCAP),
534 0xFE832: (ord('5'), COMBINING_KEYCAP),
535 0xFE833: (ord('6'), COMBINING_KEYCAP),
536 0xFE834: (ord('7'), COMBINING_KEYCAP),
537 0xFE835: (ord('8'), COMBINING_KEYCAP),
538 0xFE836: (ord('9'), COMBINING_KEYCAP),
539 0xFE837: (ord('0'), COMBINING_KEYCAP),
540}
541
Siyamed Sinir77a1b142018-07-12 12:02:18 -0700542# This is used to define the emoji that should have the same glyph.
543# i.e. previously we had gender based Kiss (0x1F48F), which had the same glyph
544# with Kiss: Woman, Man (0x1F469, 0x200D, 0x2764, 0x200D, 0x1F48B, 0x200D, 0x1F468)
545# in that case a valid row would be:
546# (0x1F469, 0x200D, 0x2764, 0x200D, 0x1F48B, 0x200D, 0x1F468): 0x1F48F,
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700547ZWJ_IDENTICALS = {
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700548}
549
Seigo Nonakac1808632018-05-14 13:39:40 -0700550SAME_FLAG_MAPPINGS = [
551 # Diego Garcia and British Indian Ocean Territory
552 ((0x1F1EE, 0x1F1F4), (0x1F1E9, 0x1F1EC)),
553 # St. Martin and France
554 ((0x1F1F2, 0x1F1EB), (0x1F1EB, 0x1F1F7)),
555 # Spain and Ceuta & Melilla
556 ((0x1F1EA, 0x1F1F8), (0x1F1EA, 0x1F1E6)),
557]
558
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700559ZWJ = 0x200D
Doug Feltf874a192016-07-08 17:42:15 -0700560
561def is_fitzpatrick_modifier(cp):
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700562 return 0x1F3FB <= cp <= 0x1F3FF
563
564
565def reverse_emoji(seq):
566 rev = list(reversed(seq))
567 # if there are fitzpatrick modifiers in the sequence, keep them after
568 # the emoji they modify
Haibo Huang715857d2020-03-05 11:58:47 -0800569 for i in range(1, len(rev)):
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700570 if is_fitzpatrick_modifier(rev[i-1]):
571 rev[i], rev[i-1] = rev[i-1], rev[i]
572 return tuple(rev)
Doug Feltf874a192016-07-08 17:42:15 -0700573
574
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700575def compute_expected_emoji():
576 equivalent_emoji = {}
577 sequence_pieces = set()
578 all_sequences = set()
579 all_sequences.update(_emoji_variation_sequences)
580
Raph Levien2b8b8192016-08-09 14:28:54 -0700581 # add zwj sequences not in the current emoji-zwj-sequences.txt
582 adjusted_emoji_zwj_sequences = dict(_emoji_zwj_sequences)
583 adjusted_emoji_zwj_sequences.update(_emoji_zwj_sequences)
Raph Levien2b8b8192016-08-09 14:28:54 -0700584
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700585 # Add empty flag tag sequence that is supported as fallback
586 _emoji_sequences[(0x1F3F4, 0xE007F)] = 'Emoji_Tag_Sequence'
587
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700588 for sequence in _emoji_sequences.keys():
589 sequence = tuple(ch for ch in sequence if ch != EMOJI_VS)
590 all_sequences.add(sequence)
591 sequence_pieces.update(sequence)
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700592 if _emoji_sequences.get(sequence, None) == 'Emoji_Tag_Sequence':
Roozbeh Pournader63d4d0d2017-05-18 18:38:36 -0700593 # Add reverse of all emoji ZWJ sequences, which are added to the
594 # fonts as a workaround to get the sequences work in RTL text.
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700595 # TODO: test if these are actually needed by Minikin/HarfBuzz.
596 reversed_seq = reverse_emoji(sequence)
597 all_sequences.add(reversed_seq)
598 equivalent_emoji[reversed_seq] = sequence
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700599
Raph Levien2b8b8192016-08-09 14:28:54 -0700600 for sequence in adjusted_emoji_zwj_sequences.keys():
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700601 sequence = tuple(ch for ch in sequence if ch != EMOJI_VS)
602 all_sequences.add(sequence)
603 sequence_pieces.update(sequence)
604 # Add reverse of all emoji ZWJ sequences, which are added to the fonts
605 # as a workaround to get the sequences work in RTL text.
Roozbeh Pournader3b3c78e2016-07-25 14:04:34 -0700606 reversed_seq = reverse_emoji(sequence)
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700607 all_sequences.add(reversed_seq)
608 equivalent_emoji[reversed_seq] = sequence
609
Seigo Nonakac1808632018-05-14 13:39:40 -0700610 for first, second in SAME_FLAG_MAPPINGS:
611 equivalent_emoji[first] = second
612
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700613 # Add all tag characters used in flags
614 sequence_pieces.update(range(0xE0030, 0xE0039 + 1))
615 sequence_pieces.update(range(0xE0061, 0xE007A + 1))
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700616
617 all_emoji = (
618 _emoji_properties['Emoji'] |
619 all_sequences |
620 sequence_pieces |
621 set(LEGACY_ANDROID_EMOJI.keys()))
622 default_emoji = (
623 _emoji_properties['Emoji_Presentation'] |
624 all_sequences |
625 set(LEGACY_ANDROID_EMOJI.keys()))
626
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700627 equivalent_emoji.update(EQUIVALENT_FLAGS)
628 equivalent_emoji.update(LEGACY_ANDROID_EMOJI)
629 equivalent_emoji.update(ZWJ_IDENTICALS)
Roozbeh Pournaderaa3ee8e2017-04-10 13:52:20 -0700630
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700631 for seq in _emoji_variation_sequences:
632 equivalent_emoji[seq] = seq[0]
633
634 return all_emoji, default_emoji, equivalent_emoji
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700635
636
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700637def check_compact_only_fallback():
Haibo Huang715857d2020-03-05 11:58:47 -0800638 for name, fallback_chain in _fallback_chains.items():
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700639 for record in fallback_chain:
640 if record.variant == 'compact':
641 same_script_elegants = [x for x in fallback_chain
642 if x.scripts == record.scripts and x.variant == 'elegant']
643 assert same_script_elegants, (
644 '%s must be in elegant of %s as fallback of "%s" too' % (
645 record.font, record.scripts, record.fallback_for),)
646
647
Roozbeh Pournaderbac1aec2016-07-27 13:08:37 -0700648def check_vertical_metrics():
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700649 for record in _all_fonts:
Roozbeh Pournaderbac1aec2016-07-27 13:08:37 -0700650 if record.name in ['sans-serif', 'sans-serif-condensed']:
651 font = open_font(record.font)
Roozbeh Pournaderede3a172016-07-27 16:35:12 -0700652 assert font['head'].yMax == 2163 and font['head'].yMin == -555, (
Roozbeh Pournader63d4d0d2017-05-18 18:38:36 -0700653 'yMax and yMin of %s do not match expected values.' % (
654 record.font,))
Roozbeh Pournaderede3a172016-07-27 16:35:12 -0700655
Roozbeh Pournader63d4d0d2017-05-18 18:38:36 -0700656 if record.name in ['sans-serif', 'sans-serif-condensed',
657 'serif', 'monospace']:
Roozbeh Pournaderede3a172016-07-27 16:35:12 -0700658 font = open_font(record.font)
Roozbeh Pournader63d4d0d2017-05-18 18:38:36 -0700659 assert (font['hhea'].ascent == 1900 and
660 font['hhea'].descent == -500), (
661 'ascent and descent of %s do not match expected '
662 'values.' % (record.font,))
663
664
665def check_cjk_punctuation():
666 cjk_scripts = {'Hans', 'Hant', 'Jpan', 'Kore'}
667 cjk_punctuation = range(0x3000, 0x301F + 1)
Haibo Huang715857d2020-03-05 11:58:47 -0800668 for name, fallback_chain in _fallback_chains.items():
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700669 for record in fallback_chain:
670 if record.scripts.intersection(cjk_scripts):
671 # CJK font seen. Stop checking the rest of the fonts.
672 break
673 assert_font_supports_none_of_chars(record.font, cjk_punctuation, name)
Roozbeh Pournaderbac1aec2016-07-27 13:08:37 -0700674
Seigo Nonaka56811242021-04-16 00:11:43 -0700675def getPostScriptName(font):
676 font_file, index = font
677 font_path = path.join(_fonts_dir, font_file)
678 if index is not None:
679 # Use the first font file in the collection for resolving post script name.
680 ttf = ttLib.TTFont(font_path, fontNumber=0)
681 else:
682 ttf = ttLib.TTFont(font_path)
683
684 nameTable = ttf['name']
685 for name in nameTable.names:
686 if (name.nameID == 6 and name.platformID == 3 and name.platEncID == 1
687 and name.langID == 0x0409):
688 return str(name)
689
690def check_canonical_name():
691 for record in _all_fonts:
692 file_name, index = record.font
693
694 psName = getPostScriptName(record.font)
695 if record.psName:
696 # If fonts element has postScriptName attribute, it should match with the PostScript
697 # name in the name table.
698 assert psName == record.psName, ('postScriptName attribute %s should match with %s' % (
699 record.psName, psName))
700 else:
701 # If fonts element doesn't have postScriptName attribute, the file name should match
702 # with the PostScript name in the name table.
703 assert psName == file_name[:-4], ('file name %s should match with %s' % (
704 file_name, psName))
705
Roozbeh Pournaderbac1aec2016-07-27 13:08:37 -0700706
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800707def main():
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800708 global _fonts_dir
Doug Feltf874a192016-07-08 17:42:15 -0700709 target_out = sys.argv[1]
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800710 _fonts_dir = path.join(target_out, 'fonts')
711
712 fonts_xml_path = path.join(target_out, 'etc', 'fonts.xml')
713 parse_fonts_xml(fonts_xml_path)
714
Seigo Nonaka99a7b602017-07-05 16:06:23 -0700715 check_compact_only_fallback()
716
Roozbeh Pournaderbac1aec2016-07-27 13:08:37 -0700717 check_vertical_metrics()
718
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800719 hyphens_dir = path.join(target_out, 'usr', 'hyphen-data')
720 check_hyphens(hyphens_dir)
721
Roozbeh Pournader63d4d0d2017-05-18 18:38:36 -0700722 check_cjk_punctuation()
723
Seigo Nonaka56811242021-04-16 00:11:43 -0700724 check_canonical_name()
725
Roozbeh Pournader27ec3ac2016-03-31 13:05:32 -0700726 check_emoji = sys.argv[2]
727 if check_emoji == 'true':
728 ucd_path = sys.argv[3]
729 parse_ucd(ucd_path)
Roozbeh Pournader5dde0872016-03-31 13:54:56 -0700730 all_emoji, default_emoji, equivalent_emoji = compute_expected_emoji()
731 check_emoji_coverage(all_emoji, equivalent_emoji)
732 check_emoji_defaults(default_emoji)
Roozbeh Pournaderfa1facc2016-03-16 13:53:47 -0700733
Roozbeh Pournader0e969e22016-03-09 23:08:45 -0800734
735if __name__ == '__main__':
736 main()