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

import 'dart:async';

import 'package:completion/completion.dart';

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

class ShellCompletionCommand extends FlutterCommand {
16
  ShellCompletionCommand() {
17 18 19 20 21 22 23 24 25 26 27 28 29
    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'
30 31 32
      '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 '
33 34 35 36 37 38 39 40 41 42
      '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
43
  Future<String> get usagePath async => null;
44 45

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

    if (argResults.rest.isEmpty || argResults.rest.first == '-') {
      stdout.write(generateCompletionScript(<String>['flutter']));
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
  }
}