GenerateUnicodeData.cpp 42 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079
  1. /*
  2. * Copyright (c) 2021, Tim Flynn <trflynn89@pm.me>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/AllOf.h>
  7. #include <AK/Array.h>
  8. #include <AK/CharacterTypes.h>
  9. #include <AK/Find.h>
  10. #include <AK/HashMap.h>
  11. #include <AK/Optional.h>
  12. #include <AK/QuickSort.h>
  13. #include <AK/SourceGenerator.h>
  14. #include <AK/String.h>
  15. #include <AK/StringUtils.h>
  16. #include <AK/Types.h>
  17. #include <AK/Vector.h>
  18. #include <LibCore/ArgsParser.h>
  19. #include <LibCore/File.h>
  20. // Some code points are excluded from UnicodeData.txt, and instead are part of a "range" of code
  21. // points, as indicated by the "name" field. For example:
  22. // 3400;<CJK Ideograph Extension A, First>;Lo;0;L;;;;;N;;;;;
  23. // 4DBF;<CJK Ideograph Extension A, Last>;Lo;0;L;;;;;N;;;;;
  24. struct CodePointRange {
  25. u32 first;
  26. u32 last;
  27. };
  28. // SpecialCasing source: https://www.unicode.org/Public/13.0.0/ucd/SpecialCasing.txt
  29. // Field descriptions: https://www.unicode.org/reports/tr44/tr44-13.html#SpecialCasing.txt
  30. struct SpecialCasing {
  31. u32 index { 0 };
  32. u32 code_point { 0 };
  33. Vector<u32> lowercase_mapping;
  34. Vector<u32> uppercase_mapping;
  35. Vector<u32> titlecase_mapping;
  36. String locale;
  37. String condition;
  38. };
  39. // PropList source: https://www.unicode.org/Public/13.0.0/ucd/PropList.txt
  40. // Property descriptions: https://www.unicode.org/reports/tr44/tr44-13.html#PropList.txt
  41. using PropList = HashMap<String, Vector<CodePointRange>>;
  42. // PropertyAliases source: https://www.unicode.org/Public/13.0.0/ucd/PropertyAliases.txt
  43. struct Alias {
  44. String property;
  45. String alias;
  46. };
  47. // Normalization source: https://www.unicode.org/Public/13.0.0/ucd/DerivedNormalizationProps.txt
  48. // Normalization descriptions: https://www.unicode.org/reports/tr44/#DerivedNormalizationProps.txt
  49. enum class QuickCheck {
  50. Yes,
  51. No,
  52. Maybe,
  53. };
  54. struct Normalization {
  55. CodePointRange code_point_range;
  56. Vector<u32> value;
  57. QuickCheck quick_check { QuickCheck::Yes };
  58. };
  59. using NormalizationProps = HashMap<String, Vector<Normalization>>;
  60. // UnicodeData source: https://www.unicode.org/Public/13.0.0/ucd/UnicodeData.txt
  61. // Field descriptions: https://www.unicode.org/reports/tr44/tr44-13.html#UnicodeData.txt
  62. // https://www.unicode.org/reports/tr44/#General_Category_Values
  63. struct CodePointData {
  64. u32 code_point { 0 };
  65. String name;
  66. u8 canonical_combining_class { 0 };
  67. String bidi_class;
  68. String decomposition_type;
  69. Optional<i8> numeric_value_decimal;
  70. Optional<i8> numeric_value_digit;
  71. Optional<i8> numeric_value_numeric;
  72. bool bidi_mirrored { false };
  73. String unicode_1_name;
  74. String iso_comment;
  75. Optional<u32> simple_uppercase_mapping;
  76. Optional<u32> simple_lowercase_mapping;
  77. Optional<u32> simple_titlecase_mapping;
  78. Vector<u32> special_casing_indices;
  79. };
  80. struct UnicodeData {
  81. Vector<SpecialCasing> special_casing;
  82. u32 largest_casing_transform_size { 0 };
  83. u32 largest_special_casing_size { 0 };
  84. Vector<String> conditions;
  85. Vector<CodePointData> code_point_data;
  86. Vector<CodePointRange> code_point_ranges;
  87. PropList general_categories;
  88. Vector<Alias> general_category_aliases;
  89. // The Unicode standard defines additional properties (Any, Assigned, ASCII) which are not in
  90. // any UCD file. Assigned code point ranges are derived as this generator is executed.
  91. // https://unicode.org/reports/tr18/#General_Category_Property
  92. PropList prop_list {
  93. { "Any"sv, { { 0, 0x10ffff } } },
  94. { "Assigned"sv, {} },
  95. { "ASCII"sv, { { 0, 0x7f } } },
  96. };
  97. Vector<Alias> prop_aliases;
  98. PropList script_list {
  99. { "Unknown"sv, {} },
  100. };
  101. Vector<Alias> script_aliases;
  102. PropList script_extensions;
  103. // FIXME: We are not yet doing anything with this data. It will be needed for String.prototype.normalize.
  104. NormalizationProps normalization_props;
  105. };
  106. static constexpr auto s_desired_fields = Array {
  107. "canonical_combining_class"sv,
  108. "simple_uppercase_mapping"sv,
  109. "simple_lowercase_mapping"sv,
  110. };
  111. static void write_to_file_if_different(Core::File& file, StringView contents)
  112. {
  113. auto const current_contents = file.read_all();
  114. if (StringView { current_contents.bytes() } == contents)
  115. return;
  116. VERIFY(file.seek(0));
  117. VERIFY(file.truncate(0));
  118. VERIFY(file.write(contents));
  119. }
  120. static Vector<u32> parse_code_point_list(StringView const& list)
  121. {
  122. Vector<u32> code_points;
  123. auto segments = list.split_view(' ');
  124. for (auto const& code_point : segments)
  125. code_points.append(AK::StringUtils::convert_to_uint_from_hex<u32>(code_point).value());
  126. return code_points;
  127. }
  128. static CodePointRange parse_code_point_range(StringView const& list)
  129. {
  130. CodePointRange code_point_range {};
  131. if (list.contains(".."sv)) {
  132. auto segments = list.split_view(".."sv);
  133. VERIFY(segments.size() == 2);
  134. auto begin = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[0]).value();
  135. auto end = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[1]).value();
  136. code_point_range = { begin, end };
  137. } else {
  138. auto code_point = AK::StringUtils::convert_to_uint_from_hex<u32>(list).value();
  139. code_point_range = { code_point, code_point };
  140. }
  141. return code_point_range;
  142. }
  143. static void parse_special_casing(Core::File& file, UnicodeData& unicode_data)
  144. {
  145. while (file.can_read_line()) {
  146. auto line = file.read_line();
  147. if (line.is_empty() || line.starts_with('#'))
  148. continue;
  149. if (auto index = line.find('#'); index.has_value())
  150. line = line.substring(0, *index);
  151. auto segments = line.split(';', true);
  152. VERIFY(segments.size() == 5 || segments.size() == 6);
  153. SpecialCasing casing {};
  154. casing.code_point = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[0]).value();
  155. casing.lowercase_mapping = parse_code_point_list(segments[1]);
  156. casing.titlecase_mapping = parse_code_point_list(segments[2]);
  157. casing.uppercase_mapping = parse_code_point_list(segments[3]);
  158. if (auto condition = segments[4].trim_whitespace(); !condition.is_empty()) {
  159. auto conditions = condition.split(' ', true);
  160. VERIFY(conditions.size() == 1 || conditions.size() == 2);
  161. if (conditions.size() == 2) {
  162. casing.locale = move(conditions[0]);
  163. casing.condition = move(conditions[1]);
  164. } else if (all_of(conditions[0], is_ascii_lower_alpha)) {
  165. casing.locale = move(conditions[0]);
  166. } else {
  167. casing.condition = move(conditions[0]);
  168. }
  169. if (!casing.locale.is_empty())
  170. casing.locale = String::formatted("{:c}{}", to_ascii_uppercase(casing.locale[0]), casing.locale.substring_view(1));
  171. casing.condition.replace("_", "", true);
  172. if (!casing.condition.is_empty() && !unicode_data.conditions.contains_slow(casing.condition))
  173. unicode_data.conditions.append(casing.condition);
  174. }
  175. unicode_data.largest_casing_transform_size = max(unicode_data.largest_casing_transform_size, casing.lowercase_mapping.size());
  176. unicode_data.largest_casing_transform_size = max(unicode_data.largest_casing_transform_size, casing.titlecase_mapping.size());
  177. unicode_data.largest_casing_transform_size = max(unicode_data.largest_casing_transform_size, casing.uppercase_mapping.size());
  178. unicode_data.special_casing.append(move(casing));
  179. }
  180. quick_sort(unicode_data.special_casing, [](auto const& lhs, auto const& rhs) {
  181. if (lhs.code_point != rhs.code_point)
  182. return lhs.code_point < rhs.code_point;
  183. if (lhs.locale.is_empty() && !rhs.locale.is_empty())
  184. return false;
  185. if (!lhs.locale.is_empty() && rhs.locale.is_empty())
  186. return true;
  187. return lhs.locale < rhs.locale;
  188. });
  189. for (u32 i = 0; i < unicode_data.special_casing.size(); ++i)
  190. unicode_data.special_casing[i].index = i;
  191. }
  192. static void parse_prop_list(Core::File& file, PropList& prop_list, bool multi_value_property = false)
  193. {
  194. while (file.can_read_line()) {
  195. auto line = file.read_line();
  196. if (line.is_empty() || line.starts_with('#'))
  197. continue;
  198. if (auto index = line.find('#'); index.has_value())
  199. line = line.substring(0, *index);
  200. auto segments = line.split_view(';', true);
  201. VERIFY(segments.size() == 2);
  202. auto code_point_range = parse_code_point_range(segments[0].trim_whitespace());
  203. Vector<StringView> properties;
  204. if (multi_value_property)
  205. properties = segments[1].trim_whitespace().split_view(' ');
  206. else
  207. properties = { segments[1].trim_whitespace() };
  208. for (auto const& property : properties) {
  209. auto& code_points = prop_list.ensure(property.trim_whitespace());
  210. code_points.append(code_point_range);
  211. }
  212. }
  213. }
  214. static void parse_alias_list(Core::File& file, PropList const& prop_list, Vector<Alias>& prop_aliases)
  215. {
  216. String current_property;
  217. auto append_alias = [&](auto alias, auto property) {
  218. // Note: The alias files contain lines such as "Hyphen = Hyphen", which we should just skip.
  219. if (alias == property)
  220. return;
  221. // FIXME: We will, eventually, need to find where missing properties are located and parse them.
  222. if (!prop_list.contains(property))
  223. return;
  224. prop_aliases.append({ property, alias });
  225. };
  226. while (file.can_read_line()) {
  227. auto line = file.read_line();
  228. if (line.is_empty() || line.starts_with('#')) {
  229. if (line.ends_with("Properties"sv))
  230. current_property = line.substring(2);
  231. continue;
  232. }
  233. // Note: For now, we only care about Binary Property aliases for Unicode property escapes.
  234. if (current_property != "Binary Properties"sv)
  235. continue;
  236. auto segments = line.split_view(';', true);
  237. VERIFY((segments.size() == 2) || (segments.size() == 3));
  238. auto alias = segments[0].trim_whitespace();
  239. auto property = segments[1].trim_whitespace();
  240. append_alias(alias, property);
  241. if (segments.size() == 3) {
  242. alias = segments[2].trim_whitespace();
  243. append_alias(alias, property);
  244. }
  245. }
  246. }
  247. static void parse_value_alias_list(Core::File& file, StringView desired_category, Vector<String> const& value_list, Vector<Alias>& prop_aliases, bool primary_value_is_first = true)
  248. {
  249. VERIFY(file.seek(0));
  250. auto append_alias = [&](auto alias, auto value) {
  251. // Note: The value alias file contains lines such as "Ahom = Ahom", which we should just skip.
  252. if (alias == value)
  253. return;
  254. // FIXME: We will, eventually, need to find where missing properties are located and parse them.
  255. if (!value_list.contains_slow(value))
  256. return;
  257. prop_aliases.append({ value, alias });
  258. };
  259. while (file.can_read_line()) {
  260. auto line = file.read_line();
  261. if (line.is_empty() || line.starts_with('#'))
  262. continue;
  263. if (auto index = line.find('#'); index.has_value())
  264. line = line.substring(0, *index);
  265. auto segments = line.split_view(';', true);
  266. auto category = segments[0].trim_whitespace();
  267. if (category != desired_category)
  268. continue;
  269. VERIFY((segments.size() == 3) || (segments.size() == 4));
  270. auto value = primary_value_is_first ? segments[1].trim_whitespace() : segments[2].trim_whitespace();
  271. auto alias = primary_value_is_first ? segments[2].trim_whitespace() : segments[1].trim_whitespace();
  272. append_alias(alias, value);
  273. if (segments.size() == 4) {
  274. alias = segments[3].trim_whitespace();
  275. append_alias(alias, value);
  276. }
  277. }
  278. }
  279. static void parse_normalization_props(Core::File& file, UnicodeData& unicode_data)
  280. {
  281. while (file.can_read_line()) {
  282. auto line = file.read_line();
  283. if (line.is_empty() || line.starts_with('#'))
  284. continue;
  285. if (auto index = line.find('#'); index.has_value())
  286. line = line.substring(0, *index);
  287. auto segments = line.split_view(';', true);
  288. VERIFY((segments.size() == 2) || (segments.size() == 3));
  289. auto code_point_range = parse_code_point_range(segments[0].trim_whitespace());
  290. auto property = segments[1].trim_whitespace().to_string();
  291. Vector<u32> value;
  292. QuickCheck quick_check = QuickCheck::Yes;
  293. if (segments.size() == 3) {
  294. auto value_or_quick_check = segments[2].trim_whitespace();
  295. if ((value_or_quick_check == "N"sv))
  296. quick_check = QuickCheck::No;
  297. else if ((value_or_quick_check == "M"sv))
  298. quick_check = QuickCheck::Maybe;
  299. else
  300. value = parse_code_point_list(value_or_quick_check);
  301. }
  302. auto& normalizations = unicode_data.normalization_props.ensure(property);
  303. normalizations.append({ code_point_range, move(value), quick_check });
  304. auto& prop_list = unicode_data.prop_list.ensure(property);
  305. prop_list.append(move(code_point_range));
  306. }
  307. }
  308. static void parse_unicode_data(Core::File& file, UnicodeData& unicode_data)
  309. {
  310. Optional<u32> code_point_range_start;
  311. auto& assigned_code_points = unicode_data.prop_list.find("Assigned"sv)->value;
  312. Optional<u32> assigned_code_point_range_start = 0;
  313. u32 previous_code_point = 0;
  314. while (file.can_read_line()) {
  315. auto line = file.read_line();
  316. if (line.is_empty())
  317. continue;
  318. auto segments = line.split(';', true);
  319. VERIFY(segments.size() == 15);
  320. CodePointData data {};
  321. data.code_point = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[0]).value();
  322. data.name = move(segments[1]);
  323. data.canonical_combining_class = AK::StringUtils::convert_to_uint<u8>(segments[3]).value();
  324. data.bidi_class = move(segments[4]);
  325. data.decomposition_type = move(segments[5]);
  326. data.numeric_value_decimal = AK::StringUtils::convert_to_int<i8>(segments[6]);
  327. data.numeric_value_digit = AK::StringUtils::convert_to_int<i8>(segments[7]);
  328. data.numeric_value_numeric = AK::StringUtils::convert_to_int<i8>(segments[8]);
  329. data.bidi_mirrored = segments[9] == "Y"sv;
  330. data.unicode_1_name = move(segments[10]);
  331. data.iso_comment = move(segments[11]);
  332. data.simple_uppercase_mapping = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[12]);
  333. data.simple_lowercase_mapping = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[13]);
  334. data.simple_titlecase_mapping = AK::StringUtils::convert_to_uint_from_hex<u32>(segments[14]);
  335. if (!assigned_code_point_range_start.has_value())
  336. assigned_code_point_range_start = data.code_point;
  337. if (data.name.starts_with("<"sv) && data.name.ends_with(", First>")) {
  338. VERIFY(!code_point_range_start.has_value() && assigned_code_point_range_start.has_value());
  339. code_point_range_start = data.code_point;
  340. data.name = data.name.substring(1, data.name.length() - 9);
  341. assigned_code_points.append({ *assigned_code_point_range_start, previous_code_point });
  342. assigned_code_point_range_start.clear();
  343. } else if (data.name.starts_with("<"sv) && data.name.ends_with(", Last>")) {
  344. VERIFY(code_point_range_start.has_value());
  345. CodePointRange code_point_range { *code_point_range_start, data.code_point };
  346. unicode_data.code_point_ranges.append(code_point_range);
  347. assigned_code_points.append(code_point_range);
  348. data.name = data.name.substring(1, data.name.length() - 8);
  349. code_point_range_start.clear();
  350. } else if ((data.code_point > 0) && (data.code_point - previous_code_point) != 1) {
  351. VERIFY(assigned_code_point_range_start.has_value());
  352. assigned_code_points.append({ *assigned_code_point_range_start, previous_code_point });
  353. assigned_code_point_range_start = data.code_point;
  354. }
  355. for (auto const& casing : unicode_data.special_casing) {
  356. if (casing.code_point == data.code_point)
  357. data.special_casing_indices.append(casing.index);
  358. }
  359. unicode_data.largest_special_casing_size = max(unicode_data.largest_special_casing_size, data.special_casing_indices.size());
  360. previous_code_point = data.code_point;
  361. unicode_data.code_point_data.append(move(data));
  362. }
  363. }
  364. static void generate_unicode_data_header(Core::File& file, UnicodeData& unicode_data)
  365. {
  366. StringBuilder builder;
  367. SourceGenerator generator { builder };
  368. generator.set("casing_transform_size", String::number(unicode_data.largest_casing_transform_size));
  369. generator.set("special_casing_size", String::number(unicode_data.largest_special_casing_size));
  370. auto generate_enum = [&](StringView name, StringView default_, Vector<String> values, Vector<Alias> aliases = {}) {
  371. quick_sort(values);
  372. quick_sort(aliases, [](auto& alias1, auto& alias2) { return alias1.alias < alias2.alias; });
  373. generator.set("name", name);
  374. generator.set("underlying", String::formatted("{}UnderlyingType", name));
  375. generator.append(R"~~~(
  376. using @underlying@ = u8;
  377. enum class @name@ : @underlying@ {)~~~");
  378. if (!default_.is_empty()) {
  379. generator.set("default", default_);
  380. generator.append(R"~~~(
  381. @default@,)~~~");
  382. }
  383. for (auto const& value : values) {
  384. generator.set("value", value);
  385. generator.append(R"~~~(
  386. @value@,)~~~");
  387. }
  388. for (auto const& alias : aliases) {
  389. generator.set("alias", alias.alias);
  390. generator.set("value", alias.property);
  391. generator.append(R"~~~(
  392. @alias@ = @value@,)~~~");
  393. }
  394. generator.append(R"~~~(
  395. };
  396. )~~~");
  397. };
  398. generator.append(R"~~~(
  399. #pragma once
  400. #include <AK/Optional.h>
  401. #include <AK/Types.h>
  402. #include <LibUnicode/Forward.h>
  403. #include <LibUnicode/UnicodeLocale.h>
  404. namespace Unicode {
  405. )~~~");
  406. generate_enum("Condition"sv, "None"sv, move(unicode_data.conditions));
  407. generate_enum("GeneralCategory"sv, {}, unicode_data.general_categories.keys(), unicode_data.general_category_aliases);
  408. generate_enum("Property"sv, {}, unicode_data.prop_list.keys(), unicode_data.prop_aliases);
  409. generate_enum("Script"sv, {}, unicode_data.script_list.keys(), unicode_data.script_aliases);
  410. generator.append(R"~~~(
  411. struct SpecialCasing {
  412. u32 code_point { 0 };
  413. u32 lowercase_mapping[@casing_transform_size@];
  414. u32 lowercase_mapping_size { 0 };
  415. u32 uppercase_mapping[@casing_transform_size@];
  416. u32 uppercase_mapping_size { 0 };
  417. u32 titlecase_mapping[@casing_transform_size@];
  418. u32 titlecase_mapping_size { 0 };
  419. Locale locale { Locale::None };
  420. Condition condition { Condition::None };
  421. };
  422. struct UnicodeData {
  423. u32 code_point;)~~~");
  424. auto append_field = [&](StringView type, StringView name) {
  425. if (!s_desired_fields.span().contains_slow(name))
  426. return;
  427. generator.set("type", type);
  428. generator.set("name", name);
  429. generator.append(R"~~~(
  430. @type@ @name@;)~~~");
  431. };
  432. // Note: For compile-time performance, only primitive types are used.
  433. append_field("char const*"sv, "name"sv);
  434. append_field("u8"sv, "canonical_combining_class"sv);
  435. append_field("char const*"sv, "bidi_class"sv);
  436. append_field("char const*"sv, "decomposition_type"sv);
  437. append_field("i8"sv, "numeric_value_decimal"sv);
  438. append_field("i8"sv, "numeric_value_digit"sv);
  439. append_field("i8"sv, "numeric_value_numeric"sv);
  440. append_field("bool"sv, "bidi_mirrored"sv);
  441. append_field("char const*"sv, "unicode_1_name"sv);
  442. append_field("char const*"sv, "iso_comment"sv);
  443. append_field("u32"sv, "simple_uppercase_mapping"sv);
  444. append_field("u32"sv, "simple_lowercase_mapping"sv);
  445. append_field("u32"sv, "simple_titlecase_mapping"sv);
  446. generator.append(R"~~~(
  447. SpecialCasing const* special_casing[@special_casing_size@] {};
  448. u32 special_casing_size { 0 };
  449. };
  450. namespace Detail {
  451. Optional<UnicodeData> unicode_data_for_code_point(u32 code_point);
  452. bool code_point_has_general_category(u32 code_point, GeneralCategory general_category);
  453. Optional<GeneralCategory> general_category_from_string(StringView const& general_category);
  454. bool code_point_has_property(u32 code_point, Property property);
  455. Optional<Property> property_from_string(StringView const& property);
  456. bool code_point_has_script(u32 code_point, Script script);
  457. bool code_point_has_script_extension(u32 code_point, Script script);
  458. Optional<Script> script_from_string(StringView const& script);
  459. }
  460. }
  461. )~~~");
  462. write_to_file_if_different(file, generator.as_string_view());
  463. }
  464. static void generate_unicode_data_implementation(Core::File& file, UnicodeData const& unicode_data)
  465. {
  466. StringBuilder builder;
  467. SourceGenerator generator { builder };
  468. generator.set("special_casing_size", String::number(unicode_data.special_casing.size()));
  469. generator.set("code_point_data_size", String::number(unicode_data.code_point_data.size()));
  470. generator.append(R"~~~(
  471. #include <AK/Array.h>
  472. #include <AK/BinarySearch.h>
  473. #include <AK/CharacterTypes.h>
  474. #include <AK/HashMap.h>
  475. #include <AK/String.h>
  476. #include <AK/StringView.h>
  477. #include <LibUnicode/UnicodeData.h>
  478. namespace Unicode {
  479. )~~~");
  480. auto append_list_and_size = [&](auto const& list, StringView format) {
  481. if (list.is_empty()) {
  482. generator.append(", {}, 0");
  483. return;
  484. }
  485. bool first = true;
  486. generator.append(", {");
  487. for (auto const& item : list) {
  488. generator.append(first ? " " : ", ");
  489. generator.append(String::formatted(format, item));
  490. first = false;
  491. }
  492. generator.append(String::formatted(" }}, {}", list.size()));
  493. };
  494. generator.append(R"~~~(
  495. static constexpr Array<SpecialCasing, @special_casing_size@> s_special_casing { {)~~~");
  496. for (auto const& casing : unicode_data.special_casing) {
  497. generator.set("code_point", String::formatted("{:#x}", casing.code_point));
  498. generator.append(R"~~~(
  499. { @code_point@)~~~");
  500. constexpr auto format = "0x{:x}"sv;
  501. append_list_and_size(casing.lowercase_mapping, format);
  502. append_list_and_size(casing.uppercase_mapping, format);
  503. append_list_and_size(casing.titlecase_mapping, format);
  504. generator.set("locale", casing.locale.is_empty() ? "None" : casing.locale);
  505. generator.append(", Locale::@locale@");
  506. generator.set("condition", casing.condition.is_empty() ? "None" : casing.condition);
  507. generator.append(", Condition::@condition@");
  508. generator.append(" },");
  509. }
  510. generator.append(R"~~~(
  511. } };
  512. static constexpr Array<UnicodeData, @code_point_data_size@> s_unicode_data { {)~~~");
  513. auto append_field = [&](StringView name, String value) {
  514. if (!s_desired_fields.span().contains_slow(name))
  515. return;
  516. generator.set("value", move(value));
  517. generator.append(", @value@");
  518. };
  519. for (auto const& data : unicode_data.code_point_data) {
  520. generator.set("code_point", String::formatted("{:#x}", data.code_point));
  521. generator.append(R"~~~(
  522. { @code_point@)~~~");
  523. append_field("name", String::formatted("\"{}\"", data.name));
  524. append_field("canonical_combining_class", String::number(data.canonical_combining_class));
  525. append_field("bidi_class", String::formatted("\"{}\"", data.bidi_class));
  526. append_field("decomposition_type", String::formatted("\"{}\"", data.decomposition_type));
  527. append_field("numeric_value_decimal", String::number(data.numeric_value_decimal.value_or(-1)));
  528. append_field("numeric_value_digit", String::number(data.numeric_value_digit.value_or(-1)));
  529. append_field("numeric_value_numeric", String::number(data.numeric_value_numeric.value_or(-1)));
  530. append_field("bidi_mirrored", String::formatted("{}", data.bidi_mirrored));
  531. append_field("unicode_1_name", String::formatted("\"{}\"", data.unicode_1_name));
  532. append_field("iso_comment", String::formatted("\"{}\"", data.iso_comment));
  533. append_field("simple_uppercase_mapping", String::formatted("{:#x}", data.simple_uppercase_mapping.value_or(data.code_point)));
  534. append_field("simple_lowercase_mapping", String::formatted("{:#x}", data.simple_lowercase_mapping.value_or(data.code_point)));
  535. append_field("simple_titlecase_mapping", String::formatted("{:#x}", data.simple_titlecase_mapping.value_or(data.code_point)));
  536. append_list_and_size(data.special_casing_indices, "&s_special_casing[{}]"sv);
  537. generator.append(" },");
  538. }
  539. generator.append(R"~~~(
  540. } };
  541. struct CodePointRange {
  542. u32 first { 0 };
  543. u32 last { 0 };
  544. };
  545. struct CodePointRangeComparator {
  546. constexpr int operator()(u32 code_point, CodePointRange const& range)
  547. {
  548. return (code_point > range.last) - (code_point < range.first);
  549. }
  550. };
  551. )~~~");
  552. auto append_code_point_range_list = [&](String name, Vector<CodePointRange> const& ranges) {
  553. generator.set("name", name);
  554. generator.set("size", String::number(ranges.size()));
  555. generator.append(R"~~~(
  556. static constexpr Array<CodePointRange, @size@> @name@ { {
  557. )~~~");
  558. constexpr size_t max_ranges_per_row = 20;
  559. size_t ranges_in_current_row = 0;
  560. for (auto const& range : ranges) {
  561. if (ranges_in_current_row++ > 0)
  562. generator.append(" ");
  563. generator.set("first", String::formatted("{:#x}", range.first));
  564. generator.set("last", String::formatted("{:#x}", range.last));
  565. generator.append("{ @first@, @last@ },");
  566. if (ranges_in_current_row == max_ranges_per_row) {
  567. ranges_in_current_row = 0;
  568. generator.append("\n ");
  569. }
  570. }
  571. generator.append(R"~~~(
  572. } };
  573. )~~~");
  574. };
  575. auto append_prop_list = [&](StringView collection_name, StringView property_format, PropList const& property_list) {
  576. for (auto const& property : property_list) {
  577. auto name = String::formatted(property_format, property.key);
  578. append_code_point_range_list(move(name), property.value);
  579. }
  580. auto property_names = property_list.keys();
  581. quick_sort(property_names);
  582. generator.set("name", collection_name);
  583. generator.set("size", String::number(property_names.size()));
  584. generator.append(R"~~~(
  585. static constexpr Array<Span<CodePointRange const>, @size@> @name@ { {)~~~");
  586. for (auto const& property_name : property_names) {
  587. generator.set("name", String::formatted(property_format, property_name));
  588. generator.append(R"~~~(
  589. @name@.span(),)~~~");
  590. }
  591. generator.append(R"~~~(
  592. } };
  593. )~~~");
  594. };
  595. append_prop_list("s_general_categories"sv, "s_general_category_{}"sv, unicode_data.general_categories);
  596. append_prop_list("s_properties"sv, "s_property_{}"sv, unicode_data.prop_list);
  597. append_prop_list("s_scripts"sv, "s_script_{}"sv, unicode_data.script_list);
  598. append_prop_list("s_script_extensions"sv, "s_script_extension_{}"sv, unicode_data.script_extensions);
  599. generator.append(R"~~~(
  600. static HashMap<u32, UnicodeData const*> const& ensure_code_point_map()
  601. {
  602. static HashMap<u32, UnicodeData const*> code_point_to_data_map;
  603. code_point_to_data_map.ensure_capacity(s_unicode_data.size());
  604. for (auto const& unicode_data : s_unicode_data)
  605. code_point_to_data_map.set(unicode_data.code_point, &unicode_data);
  606. return code_point_to_data_map;
  607. }
  608. static Optional<u32> index_of_code_point_in_range(u32 code_point)
  609. {)~~~");
  610. for (auto const& range : unicode_data.code_point_ranges) {
  611. generator.set("first", String::formatted("{:#x}", range.first));
  612. generator.set("last", String::formatted("{:#x}", range.last));
  613. generator.append(R"~~~(
  614. if ((code_point > @first@) && (code_point < @last@))
  615. return @first@;)~~~");
  616. }
  617. generator.append(R"~~~(
  618. return {};
  619. }
  620. namespace Detail {
  621. Optional<UnicodeData> unicode_data_for_code_point(u32 code_point)
  622. {
  623. static auto const& code_point_to_data_map = ensure_code_point_map();
  624. VERIFY(is_unicode(code_point));
  625. if (auto data = code_point_to_data_map.get(code_point); data.has_value())
  626. return *(data.value());
  627. if (auto index = index_of_code_point_in_range(code_point); index.has_value()) {
  628. auto data_for_range = *(code_point_to_data_map.get(*index).value());
  629. data_for_range.simple_uppercase_mapping = code_point;
  630. data_for_range.simple_lowercase_mapping = code_point;
  631. return data_for_range;
  632. }
  633. return {};
  634. }
  635. )~~~");
  636. auto append_prop_search = [&](StringView enum_title, StringView enum_snake, StringView collection_name) {
  637. generator.set("enum_title", enum_title);
  638. generator.set("enum_snake", enum_snake);
  639. generator.set("collection_name", collection_name);
  640. generator.append(R"~~~(
  641. bool code_point_has_@enum_snake@(u32 code_point, @enum_title@ @enum_snake@)
  642. {
  643. auto index = static_cast<@enum_title@UnderlyingType>(@enum_snake@);
  644. auto const& ranges = @collection_name@.at(index);
  645. auto const* range = binary_search(ranges, code_point, nullptr, CodePointRangeComparator {});
  646. return range != nullptr;
  647. }
  648. )~~~");
  649. };
  650. auto append_from_string = [&](StringView enum_title, StringView enum_snake, PropList const& prop_list, Vector<Alias> const& aliases) {
  651. generator.set("enum_title", enum_title);
  652. generator.set("enum_snake", enum_snake);
  653. auto properties = prop_list.keys();
  654. for (auto const& alias : aliases)
  655. properties.append(alias.alias);
  656. quick_sort(properties);
  657. generator.append(R"~~~(
  658. Optional<@enum_title@> @enum_snake@_from_string(StringView const& @enum_snake@)
  659. {
  660. static HashMap<String, @enum_title@> @enum_snake@_values { {)~~~");
  661. for (auto const& property : properties) {
  662. generator.set("property", property);
  663. generator.append(R"~~~(
  664. { "@property@"sv, @enum_title@::@property@ },)~~~");
  665. }
  666. generator.append(R"~~~(
  667. } };
  668. if (auto value = @enum_snake@_values.get(@enum_snake@); value.has_value())
  669. return value.value();
  670. return {};
  671. }
  672. )~~~");
  673. };
  674. append_prop_search("GeneralCategory"sv, "general_category"sv, "s_general_categories"sv);
  675. append_from_string("GeneralCategory"sv, "general_category"sv, unicode_data.general_categories, unicode_data.general_category_aliases);
  676. append_prop_search("Property"sv, "property"sv, "s_properties"sv);
  677. append_from_string("Property"sv, "property"sv, unicode_data.prop_list, unicode_data.prop_aliases);
  678. append_prop_search("Script"sv, "script"sv, "s_scripts"sv);
  679. append_prop_search("Script"sv, "script_extension"sv, "s_script_extensions"sv);
  680. append_from_string("Script"sv, "script"sv, unicode_data.script_list, unicode_data.script_aliases);
  681. generator.append(R"~~~(
  682. }
  683. }
  684. )~~~");
  685. write_to_file_if_different(file, generator.as_string_view());
  686. }
  687. static Vector<u32> flatten_code_point_ranges(Vector<CodePointRange> const& code_points)
  688. {
  689. Vector<u32> flattened;
  690. for (auto const& range : code_points) {
  691. flattened.grow_capacity(range.last - range.first);
  692. for (u32 code_point = range.first; code_point <= range.last; ++code_point)
  693. flattened.append(code_point);
  694. }
  695. return flattened;
  696. }
  697. static Vector<CodePointRange> form_code_point_ranges(Vector<u32> code_points)
  698. {
  699. Vector<CodePointRange> ranges;
  700. u32 range_start = code_points[0];
  701. u32 range_end = range_start;
  702. for (size_t i = 1; i < code_points.size(); ++i) {
  703. u32 code_point = code_points[i];
  704. if ((code_point - range_end) == 1) {
  705. range_end = code_point;
  706. } else {
  707. ranges.append({ range_start, range_end });
  708. range_start = code_point;
  709. range_end = code_point;
  710. }
  711. }
  712. ranges.append({ range_start, range_end });
  713. return ranges;
  714. }
  715. static void sort_and_merge_code_point_ranges(Vector<CodePointRange>& code_points)
  716. {
  717. quick_sort(code_points, [](auto const& range1, auto const& range2) {
  718. return range1.first < range2.first;
  719. });
  720. for (size_t i = 0; i < code_points.size() - 1;) {
  721. if (code_points[i].last >= code_points[i + 1].first) {
  722. code_points[i].last = max(code_points[i].last, code_points[i + 1].last);
  723. code_points.remove(i + 1);
  724. } else {
  725. ++i;
  726. }
  727. }
  728. auto all_code_points = flatten_code_point_ranges(code_points);
  729. code_points = form_code_point_ranges(all_code_points);
  730. }
  731. static void populate_general_category_unions(PropList& general_categories)
  732. {
  733. // The Unicode standard defines General Category values which are not in any UCD file. These
  734. // values are simply unions of other values.
  735. // https://www.unicode.org/reports/tr44/#GC_Values_Table
  736. auto populate_union = [&](auto alias, auto categories) {
  737. auto& code_points = general_categories.ensure(alias);
  738. for (auto const& category : categories)
  739. code_points.extend(general_categories.find(category)->value);
  740. sort_and_merge_code_point_ranges(code_points);
  741. };
  742. populate_union("LC"sv, Array { "Ll"sv, "Lu"sv, "Lt"sv });
  743. populate_union("L"sv, Array { "Lu"sv, "Ll"sv, "Lt"sv, "Lm"sv, "Lo"sv });
  744. populate_union("M"sv, Array { "Mn"sv, "Mc"sv, "Me"sv });
  745. populate_union("N"sv, Array { "Nd"sv, "Nl"sv, "No"sv });
  746. populate_union("P"sv, Array { "Pc"sv, "Pd"sv, "Ps"sv, "Pe"sv, "Pi"sv, "Pf"sv, "Po"sv });
  747. populate_union("S"sv, Array { "Sm"sv, "Sc"sv, "Sk"sv, "So"sv });
  748. populate_union("Z"sv, Array { "Zs"sv, "Zl"sv, "Zp"sv });
  749. populate_union("C"sv, Array { "Cc"sv, "Cf"sv, "Cs"sv, "Co"sv, "Cn"sv });
  750. }
  751. static void normalize_script_extensions(PropList& script_extensions, PropList const& script_list, Vector<Alias> const& script_aliases)
  752. {
  753. // The ScriptExtensions UCD file lays out its code point ranges rather uniquely compared to
  754. // other files. The Script listed on each line may either be a full Script string or an aliased
  755. // abbreviation. Further, the extensions may or may not include the base Script list. Normalize
  756. // the extensions here to be keyed by the full Script name and always include the base list.
  757. auto extensions = move(script_extensions);
  758. script_extensions = script_list;
  759. for (auto const& extension : extensions) {
  760. auto it = find_if(script_aliases.begin(), script_aliases.end(), [&](auto const& alias) { return extension.key == alias.alias; });
  761. auto const& key = (it == script_aliases.end()) ? extension.key : it->property;
  762. auto& code_points = script_extensions.find(key)->value;
  763. code_points.extend(extension.value);
  764. sort_and_merge_code_point_ranges(code_points);
  765. }
  766. // Lastly, the Common and Inherited script extensions are special. They must not contain any
  767. // code points which appear in other script extensions. The ScriptExtensions UCD file does not
  768. // list these extensions, therefore this peculiarity must be handled programatically.
  769. // https://www.unicode.org/reports/tr24/#Assignment_ScriptX_Values
  770. auto code_point_has_other_extension = [&](StringView key, u32 code_point) {
  771. for (auto const& extension : extensions) {
  772. if (extension.key == key)
  773. continue;
  774. if (any_of(extension.value, [&](auto const& r) { return (r.first <= code_point) && (code_point <= r.last); }))
  775. return true;
  776. }
  777. return false;
  778. };
  779. auto get_code_points_without_other_extensions = [&](StringView key) {
  780. auto code_points = flatten_code_point_ranges(script_list.find(key)->value);
  781. code_points.remove_all_matching([&](u32 c) { return code_point_has_other_extension(key, c); });
  782. return code_points;
  783. };
  784. auto common_code_points = get_code_points_without_other_extensions("Common"sv);
  785. script_extensions.set("Common"sv, form_code_point_ranges(common_code_points));
  786. auto inherited_code_points = get_code_points_without_other_extensions("Inherited"sv);
  787. script_extensions.set("Inherited"sv, form_code_point_ranges(inherited_code_points));
  788. }
  789. int main(int argc, char** argv)
  790. {
  791. char const* generated_header_path = nullptr;
  792. char const* generated_implementation_path = nullptr;
  793. char const* unicode_data_path = nullptr;
  794. char const* special_casing_path = nullptr;
  795. char const* derived_general_category_path = nullptr;
  796. char const* prop_list_path = nullptr;
  797. char const* derived_core_prop_path = nullptr;
  798. char const* derived_binary_prop_path = nullptr;
  799. char const* prop_alias_path = nullptr;
  800. char const* prop_value_alias_path = nullptr;
  801. char const* scripts_path = nullptr;
  802. char const* script_extensions_path = nullptr;
  803. char const* emoji_data_path = nullptr;
  804. char const* normalization_path = nullptr;
  805. Core::ArgsParser args_parser;
  806. args_parser.add_option(generated_header_path, "Path to the Unicode Data header file to generate", "generated-header-path", 'h', "generated-header-path");
  807. args_parser.add_option(generated_implementation_path, "Path to the Unicode Data implementation file to generate", "generated-implementation-path", 'c', "generated-implementation-path");
  808. args_parser.add_option(unicode_data_path, "Path to UnicodeData.txt file", "unicode-data-path", 'u', "unicode-data-path");
  809. args_parser.add_option(special_casing_path, "Path to SpecialCasing.txt file", "special-casing-path", 's', "special-casing-path");
  810. args_parser.add_option(derived_general_category_path, "Path to DerivedGeneralCategory.txt file", "derived-general-category-path", 'g', "derived-general-category-path");
  811. args_parser.add_option(prop_list_path, "Path to PropList.txt file", "prop-list-path", 'p', "prop-list-path");
  812. args_parser.add_option(derived_core_prop_path, "Path to DerivedCoreProperties.txt file", "derived-core-prop-path", 'd', "derived-core-prop-path");
  813. args_parser.add_option(derived_binary_prop_path, "Path to DerivedBinaryProperties.txt file", "derived-binary-prop-path", 'b', "derived-binary-prop-path");
  814. args_parser.add_option(prop_alias_path, "Path to PropertyAliases.txt file", "prop-alias-path", 'a', "prop-alias-path");
  815. args_parser.add_option(prop_value_alias_path, "Path to PropertyValueAliases.txt file", "prop-value-alias-path", 'v', "prop-value-alias-path");
  816. args_parser.add_option(scripts_path, "Path to Scripts.txt file", "scripts-path", 'r', "scripts-path");
  817. args_parser.add_option(script_extensions_path, "Path to ScriptExtensions.txt file", "script-extensions-path", 'x', "script-extensions-path");
  818. args_parser.add_option(emoji_data_path, "Path to emoji-data.txt file", "emoji-data-path", 'e', "emoji-data-path");
  819. args_parser.add_option(normalization_path, "Path to DerivedNormalizationProps.txt file", "normalization-path", 'n', "normalization-path");
  820. args_parser.parse(argc, argv);
  821. auto open_file = [&](StringView path, StringView flags, Core::OpenMode mode = Core::OpenMode::ReadOnly) {
  822. if (path.is_empty()) {
  823. warnln("{} is required", flags);
  824. args_parser.print_usage(stderr, argv[0]);
  825. exit(1);
  826. }
  827. auto file_or_error = Core::File::open(path, mode);
  828. if (file_or_error.is_error()) {
  829. warnln("Failed to open {}: {}", path, file_or_error.release_error());
  830. exit(1);
  831. }
  832. return file_or_error.release_value();
  833. };
  834. auto generated_header_file = open_file(generated_header_path, "-h/--generated-header-path", Core::OpenMode::ReadWrite);
  835. auto generated_implementation_file = open_file(generated_implementation_path, "-c/--generated-implementation-path", Core::OpenMode::ReadWrite);
  836. auto unicode_data_file = open_file(unicode_data_path, "-u/--unicode-data-path");
  837. auto derived_general_category_file = open_file(derived_general_category_path, "-g/--derived-general-category-path");
  838. auto special_casing_file = open_file(special_casing_path, "-s/--special-casing-path");
  839. auto prop_list_file = open_file(prop_list_path, "-p/--prop-list-path");
  840. auto derived_core_prop_file = open_file(derived_core_prop_path, "-d/--derived-core-prop-path");
  841. auto derived_binary_prop_file = open_file(derived_binary_prop_path, "-b/--derived-binary-prop-path");
  842. auto prop_alias_file = open_file(prop_alias_path, "-a/--prop-alias-path");
  843. auto prop_value_alias_file = open_file(prop_value_alias_path, "-v/--prop-value-alias-path");
  844. auto scripts_file = open_file(scripts_path, "-r/--scripts-path");
  845. auto script_extensions_file = open_file(script_extensions_path, "-x/--script-extensions-path");
  846. auto emoji_data_file = open_file(emoji_data_path, "-e/--emoji-data-path");
  847. auto normalization_file = open_file(normalization_path, "-n/--normalization-path");
  848. UnicodeData unicode_data {};
  849. parse_special_casing(special_casing_file, unicode_data);
  850. parse_prop_list(derived_general_category_file, unicode_data.general_categories);
  851. parse_prop_list(prop_list_file, unicode_data.prop_list);
  852. parse_prop_list(derived_core_prop_file, unicode_data.prop_list);
  853. parse_prop_list(derived_binary_prop_file, unicode_data.prop_list);
  854. parse_prop_list(emoji_data_file, unicode_data.prop_list);
  855. parse_normalization_props(normalization_file, unicode_data);
  856. parse_alias_list(prop_alias_file, unicode_data.prop_list, unicode_data.prop_aliases);
  857. parse_prop_list(scripts_file, unicode_data.script_list);
  858. parse_prop_list(script_extensions_file, unicode_data.script_extensions, true);
  859. populate_general_category_unions(unicode_data.general_categories);
  860. parse_unicode_data(unicode_data_file, unicode_data);
  861. parse_value_alias_list(prop_value_alias_file, "gc"sv, unicode_data.general_categories.keys(), unicode_data.general_category_aliases);
  862. parse_value_alias_list(prop_value_alias_file, "sc"sv, unicode_data.script_list.keys(), unicode_data.script_aliases, false);
  863. normalize_script_extensions(unicode_data.script_extensions, unicode_data.script_list, unicode_data.script_aliases);
  864. generate_unicode_data_header(generated_header_file, unicode_data);
  865. generate_unicode_data_implementation(generated_implementation_file, unicode_data);
  866. return 0;
  867. }