feat: add uninstall command (#811)

Author: jsgalarraga

packages/dart_frog_cli/lib/src/command_runner.dart

@@ -45,6 +45,7 @@ class DartFrogCommandRunner extends CompletionCommandRunner<int> {
     addCommand(NewCommand(logger: _logger));
     addCommand(ListCommand(logger: _logger));
     addCommand(DaemonCommand(logger: _logger));
+    addCommand(UninstallCommand(logger: _logger));
   }
 
   final Logger _logger;

packages/dart_frog_cli/lib/src/commands/commands.dart

@@ -6,6 +6,7 @@ export 'daemon/daemon.dart';
 export 'dev/dev.dart';
 export 'list/list.dart';
 export 'new/new.dart';
+export 'uninstall/uninstall.dart';
 
 /// A method which returns a [Future<MasonGenerator>] given a [MasonBundle].
 typedef GeneratorBuilder = Future<MasonGenerator> Function(MasonBundle);

packages/dart_frog_cli/lib/src/commands/uninstall/uninstall.dart

@@ -0,0 +1,35 @@
+import 'package:args/command_runner.dart';
+import 'package:dart_frog_cli/src/command_runner.dart';
+import 'package:mason/mason.dart' hide packageVersion;
+
+/// {@template uninstall_command}
+/// `dart_frog uninstall` command which explains how to uninstall
+/// the dart_frog_cli.
+/// {@endtemplate}
+class UninstallCommand extends Command<int> {
+  /// {@macro uninstall_command}
+  UninstallCommand({
+    required Logger logger,
+  }) : _logger = logger;
+
+  final Logger _logger;
+
+  @override
+  String get description => 'Explains how to uninstall the Dart Frog CLI.';
+
+  @override
+  String get name => 'uninstall';
+
+  @override
+  Future<int> run() async {
+    final docs = link(
+      uri: Uri.parse('https://dartfrog.vgv.dev/docs/overview#uninstalling-'),
+    );
+    _logger.info(
+      'For instructions on how to uninstall $packageName completely, check out:'
+      '\n$docs',
+    );
+
+    return ExitCode.success.code;
+  }
+}

packages/dart_frog_cli/test/src/command_runner_test.dart

@@ -28,12 +28,13 @@ const expectedUsage = [
       '    --verbose    Output additional logs.\n'
       '\n'
       'Available commands:\n'
-      '  build    Create a production build.\n'
-      '  create   Creates a new Dart Frog app.\n'
-      '  dev      Run a local development server.\n'
-      '  list     Lists the routes on a Dart Frog project.\n'
-      '  new      Create a new route or middleware for dart_frog\n'
-      '  update   Update the Dart Frog CLI.\n'
+      '  build       Create a production build.\n'
+      '  create      Creates a new Dart Frog app.\n'
+      '  dev         Run a local development server.\n'
+      '  list        Lists the routes on a Dart Frog project.\n'
+      '  new         Create a new route or middleware for dart_frog\n'
+      '  uninstall   Explains how to uninstall the Dart Frog CLI.\n'
+      '  update      Update the Dart Frog CLI.\n'
       '\n'
       'Run "dart_frog help <command>" for more information about a command.'
 ];

packages/dart_frog_cli/test/src/commands/uninstall/uninstall_test.dart

@@ -0,0 +1,32 @@
+import 'package:dart_frog_cli/src/command_runner.dart';
+import 'package:dart_frog_cli/src/commands/uninstall/uninstall.dart';
+import 'package:mason/mason.dart' hide packageVersion;
+import 'package:mocktail/mocktail.dart';
+import 'package:test/test.dart';
+
+class _MockLogger extends Mock implements Logger {}
+
+void main() {
+  group('dart_frog uninstall', () {
+    late Logger logger;
+    late UninstallCommand command;
+
+    setUp(() {
+      logger = _MockLogger();
+      command = UninstallCommand(logger: logger);
+    });
+
+    test('prints a link to the documentation section', () async {
+      final result = await command.run();
+      final docs = link(
+        uri: Uri.parse('https://dartfrog.vgv.dev/docs/overview#uninstalling-'),
+      );
+      final message =
+          'For instructions on how to uninstall $packageName completely, '
+          'check out:\n$docs';
+
+      expect(result, equals(ExitCode.success.code));
+      verify(() => logger.info(message)).called(1);
+    });
+  });
+}