commit | 74046a8ffb3c7f8e308d4e068da14a35508011b3 | [log] [tgz] |
---|---|---|
author | Kevin Moore <kevmoo@users.noreply.github.com> | Mon Dec 04 10:43:30 2023 -0800 |
committer | GitHub <noreply@github.com> | Mon Dec 04 10:43:30 2023 -0800 |
tree | c4785afbd305c5f97a0c9654e04e976d248ea519 | |
parent | e8002a2e1caa791cbf9e358810301597b635ba9d [diff] |
drop outdated lints (#119)
Contains utilities for the Dart VM's dart:io
.
io.dart
isExecutable
Returns whether a provided file path is considered executable on the host operating system.
ExitCode
An enum
-like class that contains known exit codes.
ProcessManager
A higher-level service for spawning and communicating with processes.
spawn
to create a process with std[in|out|err] forwarded by defaultFuture<void> main() async { final manager = ProcessManager(); // Print `dart` tool version to stdout. print('** Running `dart --version`'); var spawn = await manager.spawn('dart', ['--version']); await spawn.exitCode; // Check formatting and print the result to stdout. print('** Running `dart format --output=none .`'); spawn = await manager.spawn('dart', ['format', '--output=none', '.']); await spawn.exitCode; // Check if a package is ready for publishing. // Upon hitting a blocking stdin state, you may directly // output to the processes's stdin via your own, similar to how a bash or // shell script would spawn a process. print('** Running pub publish'); spawn = await manager.spawn('dart', ['pub', 'publish', '--dry-run']); await spawn.exitCode; // Closes stdin for the entire program. await sharedStdIn.terminate(); }
sharedStdIn
A safer version of the default stdin
stream from dart:io
that allows a subscriber to cancel their subscription, and then allows a new subscriber to start listening. This differs from the default behavior where only a single listener is ever allowed in the application lifecycle:
test('should allow multiple subscribers', () async { final logs = <String>[]; final asUtf8 = sharedStdIn.transform(UTF8.decoder); // Wait for input for the user. logs.add(await asUtf8.first); // Wait for more input for the user. logs.add(await asUtf8.first); expect(logs, ['Hello World', 'Goodbye World']); });
For testing, an instance of SharedStdIn
may be created directly.
ansi.dart
import 'dart:io' as io; import 'package:io/ansi.dart'; void main() { // To use one style, call the `wrap` method on one of the provided top-level // values. io.stderr.writeln(red.wrap("Bad error!")); // To use multiple styles, call `wrapWith`. print(wrapWith('** Important **', [red, styleBold, styleUnderlined])); // The wrap functions will simply return the provided value unchanged if // `ansiOutputEnabled` is false. // // You can override the value `ansiOutputEnabled` by wrapping code in // `overrideAnsiOutput`. overrideAnsiOutput(false, () { assert('Normal text' == green.wrap('Normal text')); }); }
For information about our publishing automation and release process, see https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.