// Copyright 2017 The Chromium 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 'dart:io' as io; import 'package:flutter_tools/src/base/common.dart'; import 'package:flutter_tools/src/base/io.dart'; import 'package:flutter_tools/src/base/signals.dart'; import 'package:flutter_tools/src/base/time.dart'; import 'package:flutter_tools/src/cache.dart'; import 'package:flutter_tools/src/reporting/reporting.dart'; import 'package:flutter_tools/src/runner/flutter_command.dart'; import 'package:flutter_tools/src/version.dart'; import 'package:mockito/mockito.dart'; import '../../src/common.dart'; import '../../src/context.dart'; import 'utils.dart'; void main() { group('Flutter Command', () { MockitoCache cache; MockitoUsage usage; MockClock clock; MockProcessInfo mockProcessInfo; List<int> mockTimes; setUp(() { cache = MockitoCache(); usage = MockitoUsage(); clock = MockClock(); mockProcessInfo = MockProcessInfo(); when(usage.isFirstRun).thenReturn(false); when(clock.now()).thenAnswer( (Invocation _) => DateTime.fromMillisecondsSinceEpoch(mockTimes.removeAt(0)) ); when(mockProcessInfo.maxRss).thenReturn(10); }); testUsingContext('honors shouldUpdateCache false', () async { final DummyFlutterCommand flutterCommand = DummyFlutterCommand(shouldUpdateCache: false); await flutterCommand.run(); verifyZeroInteractions(cache); }, overrides: <Type, Generator>{ Cache: () => cache, }); testUsingContext('honors shouldUpdateCache true', () async { final DummyFlutterCommand flutterCommand = DummyFlutterCommand(shouldUpdateCache: true); await flutterCommand.run(); verify(cache.updateAll(any)).called(1); }, overrides: <Type, Generator>{ Cache: () => cache, }); void testUsingCommandContext(String testName, Function testBody) { testUsingContext(testName, testBody, overrides: <Type, Generator>{ ProcessInfo: () => mockProcessInfo, SystemClock: () => clock, Usage: () => usage, }); } testUsingCommandContext('reports command that results in success', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { return const FlutterCommandResult(ExitStatus.success); } ); await flutterCommand.run(); verify(usage.sendCommand(captureAny, parameters: captureAnyNamed('parameters'))); verify(usage.sendEvent(captureAny, 'success', parameters: captureAnyNamed('parameters'))); }); testUsingCommandContext('reports command that results in warning', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { return const FlutterCommandResult(ExitStatus.warning); } ); await flutterCommand.run(); verify(usage.sendCommand(captureAny, parameters: captureAnyNamed('parameters'))); verify(usage.sendEvent(captureAny, 'warning', parameters: captureAnyNamed('parameters'))); }); testUsingCommandContext('reports command that results in failure', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { return const FlutterCommandResult(ExitStatus.fail); } ); try { await flutterCommand.run(); } on ToolExit { verify(usage.sendCommand(captureAny, parameters: captureAnyNamed('parameters'))); verify(usage.sendEvent(captureAny, 'fail', parameters: captureAnyNamed('parameters'))); } }); testUsingCommandContext('reports command that results in error', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { throwToolExit('fail'); return null; // unreachable } ); try { await flutterCommand.run(); fail('Mock should make this fail'); } on ToolExit { verify(usage.sendCommand(captureAny, parameters: captureAnyNamed('parameters'))); verify(usage.sendEvent(captureAny, 'fail', parameters: captureAnyNamed('parameters'))); } }); group('signals tests', () { MockIoProcessSignal mockSignal; ProcessSignal signalUnderTest; StreamController<io.ProcessSignal> signalController; setUp(() { mockSignal = MockIoProcessSignal(); signalUnderTest = ProcessSignal(mockSignal); signalController = StreamController<io.ProcessSignal>(); when(mockSignal.watch()).thenAnswer((Invocation invocation) => signalController.stream); }); testUsingContext('reports command that is killed', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final Completer<void> completer = Completer<void>(); setExitFunctionForTests((int exitCode) { expect(exitCode, 0); restoreExitFunction(); completer.complete(); }); final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { final Completer<void> c = Completer<void>(); await c.future; return null; // unreachable } ); unawaited(flutterCommand.run()); signalController.add(mockSignal); await completer.future; verify(usage.sendCommand(any, parameters: anyNamed('parameters'))); verify(usage.sendEvent(any, 'killed', parameters: anyNamed('parameters'))); }, overrides: <Type, Generator>{ ProcessInfo: () => mockProcessInfo, Signals: () => FakeSignals( subForSigTerm: signalUnderTest, exitSignals: <ProcessSignal>[signalUnderTest], ), SystemClock: () => clock, Usage: () => usage, }); }); testUsingCommandContext('reports maxRss', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { return const FlutterCommandResult(ExitStatus.success); } ); await flutterCommand.run(); verify(usage.sendCommand(captureAny, parameters: captureAnyNamed('parameters'))); expect(verify(usage.sendEvent( any, 'success', parameters: captureAnyNamed('parameters'), )).captured[0], containsPair(cdKey(CustomDimensions.commandResultEventMaxRss), mockProcessInfo.maxRss.toString())); }); testUsingCommandContext('report execution timing by default', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand(); await flutterCommand.run(); verify(clock.now()).called(2); expect( verify(usage.sendTiming( captureAny, captureAny, captureAny, label: captureAnyNamed('label'))).captured, <dynamic>[ 'flutter', 'dummy', const Duration(milliseconds: 1000), null, ], ); }); testUsingCommandContext('no timing report without usagePath', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand(noUsagePath: true); await flutterCommand.run(); verify(clock.now()).called(2); verifyNever(usage.sendTiming( any, any, any, label: anyNamed('label'))); }); testUsingCommandContext('report additional FlutterCommandResult data', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final FlutterCommandResult commandResult = FlutterCommandResult( ExitStatus.success, // nulls should be cleaned up. timingLabelParts: <String> ['blah1', 'blah2', null, 'blah3'], endTimeOverride: DateTime.fromMillisecondsSinceEpoch(1500), ); final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async => commandResult ); await flutterCommand.run(); verify(clock.now()).called(2); expect( verify(usage.sendTiming( captureAny, captureAny, captureAny, label: captureAnyNamed('label'))).captured, <dynamic>[ 'flutter', 'dummy', const Duration(milliseconds: 500), // FlutterCommandResult's end time used instead. 'success-blah1-blah2-blah3', ], ); }); testUsingCommandContext('report failed execution timing too', () async { // Crash if called a third time which is unexpected. mockTimes = <int>[1000, 2000]; final DummyFlutterCommand flutterCommand = DummyFlutterCommand( commandFunction: () async { throwToolExit('fail'); return null; // unreachable }, ); try { await flutterCommand.run(); fail('Mock should make this fail'); } on ToolExit { // Should have still checked time twice. verify(clock.now()).called(2); expect( verify(usage.sendTiming( captureAny, captureAny, captureAny, label: captureAnyNamed('label'))).captured, <dynamic>[ 'flutter', 'dummy', const Duration(milliseconds: 1000), 'fail', ], ); } }); }); } class FakeCommand extends FlutterCommand { @override String get description => null; @override String get name => 'fake'; @override Future<FlutterCommandResult> runCommand() async { return null; } } class MockVersion extends Mock implements FlutterVersion {} class MockProcessInfo extends Mock implements ProcessInfo {} class MockIoProcessSignal extends Mock implements io.ProcessSignal {} class FakeSignals implements Signals { FakeSignals({ this.subForSigTerm, List<ProcessSignal> exitSignals, }) : delegate = Signals(exitSignals: exitSignals); final ProcessSignal subForSigTerm; final Signals delegate; @override Object addHandler(ProcessSignal signal, SignalHandler handler) { if (signal == ProcessSignal.SIGTERM) { return delegate.addHandler(subForSigTerm, handler); } return delegate.addHandler(signal, handler); } @override Future<bool> removeHandler(ProcessSignal signal, Object token) => delegate.removeHandler(signal, token); @override Stream<Object> get errors => delegate.errors; }