swagger_generator_flutter/lib/swagger_cli_new.dart

194 lines
5.2 KiB
Dart

import 'dart:io';
import 'commands/base_command.dart';
import 'commands/generate_command.dart';
import 'core/config.dart';
import 'utils/performance_monitor.dart';
import 'utils/string_utils.dart';
/// Swagger CLI 应用程序
/// 使用命令模式架构的新版本CLI工具
class SwaggerCLI {
final Map<String, BaseCommand> _commands = {};
final PerformanceMonitor _monitor = PerformanceMonitor();
SwaggerCLI() {
_registerCommands();
}
/// 注册所有命令
void _registerCommands() {
_registerCommand(GenerateCommand());
// 未来可以添加更多命令:
// _registerCommand(ParseCommand());
// _registerCommand(ValidateCommand());
// _registerCommand(InfoCommand());
// _registerCommand(TestCommand());
// _registerCommand(CleanCommand());
}
/// 注册单个命令
void _registerCommand(BaseCommand command) {
_commands[command.name] = command;
}
/// 运行CLI应用程序
Future<int> run(List<String> arguments) async {
try {
_showBanner();
if (arguments.isEmpty ||
arguments.first == 'help' ||
arguments.first == '--help') {
_showHelp();
return 0;
}
final commandName = arguments.first;
final commandArgs =
arguments.length > 1 ? arguments.sublist(1) : <String>[];
// 检查特殊命令
if (commandName == 'version' || commandName == '--version') {
_showVersion();
return 0;
}
// 查找并执行命令
final command = _commands[commandName];
if (command == null) {
print('❌ 未知命令: $commandName');
print('');
_showAvailableCommands();
return 1;
}
// 检查命令帮助
if (commandArgs.contains('--help') || commandArgs.contains('-h')) {
command.showHelp();
return 0;
}
// 执行命令
final stopwatch = Stopwatch()..start();
final exitCode = await command.execute(commandArgs);
stopwatch.stop();
// 显示执行时间
if (exitCode == 0) {
print('');
print('⏱️ 执行时间: ${StringUtils.formatDuration(stopwatch.elapsed)}');
}
return exitCode;
} catch (error, stackTrace) {
print('❌ 应用程序错误: $error');
print('堆栈跟踪: $stackTrace');
return 1;
}
}
/// 显示应用程序横幅
void _showBanner() {
print('');
print('🚀 Swagger API 代码生成器 v2.0');
print('=====================================');
print('强大的 Swagger API 代码生成工具');
print('');
}
/// 显示帮助信息
void _showHelp() {
print('用法: dart swagger_cli_new.dart <命令> [选项]');
print('');
print('全新的命令式架构,提供更好的可扩展性和用户体验。');
print('');
_showAvailableCommands();
_showGlobalOptions();
_showExamples();
_showContact();
}
/// 显示可用命令
void _showAvailableCommands() {
print('📋 可用命令:');
print('');
for (final command in _commands.values) {
print(' ${command.name.padRight(12)} ${command.description}');
}
print(' help 显示帮助信息');
print(' version 显示版本信息');
print('');
}
/// 显示全局选项
void _showGlobalOptions() {
print('🔧 全局选项:');
print(' -h, --help 显示帮助信息');
print(' --version 显示版本信息');
print('');
}
/// 显示使用示例
void _showExamples() {
print('💡 使用示例:');
print('');
print(' # 生成所有文件');
print(' dart swagger_cli_new.dart generate --all');
print('');
print(' # 只生成模型文件(简洁版本)');
print(' dart swagger_cli_new.dart generate --models --simple');
print('');
print(' # 生成到指定目录并启用性能监控');
print(
' dart swagger_cli_new.dart generate --all --output-dir lib/generated --performance',
);
print('');
print(' # 查看具体命令的帮助');
print(' dart swagger_cli_new.dart generate --help');
print('');
}
/// 显示联系信息
void _showContact() {
print('🌐 更多信息:');
print(' API文档: ${SwaggerConfig.swaggerJsonUrl}');
print(' 基础URL: ${SwaggerConfig.baseUrl}');
print('');
}
/// 显示版本信息
void _showVersion() {
print('Swagger CLI v2.0.0');
print('构建于: ${DateTime.now().toIso8601String()}');
print('Dart SDK: ${Platform.version}');
print('');
print('功能特性:');
print('- 🏗️ 模块化命令架构');
print('- 🚀 性能监控和优化');
print('- 🔍 智能类型验证');
print('- 📋 详细的错误报告');
print('- 💾 智能缓存机制');
print('- 📚 丰富的文档生成');
print('');
}
/// 格式化持续时间
// 已移动到 StringUtils.formatDuration
/// 获取可用命令列表
List<String> get availableCommands => _commands.keys.toList();
/// 获取特定命令
BaseCommand? getCommand(String name) => _commands[name];
}
/// CLI应用程序入口点
Future<void> main(List<String> arguments) async {
final cli = SwaggerCLI();
final exitCode = await cli.run(arguments);
exit(exitCode);
}