// Copyright 2014 The Flutter Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. /// Throw a specialized exception for expected situations /// where the tool should exit with a clear message to the user /// and no stack trace unless the --verbose option is specified. /// For example: network errors. Never throwToolExit(String message, { int? exitCode }) { throw ToolExit(message, exitCode: exitCode); } /// Specialized exception for expected situations /// where the tool should exit with a clear message to the user /// and no stack trace unless the --verbose option is specified. /// For example: network errors. class ToolExit implements Exception { ToolExit(this.message, { this.exitCode }); final String? message; final int? exitCode; @override String toString() => 'Exception: $message'; // TODO(ianh): Really this should say "Error". } /// Indicates to the linter that the given future is intentionally not awaited. /// /// Has the same functionality as `unawaited` from `package:pedantic`. /// /// In an async context, it is normally expected than all Futures are awaited, /// and that is the basis of the lint unawaited_futures which is turned on for /// the flutter_tools package. However, there are times where one or more /// futures are intentionally not awaited. This function may be used to ignore a /// particular future. It silences the unawaited_futures lint. void unawaited(Future<void>? future) { }