gen_date_localizations.dart 7.14 KB
Newer Older
Ian Hickson's avatar
Ian Hickson committed
1
// Copyright 2014 The Flutter Authors. All rights reserved.
2 3 4 5 6 7 8
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

/// This program extracts localized date symbols and patterns from the intl
/// package for the subset of locales supported by the flutter_localizations
/// package.
///
9
/// The extracted data is written into:
10
///   packages/flutter_localizations/lib/src/l10n/generated_date_localizations.dart
11
///
12 13 14
/// ## Usage
///
/// Run this program from the root of the git repository.
15 16 17 18
///
/// The following outputs the generated Dart code to the console as a dry run:
///
/// ```
19
/// dart dev/tools/localization/bin/gen_date_localizations.dart
20 21
/// ```
///
22
/// If the data looks good, use the `--overwrite` option to overwrite the
23 24 25
/// lib/src/l10n/date_localizations.dart file:
///
/// ```
26
/// dart dev/tools/localization/bin/gen_date_localizations.dart --overwrite
27 28 29 30 31 32 33 34
/// ```

import 'dart:async';
import 'dart:convert';
import 'dart:io';

import 'package:path/path.dart' as path;

35
import '../localizations_utils.dart';
36

37 38
const String _kCommandName = 'gen_date_localizations.dart';

39 40 41 42
// Used to let _jsonToMap know what locale it's date symbols converting for.
// Date symbols for the Kannada locale ('kn') are handled specially because
// some of the strings contain characters that can crash Emacs on Linux.
// See packages/flutter_localizations/lib/src/l10n/README for more information.
43
String? currentLocale;
44

45
Future<void> main(List<String> rawArgs) async {
46
  checkCwdIsRepoRoot(_kCommandName);
47

48
  final bool writeToFile = parseArgs(rawArgs).writeToFile;
49

50
  final File dotPackagesFile = File(path.join('packages', 'flutter_localizations', '.packages'));
51 52 53
  final bool dotPackagesExists = dotPackagesFile.existsSync();

  if (!dotPackagesExists) {
54
    exitWithError(
55 56 57 58 59 60 61 62 63 64 65
      'File not found: ${dotPackagesFile.path}. $_kCommandName must be run '
      'after a successful "flutter update-packages".'
    );
  }

  final String pathToIntl = dotPackagesFile
    .readAsStringSync()
    .split('\n')
    .firstWhere(
      (String line) => line.startsWith('intl:'),
      orElse: () {
66
        exitWithError('intl dependency not found in ${dotPackagesFile.path}');
67
        return ''; // unreachable
68 69 70 71 72
      },
    )
    .split(':')
    .last;

73
  final Directory dateSymbolsDirectory = Directory(path.join(pathToIntl, 'src', 'data', 'dates', 'symbols'));
74
  final Map<String, File> symbolFiles = _listIntlData(dateSymbolsDirectory);
75
  final Directory datePatternsDirectory = Directory(path.join(pathToIntl, 'src', 'data', 'dates', 'patterns'));
76
  final Map<String, File> patternFiles = _listIntlData(datePatternsDirectory);
77
  final StringBuffer buffer = StringBuffer();
78
  final Set<String> supportedLocales = _supportedLocales();
79 80 81

  buffer.writeln(
'''
Ian Hickson's avatar
Ian Hickson committed
82
// Copyright 2014 The Flutter Authors. All rights reserved.
83 84 85
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

86
// This file has been automatically generated. Please do not edit it manually.
87
// To regenerate run (omit --overwrite to print to console instead of the file):
88
// dart --enable-asserts dev/tools/localization/bin/gen_date_localizations.dart --overwrite
89 90 91

'''
);
92 93 94
  buffer.writeln('''
/// The subset of date symbols supported by the intl package which are also
/// supported by flutter_localizations.''');
95
  buffer.writeln('const Map<String, dynamic> dateSymbols = <String, dynamic> {');
96
  symbolFiles.forEach((String locale, File data) {
97
    currentLocale = locale;
98
    if (supportedLocales.contains(locale))
99
      buffer.writeln(_jsonToMapEntry(locale, json.decode(data.readAsStringSync())));
100
  });
101
  currentLocale = null;
102 103
  buffer.writeln('};');

104
  // Code that uses datePatterns expects it to contain values of type
105
  // Map<String, String> not Map<String, dynamic>.
106 107 108
  buffer.writeln('''
/// The subset of date patterns supported by the intl package which are also
/// supported by flutter_localizations.''');
109
  buffer.writeln('const Map<String, Map<String, String>> datePatterns = <String, Map<String, String>> {');
110
  patternFiles.forEach((String locale, File data) {
111
    if (supportedLocales.contains(locale)) {
112
      final Map<String, dynamic> patterns = json.decode(data.readAsStringSync()) as Map<String, dynamic>;
113
      buffer.writeln("'$locale': <String, String>{");
114 115 116 117 118 119
      patterns.forEach((String key, dynamic value) {
        assert(value is String);
        buffer.writeln(_jsonToMapEntry(key, value));
      });
      buffer.writeln('},');
    }
120 121 122 123
  });
  buffer.writeln('};');

  if (writeToFile) {
124
    final File dateLocalizationsFile = File(path.join('packages', 'flutter_localizations', 'lib', 'src', 'l10n', 'generated_date_localizations.dart'));
125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142
    dateLocalizationsFile.writeAsStringSync(buffer.toString());
    Process.runSync(path.join('bin', 'cache', 'dart-sdk', 'bin', 'dartfmt'), <String>[
      '-w',
      dateLocalizationsFile.path,
    ]);
  } else {
    print(buffer);
  }
}

String _jsonToMapEntry(String key, dynamic value) {
  return "'$key': ${_jsonToMap(value)},";
}

String _jsonToMap(dynamic json) {
  if (json == null || json is num || json is bool)
    return '$json';

143
  if (json is String)
144
    return generateEncodedString(currentLocale!, json);
145

146 147 148 149 150 151 152 153
  if (json is Iterable) {
    final StringBuffer buffer = StringBuffer('<dynamic>[');
    for (final dynamic value in json) {
      buffer.writeln('${_jsonToMap(value)},');
    }
    buffer.write(']');
    return buffer.toString();
  }
154

155
  if (json is Map<String, dynamic>) {
156
    final StringBuffer buffer = StringBuffer('<String, dynamic>{');
157 158 159 160 161 162 163 164 165 166
    json.forEach((String key, dynamic value) {
      buffer.writeln(_jsonToMapEntry(key, value));
    });
    buffer.write('}');
    return buffer.toString();
  }

  throw 'Unsupported JSON type ${json.runtimeType} of value $json.';
}

167
Set<String> _supportedLocales() {
168 169 170 171 172 173 174 175
  // Assumes that en_US is a supported locale by default. Without this, usage
  // of the intl package APIs before Flutter populates its set of supported i18n
  // date patterns and symbols may cause problems.
  //
  // For more context, see https://github.com/flutter/flutter/issues/67644.
  final Set<String> supportedLocales = <String>{
    'en_US',
  };
176 177
  final RegExp filenameRE = RegExp(r'(?:material|cupertino)_(\w+)\.arb$');
  final Directory supportedLocalesDirectory = Directory(path.join('packages', 'flutter_localizations', 'lib', 'src', 'l10n'));
178
  for (final FileSystemEntity entity in supportedLocalesDirectory.listSync()) {
179
    final String filePath = entity.path;
180
    if (FileSystemEntity.isFileSync(filePath) && filenameRE.hasMatch(filePath)) {
181
      supportedLocales.add(filenameRE.firstMatch(filePath)![1]!);
182
    }
183
  }
184

185
  return supportedLocales;
186 187 188
}

Map<String, File> _listIntlData(Directory directory) {
189
  final Map<String, File> localeFiles = <String, File>{};
190 191 192 193
  final Iterable<File> files = directory
    .listSync()
    .whereType<File>()
    .where((File file) => file.path.endsWith('.json'));
194
  for (final File file in files) {
195 196
    final String locale = path.basenameWithoutExtension(file.path);
    localeFiles[locale] = file;
197
  }
198 199 200

  final List<String> locales = localeFiles.keys.toList(growable: false);
  locales.sort();
201
  return Map<String, File>.fromIterable(locales, value: (dynamic locale) => localeFiles[locale]!);
202
}