mirror of
https://github.com/flutter/flutter.git
synced 2025-06-03 00:51:18 +00:00

## Description This improves defaults generation with logging, stats, and token validation. This PR includes these changes: * introduce `TokenLogger`, with a verbose mode * prints versions and tokens usage to the console * outputs `generated/used_tokens.csv`, a list of all used tokens, for use by Google * find token files in `data` automatically * hide tokens `Map` * tokens can be obtained using existing resolvers (e.g. `color`, `shape`), or directly through `getToken`. * tokens can be checked for existence with `tokenAvailable` * remove version from template, since the tokens are aggregated and multiple versions are possible (as is the case currently), it does not make sense to attribute a single version * improve documentation ## Related Issues - Fixes https://github.com/flutter/flutter/issues/122602 ## Tests - Added tests for `TokenLogger` - Regenerated tokens, no-op except version removal ## Future work A future PR should replace or remove the following invalid tokens usages <img width="578" alt="image" src="https://github.com/flutter/flutter/assets/6655696/b6f9e5a7-523f-4f72-94f9-1b0bf4cc9f00">
89 lines
2.4 KiB
Dart
89 lines
2.4 KiB
Dart
// Copyright 2014 The Flutter Authors. 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:collection';
|
|
import 'dart:io';
|
|
|
|
final TokenLogger tokenLogger = TokenLogger();
|
|
|
|
/// Class to keep track of used tokens and versions.
|
|
class TokenLogger {
|
|
TokenLogger();
|
|
|
|
void init({
|
|
required Map<String, dynamic> allTokens,
|
|
required Map<String, List<String>> versionMap
|
|
}){
|
|
_allTokens = allTokens;
|
|
_versionMap = versionMap;
|
|
}
|
|
|
|
/// Map of all tokens to their values.
|
|
late Map<String, dynamic> _allTokens;
|
|
|
|
// Map of versions to their token files.
|
|
late Map<String, List<String>> _versionMap;
|
|
|
|
// Sorted set of used tokens.
|
|
final SplayTreeSet<String> _usedTokens = SplayTreeSet<String>();
|
|
|
|
void clear() {
|
|
_allTokens.clear();
|
|
_versionMap.clear();
|
|
_usedTokens.clear();
|
|
}
|
|
|
|
/// Logs a token.
|
|
void log(String token) {
|
|
if (!_allTokens.containsKey(token)) {
|
|
print('\x1B[31m' 'Token unavailable: $token' '\x1B[0m');
|
|
return;
|
|
}
|
|
_usedTokens.add(token);
|
|
}
|
|
|
|
/// Prints version usage to the console.
|
|
void printVersionUsage({required bool verbose}) {
|
|
final String versionsString = 'Versions used: ${_versionMap.keys.join(', ')}';
|
|
print(versionsString);
|
|
if (verbose) {
|
|
for (final String version in _versionMap.keys) {
|
|
print(' $version:');
|
|
final List<String> files = List<String>.from(_versionMap[version]!);
|
|
files.sort();
|
|
for (final String file in files) {
|
|
print(' $file');
|
|
}
|
|
}
|
|
print('');
|
|
}
|
|
}
|
|
|
|
/// Prints tokens usage to the console.
|
|
void printTokensUsage({required bool verbose}) {
|
|
final Set<String> allTokensSet = _allTokens.keys.toSet();
|
|
|
|
if (verbose) {
|
|
for (final String token in SplayTreeSet<String>.from(allTokensSet).toList()) {
|
|
if (_usedTokens.contains(token)) {
|
|
print('✅ $token');
|
|
} else {
|
|
print('❌ $token');
|
|
}
|
|
}
|
|
print('');
|
|
}
|
|
|
|
print('Tokens used: ${_usedTokens.length}/${_allTokens.length}');
|
|
}
|
|
|
|
/// Dumps version and tokens usage to a file.
|
|
void dumpToFile(String path) {
|
|
final File file = File(path);
|
|
file.createSync(recursive: true);
|
|
final String versionsString = 'Versions used, ${_versionMap.keys.join(', ')}';
|
|
file.writeAsStringSync('$versionsString\n${_usedTokens.join(',\n')}\n');
|
|
}
|
|
}
|