Merge in the flutter gallery (#176)

2025-11-14 03:19:06 +00:00 · 2019-12-10 16:59:49 -05:00
parent 428041b253
commit 6673acc6d7
734 changed files with 198940 additions and 0 deletions
--- a/gallery/l10n_cli/lib/l10n_cli.dart
+++ b/gallery/l10n_cli/lib/l10n_cli.dart
@@ -0,0 +1,144 @@
+// Copyright 2019 The Flutter team. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:async';
+import 'dart:convert';
+import 'dart:io';
+import 'package:meta/meta.dart';
+
+const _l10nDir = '../gallery/lib/l10n';
+const _intlHeader = '''
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  This file was automatically generated.
+  Please do not edit it manually.
+  It was based on gallery/lib/src/l10n/intl_en_US.arb.
+-->
+<resources>
+''';
+
+const _pluralSuffixes = <String>[
+  'Zero',
+  'One',
+  'Two',
+  'Few',
+  'Many',
+  'Other',
+];
+
+String _escapeXml(String xml) {
+  return xml
+      .replaceAll('&', '&amp;')
+      .replaceAll('"', '&quot;')
+      .replaceAll("'", '&apos;')
+      .replaceAll('>', '&gt;')
+      .replaceAll('<', '&lt;');
+}
+
+/// Processes the XML files.
+Future<void> englishArbsToXmls() async {
+  await generateXmlFromArb(
+    inputArb: File('$_l10nDir/intl_en_US.arb'),
+    outputXml: File('$_l10nDir/intl_en_US.xml'),
+    xmlHeader: _intlHeader,
+  );
+}
+
+@visibleForTesting
+Future<void> generateXmlFromArb({
+  File inputArb,
+  File outputXml,
+  String xmlHeader,
+}) async {
+  final Map<String, dynamic> bundle = jsonDecode(await inputArb.readAsString());
+  String translationFor(String key) {
+    assert(bundle[key] != null);
+    return _escapeXml(bundle[key]);
+  }
+
+  final xml = StringBuffer(xmlHeader);
+
+  for (String key in bundle.keys) {
+    if (key == '@@last_modified') {
+      continue;
+    }
+
+    if (!key.startsWith('@')) {
+      continue;
+    }
+
+    final resourceId = key.substring(1);
+    final name = _escapeXml(resourceId);
+    final Map<String, dynamic> metaInfo = bundle[key];
+    assert(metaInfo != null && metaInfo['description'] != null);
+    var description = _escapeXml(metaInfo['description']);
+
+    if (metaInfo.containsKey('plural')) {
+      // Generate a plurals resource element formatted like this:
+      // <plurals
+      //   name="dartVariableName"
+      //   description="description">
+      //   <item
+      //     quantity="other"
+      //     >%d translation</item>
+      //   ... items for quantities one, two, etc.
+      // </plurals>
+      final quantityVar = "\$${metaInfo['plural']}";
+      description = description.replaceAll('\$$quantityVar', '%d');
+      xml.writeln('  <plurals');
+      xml.writeln('    name="$name"');
+      xml.writeln('    description="$description">');
+      for (String suffix in _pluralSuffixes) {
+        final pluralKey = '$resourceId$suffix';
+        if (bundle.containsKey(pluralKey)) {
+          final translation =
+              translationFor(pluralKey).replaceFirst(quantityVar, '%d');
+          xml.writeln('    <item');
+          xml.writeln('      quantity="${suffix.toLowerCase()}"');
+          xml.writeln('      >$translation</item>');
+        }
+      }
+      xml.writeln('  </plurals>');
+    } else if (metaInfo.containsKey('parameters')) {
+      // Generate a parameterized string resource element formatted like this:
+      // <string
+      //   name="dartVariableName"
+      //   description="string description"
+      //   >string %1$s %2$s translation</string>
+      // The translated string's original $vars, which must be listed in its
+      // description's 'parameters' value, are replaced with printf positional
+      // string arguments, like "%1$s".
+      var translation = translationFor(resourceId);
+      assert(metaInfo['parameters'].trim().isNotEmpty);
+      final parameters = metaInfo['parameters']
+          .split(',')
+          .map<String>((s) => s.trim())
+          .toList();
+      var index = 1;
+      for (String parameter in parameters) {
+        translation = translation.replaceAll('\$$parameter', '%$index\$s');
+        description = description.replaceAll('\$$parameter', '%$index\$s');
+        index += 1;
+      }
+      xml.writeln('  <string');
+      xml.writeln('    name="$name"');
+      xml.writeln('    description="$description"');
+      xml.writeln('    >$translation</string>');
+    } else {
+      // Generate a string resource element formatted like this:
+      // <string
+      //   name="dartVariableName"
+      //   description="string description"
+      //   >string translation</string>
+      final translation = translationFor(resourceId);
+      xml.writeln('  <string');
+      xml.writeln('    name="$name"');
+      xml.writeln('    description="$description"');
+      xml.writeln('    >$translation</string>');
+    }
+  }
+  xml.writeln('</resources>');
+
+  await outputXml.writeAsString(xml.toString());
+}