kevmoo
58e1cbe1a7
Change-Id: I3e9b5a4c3f1d31967a503c4caf273b9d8f239095 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/502840 Auto-Submit: Kevin Moore <kevmoo@google.com> Commit-Queue: Kevin Moore <kevmoo@google.com> Commit-Queue: Paul Berry <paulberry@google.com> Reviewed-by: Paul Berry <paulberry@google.com>
82 lines
2.2 KiB
Dart
82 lines
2.2 KiB
Dart
// Copyright (c) 2026, the Dart project authors. Please see the AUTHORS file
|
|
// for details. 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:io';
|
|
|
|
import 'package:api_summary/api_summary.dart';
|
|
import 'package:args/args.dart';
|
|
import 'package:path/path.dart' as p;
|
|
import 'package:yaml/yaml.dart';
|
|
|
|
Future<void> main(List<String> arguments) async {
|
|
try {
|
|
final results = parser.parse(arguments);
|
|
|
|
if (results.flag('help')) {
|
|
print('Usage: api_summary [options]');
|
|
print(parser.usage);
|
|
return;
|
|
}
|
|
|
|
final packagePath =
|
|
results.option('package-path') ?? Directory.current.path;
|
|
final absolutePath = p.normalize(p.absolute(packagePath));
|
|
final pubspecFile = File(p.join(absolutePath, 'pubspec.yaml'));
|
|
|
|
if (!pubspecFile.existsSync()) {
|
|
stderr.writeln('Error: No pubspec.yaml found at "$absolutePath".');
|
|
exitCode = 1;
|
|
return;
|
|
}
|
|
|
|
final packageName = _extractPackageName(pubspecFile);
|
|
final summary = await summarizePackage(absolutePath, packageName);
|
|
stdout.write(summary);
|
|
} on FormatException catch (e) {
|
|
stderr.writeln('Error: ${e.message}');
|
|
stderr.writeln('\nUsage: api_summary [options]');
|
|
stderr.writeln(parser.usage);
|
|
exitCode = 64;
|
|
return;
|
|
}
|
|
}
|
|
|
|
final parser = ArgParser()
|
|
..addOption(
|
|
'package-path',
|
|
abbr: 'p',
|
|
help:
|
|
'The path to the package to summarize. Defaults to the current '
|
|
'directory.',
|
|
)
|
|
..addFlag(
|
|
'help',
|
|
abbr: 'h',
|
|
help: 'Print this usage information.',
|
|
negatable: false,
|
|
);
|
|
|
|
String _extractPackageName(File pubspecFile) {
|
|
final content = pubspecFile.readAsStringSync();
|
|
final yaml = loadYaml(content);
|
|
if (yaml is! Map) {
|
|
throw ArgumentError(
|
|
'Expected pubspec.yaml at ${pubspecFile.path} to be a YAML map.',
|
|
);
|
|
}
|
|
final name = yaml['name'];
|
|
if (name == null) {
|
|
throw ArgumentError(
|
|
'Could not find a "name" field in pubspec.yaml at ${pubspecFile.path}.',
|
|
);
|
|
}
|
|
if (name is! String) {
|
|
throw ArgumentError(
|
|
'The "name" field in pubspec.yaml at ${pubspecFile.path} must be a '
|
|
'String.',
|
|
);
|
|
}
|
|
return name;
|
|
}
|