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

5 6
// @dart = 2.8

7 8 9 10
import 'package:completion/completion.dart';

import '../base/common.dart';
import '../base/file_system.dart';
11
import '../globals.dart' as globals;
12 13 14
import '../runner/flutter_command.dart';

class ShellCompletionCommand extends FlutterCommand {
15
  ShellCompletionCommand() {
16 17 18 19 20 21 22 23 24 25 26 27 28
    argParser.addFlag(
      'overwrite',
      defaultsTo: false,
      negatable: true,
      help: 'Causes the given shell completion setup script to be overwritten if it already exists.',
    );
  }

  @override
  final String name = 'bash-completion';

  @override
  final String description = 'Output command line shell completion setup scripts.\n\n'
29 30 31
      'This command prints the flutter command line completion setup script for Bash and Zsh. To '
      'use it, specify an output file and follow the instructions in the generated output file to '
      'install it in your shell environment. Once it is sourced, your shell will be able to '
32 33 34 35 36 37 38 39 40 41
      'complete flutter commands and options.';

  @override
  final List<String> aliases = <String>['zsh-completion'];

  @override
  bool get shouldUpdateCache => false;

  /// Return null to disable analytics recording of the `bash-completion` command.
  @override
42
  Future<String> get usagePath async => null;
43 44

  @override
45
  Future<FlutterCommandResult> runCommand() async {
46 47 48 49 50
    if (argResults.rest.length > 1) {
      throwToolExit('Too many arguments given to bash-completion command.', exitCode: 1);
    }

    if (argResults.rest.isEmpty || argResults.rest.first == '-') {
51
      final String script = generateCompletionScript(<String>['flutter']);
52
      globals.stdio.stdoutWrite(script);
53
      return FlutterCommandResult.warning();
54 55
    }

56
    final File outputFile = globals.fs.file(argResults.rest.first);
57
    if (outputFile.existsSync() && !boolArg('overwrite')) {
58 59 60 61 62 63 64 65 66 67 68
      throwToolExit(
        'Output file ${outputFile.path} already exists, will not overwrite. '
            'Use --overwrite to force overwriting existing output file.',
        exitCode: 1,
      );
    }
    try {
      outputFile.writeAsStringSync(generateCompletionScript(<String>['flutter']));
    } on FileSystemException catch (error) {
      throwToolExit('Unable to write shell completion setup script.\n$error', exitCode: 1);
    }
69

70
    return FlutterCommandResult.success();
71 72
  }
}