// 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. import 'dart:async'; import 'package:platform/platform.dart'; import 'package:flutter_tools/src/base/io.dart'; import 'package:flutter_tools/src/base/logger.dart'; import 'package:flutter_tools/src/base/process.dart'; import 'package:flutter_tools/src/base/terminal.dart'; import 'package:mockito/mockito.dart'; import 'package:process/process.dart'; import '../../src/common.dart'; import '../../src/context.dart'; import '../../src/mocks.dart' show MockProcess, MockProcessManager, MockStdio, flakyProcessFactory; class MockLogger extends Mock implements Logger {} void main() { group('process exceptions', () { ProcessManager mockProcessManager; ProcessUtils processUtils; setUp(() { mockProcessManager = PlainMockProcessManager(); processUtils = ProcessUtils( processManager: mockProcessManager, logger: MockLogger(), ); }); testWithoutContext('runAsync throwOnError: exceptions should be ProcessException objects', () async { when(mockProcessManager.run(['false'])).thenAnswer( (Invocation invocation) => Future.value(ProcessResult(0, 1, '', ''))); expect(() async => await processUtils.run(['false'], throwOnError: true), throwsA(isA())); }); }); group('shutdownHooks', () { testWithoutContext('runInExpectedOrder', () async { int i = 1; int serializeRecording1; int serializeRecording2; int postProcessRecording; int cleanup; final ShutdownHooks shutdownHooks = ShutdownHooks(logger: MockLogger()); shutdownHooks.addShutdownHook(() async { serializeRecording1 = i++; }, ShutdownStage.SERIALIZE_RECORDING); shutdownHooks.addShutdownHook(() async { cleanup = i++; }, ShutdownStage.CLEANUP); shutdownHooks.addShutdownHook(() async { postProcessRecording = i++; }, ShutdownStage.POST_PROCESS_RECORDING); shutdownHooks.addShutdownHook(() async { serializeRecording2 = i++; }, ShutdownStage.SERIALIZE_RECORDING); await shutdownHooks.runShutdownHooks(); expect(serializeRecording1, lessThanOrEqualTo(2)); expect(serializeRecording2, lessThanOrEqualTo(2)); expect(postProcessRecording, 3); expect(cleanup, 4); }); }); group('output formatting', () { MockProcessManager mockProcessManager; ProcessUtils processUtils; BufferLogger mockLogger; setUp(() { mockProcessManager = MockProcessManager(); mockLogger = BufferLogger( terminal: AnsiTerminal( stdio: MockStdio(), platform: FakePlatform.fromPlatform(const LocalPlatform())..stdoutSupportsAnsi = false, ), outputPreferences: OutputPreferences(wrapText: true, wrapColumn: 40), ); processUtils = ProcessUtils( processManager: mockProcessManager, logger: mockLogger, ); }); MockProcess Function(List) processMetaFactory(List stdout, { List stderr = const [], }) { final Stream> stdoutStream = Stream>.fromIterable( stdout.map>((String s) => s.codeUnits, )); final Stream> stderrStream = Stream>.fromIterable( stderr.map>((String s) => s.codeUnits, )); return (List command) => MockProcess(stdout: stdoutStream, stderr: stderrStream); } testWithoutContext('Command output is not wrapped.', () async { final List testString = ['0123456789' * 10]; mockProcessManager.processFactory = processMetaFactory(testString, stderr: testString); await processUtils.stream(['command']); expect(mockLogger.statusText, equals('${testString[0]}\n')); expect(mockLogger.errorText, equals('${testString[0]}\n')); }); }); group('run', () { const Duration delay = Duration(seconds: 2); MockProcessManager flakyProcessManager; ProcessManager mockProcessManager; ProcessUtils processUtils; ProcessUtils flakyProcessUtils; setUp(() { // MockProcessManager has an implementation of start() that returns the // result of processFactory. flakyProcessManager = MockProcessManager(); mockProcessManager = MockProcessManager(); processUtils = ProcessUtils( processManager: mockProcessManager, logger: MockLogger(), ); flakyProcessUtils = ProcessUtils( processManager: flakyProcessManager, logger: MockLogger(), ); }); testWithoutContext(' succeeds on success', () async { when(mockProcessManager.run(['whoohoo'])).thenAnswer((_) { return Future.value(ProcessResult(0, 0, '', '')); }); expect((await processUtils.run(['whoohoo'])).exitCode, 0); }); testWithoutContext(' fails on failure', () async { when(mockProcessManager.run(['boohoo'])).thenAnswer((_) { return Future.value(ProcessResult(0, 1, '', '')); }); expect((await processUtils.run(['boohoo'])).exitCode, 1); }); testWithoutContext(' throws on failure with throwOnError', () async { when(mockProcessManager.run(['kaboom'])).thenAnswer((_) { return Future.value(ProcessResult(0, 1, '', '')); }); expect(() => processUtils.run(['kaboom'], throwOnError: true), throwsA(isA())); }); testWithoutContext(' does not throw on failure with whitelist', () async { when(mockProcessManager.run(['kaboom'])).thenAnswer((_) { return Future.value(ProcessResult(0, 1, '', '')); }); expect( (await processUtils.run( ['kaboom'], throwOnError: true, whiteListFailures: (int c) => c == 1, )).exitCode, 1, ); }); testWithoutContext(' throws on failure when not in whitelist', () async { when(mockProcessManager.run(['kaboom'])).thenAnswer((_) { return Future.value(ProcessResult(0, 2, '', '')); }); expect( () => processUtils.run( ['kaboom'], throwOnError: true, whiteListFailures: (int c) => c == 1, ), throwsA(isA()), ); }); testWithoutContext(' flaky process fails without retry', () async { flakyProcessManager.processFactory = flakyProcessFactory( flakes: 1, delay: delay, ); final RunResult result = await flakyProcessUtils.run( ['dummy'], timeout: delay + const Duration(seconds: 1), ); expect(result.exitCode, -9); }); testWithoutContext(' flaky process succeeds with retry', () async { flakyProcessManager.processFactory = flakyProcessFactory( flakes: 1, delay: delay, ); final RunResult result = await flakyProcessUtils.run( ['dummy'], timeout: delay - const Duration(milliseconds: 500), timeoutRetries: 1, ); expect(result.exitCode, 0); }); testWithoutContext(' flaky process generates ProcessException on timeout', () async { final Completer> flakyStderr = Completer>(); final Completer> flakyStdout = Completer>(); flakyProcessManager.processFactory = flakyProcessFactory( flakes: 1, delay: delay, stderr: () => Stream>.fromFuture(flakyStderr.future), stdout: () => Stream>.fromFuture(flakyStdout.future), ); when(flakyProcessManager.killPid(any)).thenAnswer((_) { // Don't let the stderr stream stop until the process is killed. This // ensures that runAsync() does not delay killing the process until // stdout and stderr are drained (which won't happen). flakyStderr.complete([]); flakyStdout.complete([]); return true; }); expect(() => flakyProcessUtils.run( ['dummy'], timeout: delay - const Duration(milliseconds: 500), timeoutRetries: 0, ), throwsA(isA())); }); }); group('runSync', () { ProcessManager mockProcessManager; ProcessUtils processUtils; BufferLogger testLogger; setUp(() { mockProcessManager = MockProcessManager(); testLogger = BufferLogger( terminal: AnsiTerminal( stdio: MockStdio(), platform: FakePlatform.fromPlatform(const LocalPlatform())..stdoutSupportsAnsi = false, ), outputPreferences: OutputPreferences(wrapText: true, wrapColumn: 40), ); processUtils = ProcessUtils( processManager: mockProcessManager, logger: testLogger, ); }); testWithoutContext(' succeeds on success', () async { when(mockProcessManager.runSync(['whoohoo'])).thenReturn( ProcessResult(0, 0, '', '') ); expect(processUtils.runSync(['whoohoo']).exitCode, 0); }); testWithoutContext(' fails on failure', () async { when(mockProcessManager.runSync(['boohoo'])).thenReturn( ProcessResult(0, 1, '', '') ); expect(processUtils.runSync(['boohoo']).exitCode, 1); }); testWithoutContext(' throws on failure with throwOnError', () async { when(mockProcessManager.runSync(['kaboom'])).thenReturn( ProcessResult(0, 1, '', '') ); expect(() => processUtils.runSync(['kaboom'], throwOnError: true), throwsA(isA())); }); testWithoutContext(' does not throw on failure with whitelist', () async { when(mockProcessManager.runSync(['kaboom'])).thenReturn( ProcessResult(0, 1, '', '') ); expect( processUtils.runSync( ['kaboom'], throwOnError: true, whiteListFailures: (int c) => c == 1, ).exitCode, 1); }); testWithoutContext(' throws on failure when not in whitelist', () async { when(mockProcessManager.runSync(['kaboom'])).thenReturn( ProcessResult(0, 2, '', '') ); expect( () => processUtils.runSync( ['kaboom'], throwOnError: true, whiteListFailures: (int c) => c == 1, ), throwsA(isA())); }); testWithoutContext(' prints stdout and stderr to trace on success', () async { when(mockProcessManager.runSync(['whoohoo'])).thenReturn( ProcessResult(0, 0, 'stdout', 'stderr') ); expect(processUtils.runSync(['whoohoo']).exitCode, 0); expect(testLogger.traceText, contains('stdout')); expect(testLogger.traceText, contains('stderr')); }); testWithoutContext(' prints stdout to status and stderr to error on failure with throwOnError', () async { when(mockProcessManager.runSync(['kaboom'])).thenReturn( ProcessResult(0, 1, 'stdout', 'stderr') ); expect(() => processUtils.runSync(['kaboom'], throwOnError: true), throwsA(isA())); expect(testLogger.statusText, contains('stdout')); expect(testLogger.errorText, contains('stderr')); }); testWithoutContext(' does not print stdout with hideStdout', () async { when(mockProcessManager.runSync(['whoohoo'])).thenReturn( ProcessResult(0, 0, 'stdout', 'stderr') ); expect(processUtils.runSync(['whoohoo'], hideStdout: true).exitCode, 0); expect(testLogger.traceText.contains('stdout'), isFalse); expect(testLogger.traceText, contains('stderr')); }); }); group('exitsHappySync', () { ProcessManager mockProcessManager; ProcessUtils processUtils; setUp(() { mockProcessManager = MockProcessManager(); processUtils = ProcessUtils( processManager: mockProcessManager, logger: MockLogger(), ); }); testWithoutContext(' succeeds on success', () async { when(mockProcessManager.runSync(['whoohoo'])).thenReturn( ProcessResult(0, 0, '', '') ); expect(processUtils.exitsHappySync(['whoohoo']), isTrue); }); testWithoutContext(' fails on failure', () async { when(mockProcessManager.runSync(['boohoo'])).thenReturn( ProcessResult(0, 1, '', '') ); expect(processUtils.exitsHappySync(['boohoo']), isFalse); }); }); group('exitsHappy', () { ProcessManager mockProcessManager; ProcessUtils processUtils; setUp(() { mockProcessManager = MockProcessManager(); processUtils = ProcessUtils( processManager: mockProcessManager, logger: MockLogger(), ); }); testWithoutContext(' succeeds on success', () async { when(mockProcessManager.run(['whoohoo'])).thenAnswer((_) { return Future.value(ProcessResult(0, 0, '', '')); }); expect(await processUtils.exitsHappy(['whoohoo']), isTrue); }); testWithoutContext(' fails on failure', () async { when(mockProcessManager.run(['boohoo'])).thenAnswer((_) { return Future.value(ProcessResult(0, 1, '', '')); }); expect(await processUtils.exitsHappy(['boohoo']), isFalse); }); }); } class PlainMockProcessManager extends Mock implements ProcessManager {}