// 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:convert' show jsonDecode; import 'package:args/command_runner.dart'; import 'package:conductor/proto/conductor_state.pb.dart' as pb; import 'package:conductor/proto/conductor_state.pbenum.dart' show ReleasePhase; import 'package:conductor/repository.dart'; import 'package:conductor/start.dart'; import 'package:conductor/state.dart'; import 'package:file/file.dart'; import 'package:file/memory.dart'; import 'package:platform/platform.dart'; import './common.dart'; import '../../../packages/flutter_tools/test/src/fake_process_manager.dart'; void main() { group('start command', () { const String flutterRoot = '/flutter'; const String checkoutsParentDirectory = '$flutterRoot/dev/tools/'; const String frameworkMirror = 'https://github.com/user/flutter.git'; const String engineMirror = 'https://github.com/user/engine.git'; const String candidateBranch = 'flutter-1.2-candidate.3'; const String releaseChannel = 'stable'; const String revision = 'abcd1234'; late Checkouts checkouts; late MemoryFileSystem fileSystem; late FakePlatform platform; late TestStdio stdio; late FakeProcessManager processManager; setUp(() { stdio = TestStdio(); fileSystem = MemoryFileSystem.test(); }); CommandRunner createRunner({ Map? environment, String? operatingSystem, List? commands, }) { operatingSystem ??= const LocalPlatform().operatingSystem; final String pathSeparator = operatingSystem == 'windows' ? r'\' : '/'; environment ??= { 'HOME': '/path/to/user/home', }; final Directory homeDir = fileSystem.directory( environment['HOME'], ); // Tool assumes this exists homeDir.createSync(recursive: true); platform = FakePlatform( environment: environment, operatingSystem: operatingSystem, pathSeparator: pathSeparator, ); processManager = FakeProcessManager.list(commands ?? []); checkouts = Checkouts( fileSystem: fileSystem, parentDirectory: fileSystem.directory(checkoutsParentDirectory), platform: platform, processManager: processManager, stdio: stdio, ); final StartCommand command = StartCommand( checkouts: checkouts, flutterRoot: fileSystem.directory(flutterRoot), ); return CommandRunner('codesign-test', '')..addCommand(command); } test('throws exception if run from Windows', () async { final CommandRunner runner = createRunner( commands: [ const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision, ), ], operatingSystem: 'windows', ); await expectLater( () async => runner.run(['start']), throwsExceptionWith( 'Error! This tool is only supported on macOS and Linux', ), ); }); test('throws if --$kFrameworkMirrorOption not provided', () async { final CommandRunner runner = createRunner( commands: [ const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision, ), ], ); await expectLater( () async => runner.run(['start']), throwsExceptionWith( 'Expected either the CLI arg --$kFrameworkMirrorOption or the environment variable FRAMEWORK_MIRROR to be provided', ), ); }); test('creates state file if provided correct inputs', () async { const String revision2 = 'def789'; const String revision3 = '123abc'; const String previousDartRevision = '171876a4e6cf56ee6da1f97d203926bd7afda7ef'; const String nextDartRevision = 'f6c91128be6b77aef8351e1e3a9d07c85bc2e46e'; const String previousVersion = '1.2.0-1.0.pre'; const String nextVersion = '1.2.0-3.0.pre'; const String incrementLevel = 'm'; final Directory engine = fileSystem.directory(checkoutsParentDirectory) .childDirectory('flutter_conductor_checkouts') .childDirectory('engine'); final File depsFile = engine.childFile('DEPS'); final List engineCommands = [ FakeCommand( command: [ 'git', 'clone', '--origin', 'upstream', '--', EngineRepository.defaultUpstream, engine.path, ], onRun: () { // Create the DEPS file which the tool will update engine.createSync(recursive: true); depsFile.writeAsStringSync(generateMockDeps(previousDartRevision)); } ), const FakeCommand( command: ['git', 'remote', 'add', 'mirror', engineMirror], ), const FakeCommand( command: ['git', 'fetch', 'mirror'], ), const FakeCommand( command: ['git', 'checkout', 'upstream/$candidateBranch'], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), const FakeCommand( command: [ 'git', 'checkout', '-b', 'cherrypicks-$candidateBranch', ], ), const FakeCommand( command: ['git', 'status', '--porcelain'], stdout: 'MM path/to/DEPS', ), const FakeCommand( command: ['git', 'add', '--all'], ), const FakeCommand( command: ['git', 'commit', "--message='Update Dart SDK to $nextDartRevision'"], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), ]; final List frameworkCommands = [ FakeCommand( command: [ 'git', 'clone', '--origin', 'upstream', '--', FrameworkRepository.defaultUpstream, fileSystem.path.join( checkoutsParentDirectory, 'flutter_conductor_checkouts', 'framework', ), ], ), const FakeCommand( command: ['git', 'remote', 'add', 'mirror', frameworkMirror], ), const FakeCommand( command: ['git', 'fetch', 'mirror'], ), const FakeCommand( command: ['git', 'checkout', 'upstream/$candidateBranch'], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision3, ), const FakeCommand( command: [ 'git', 'checkout', '-b', 'cherrypicks-$candidateBranch', ], ), const FakeCommand( command: [ 'git', 'describe', '--match', '*.*.*', '--tags', 'refs/remotes/upstream/$candidateBranch', ], stdout: '$previousVersion-42-gabc123', ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision3, ), ]; final CommandRunner runner = createRunner( commands: [ const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision, ), ...engineCommands, ...frameworkCommands, ], ); final String stateFilePath = fileSystem.path.join( platform.environment['HOME']!, kStateFileName, ); await runner.run([ 'start', '--$kFrameworkMirrorOption', frameworkMirror, '--$kEngineMirrorOption', engineMirror, '--$kCandidateOption', candidateBranch, '--$kReleaseOption', releaseChannel, '--$kStateOption', stateFilePath, '--$kDartRevisionOption', nextDartRevision, '--$kIncrementOption', incrementLevel, ]); final File stateFile = fileSystem.file(stateFilePath); final pb.ConductorState state = pb.ConductorState(); state.mergeFromProto3Json( jsonDecode(stateFile.readAsStringSync()), ); expect(processManager.hasRemainingExpectations, false); expect(state.isInitialized(), true); expect(state.releaseChannel, releaseChannel); expect(state.releaseVersion, nextVersion); expect(state.engine.candidateBranch, candidateBranch); expect(state.engine.startingGitHead, revision2); expect(state.engine.dartRevision, nextDartRevision); expect(state.framework.candidateBranch, candidateBranch); expect(state.framework.startingGitHead, revision3); expect(state.currentPhase, ReleasePhase.APPLY_ENGINE_CHERRYPICKS); expect(state.conductorVersion, revision); expect(state.incrementLevel, incrementLevel); }); test('can convert from dev style version to stable version', () async { const String revision2 = 'def789'; const String revision3 = '123abc'; const String previousDartRevision = '171876a4e6cf56ee6da1f97d203926bd7afda7ef'; const String nextDartRevision = 'f6c91128be6b77aef8351e1e3a9d07c85bc2e46e'; const String previousVersion = '1.2.0-1.0.pre'; const String nextVersion = '1.2.0'; const String incrementLevel = 'z'; final Directory engine = fileSystem.directory(checkoutsParentDirectory) .childDirectory('flutter_conductor_checkouts') .childDirectory('engine'); final File depsFile = engine.childFile('DEPS'); final List engineCommands = [ FakeCommand( command: [ 'git', 'clone', '--origin', 'upstream', '--', EngineRepository.defaultUpstream, engine.path, ], onRun: () { // Create the DEPS file which the tool will update engine.createSync(recursive: true); depsFile.writeAsStringSync(generateMockDeps(previousDartRevision)); } ), const FakeCommand( command: ['git', 'remote', 'add', 'mirror', engineMirror], ), const FakeCommand( command: ['git', 'fetch', 'mirror'], ), const FakeCommand( command: ['git', 'checkout', 'upstream/$candidateBranch'], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), const FakeCommand( command: [ 'git', 'checkout', '-b', 'cherrypicks-$candidateBranch', ], ), const FakeCommand( command: ['git', 'status', '--porcelain'], stdout: 'MM path/to/DEPS', ), const FakeCommand( command: ['git', 'add', '--all'], ), const FakeCommand( command: ['git', 'commit', "--message='Update Dart SDK to $nextDartRevision'"], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision2, ), ]; final List frameworkCommands = [ FakeCommand( command: [ 'git', 'clone', '--origin', 'upstream', '--', FrameworkRepository.defaultUpstream, fileSystem.path.join( checkoutsParentDirectory, 'flutter_conductor_checkouts', 'framework', ), ], ), const FakeCommand( command: ['git', 'remote', 'add', 'mirror', frameworkMirror], ), const FakeCommand( command: ['git', 'fetch', 'mirror'], ), const FakeCommand( command: ['git', 'checkout', 'upstream/$candidateBranch'], ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision3, ), const FakeCommand( command: [ 'git', 'checkout', '-b', 'cherrypicks-$candidateBranch', ], ), const FakeCommand( command: [ 'git', 'describe', '--match', '*.*.*', '--tags', 'refs/remotes/upstream/$candidateBranch', ], stdout: '$previousVersion-42-gabc123', ), const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision3, ), ]; final CommandRunner runner = createRunner( commands: [ const FakeCommand( command: ['git', 'rev-parse', 'HEAD'], stdout: revision, ), ...engineCommands, ...frameworkCommands, ], ); final String stateFilePath = fileSystem.path.join( platform.environment['HOME']!, kStateFileName, ); await runner.run([ 'start', '--$kFrameworkMirrorOption', frameworkMirror, '--$kEngineMirrorOption', engineMirror, '--$kCandidateOption', candidateBranch, '--$kReleaseOption', releaseChannel, '--$kStateOption', stateFilePath, '--$kDartRevisionOption', nextDartRevision, '--$kIncrementOption', incrementLevel, ]); final File stateFile = fileSystem.file(stateFilePath); final pb.ConductorState state = pb.ConductorState(); state.mergeFromProto3Json( jsonDecode(stateFile.readAsStringSync()), ); expect(processManager.hasRemainingExpectations, false); expect(state.isInitialized(), true); expect(state.releaseChannel, releaseChannel); expect(state.releaseVersion, nextVersion); expect(state.engine.candidateBranch, candidateBranch); expect(state.engine.startingGitHead, revision2); expect(state.engine.dartRevision, nextDartRevision); expect(state.framework.candidateBranch, candidateBranch); expect(state.framework.startingGitHead, revision3); expect(state.currentPhase, ReleasePhase.APPLY_ENGINE_CHERRYPICKS); expect(state.conductorVersion, revision); expect(state.incrementLevel, incrementLevel); }); }, onPlatform: { 'windows': const Skip('Flutter Conductor only supported on macos/linux'), }); } String generateMockDeps(String dartRevision) { return ''' vars = { 'chromium_git': 'https://chromium.googlesource.com', 'swiftshader_git': 'https://swiftshader.googlesource.com', 'dart_git': 'https://dart.googlesource.com', 'flutter_git': 'https://flutter.googlesource.com', 'fuchsia_git': 'https://fuchsia.googlesource.com', 'github_git': 'https://github.com', 'skia_git': 'https://skia.googlesource.com', 'ocmock_git': 'https://github.com/erikdoe/ocmock.git', 'skia_revision': '4e9d5e2bdf04c58bc0bff57be7171e469e5d7175', 'dart_revision': '$dartRevision', 'dart_boringssl_gen_rev': '7322fc15cc065d8d2957fccce6b62a509dc4d641', }'''; }