Skip to content

Commit

Permalink
Add ability to recover from a deleted cache
Browse files Browse the repository at this point in the history
  • Loading branch information
jakemac53 committed Feb 8, 2016
1 parent dcc318b commit 4f2148f
Show file tree
Hide file tree
Showing 2 changed files with 121 additions and 21 deletions.
111 changes: 91 additions & 20 deletions lib/src/generate/build.dart
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
// BSD-style license that can be found in the LICENSE file.
import 'dart:async';
import 'dart:convert';
import 'dart:io';

import 'package:logging/logging.dart';
import 'package:path/path.dart' as path;
Expand Down Expand Up @@ -51,26 +52,24 @@ Future<BuildResult> build(List<List<Phase>> phaseGroups,
writer ??=
new CachedAssetWriter(cache, new FileBasedAssetWriter(packageGraph));

/// Asset containing previous build outputs.
var buildOuputsId =
new AssetId(packageGraph.root.name, '.build/build_outputs.json');

/// Run the build in a zone.
var result = await runZoned(() async {
try {
/// Read in previous build_outputs file, and delete them all.
if (await _reader.hasInput(buildOuputsId)) {
var previousOutputs =
JSON.decode(await _reader.readAsString(buildOuputsId));
await writer.delete(buildOuputsId);
await Future.wait(previousOutputs.map((output) {
return writer.delete(new AssetId.deserialize(output));
}));
}
/// Delete all previous outputs!
await _deletePreviousOutputs(phaseGroups);

/// Run a fresh build.
return _runPhases(phaseGroups);
} catch(e, s) {
var result = await _runPhases(phaseGroups);

// Write out the new build_outputs file.
var buildOutputsAsset = new Asset(
_buildOutputsId,
JSON.encode(
result.outputs.map((output) => output.id.serialize()).toList()));
await writer.writeAsString(buildOutputsAsset);

return result;
} catch (e, s) {
return new BuildResult(BuildStatus.Failure, BuildType.Full, [],
exception: e, stackTrace: s);
}
Expand All @@ -82,11 +81,6 @@ Future<BuildResult> build(List<List<Phase>> phaseGroups,

await logListener.cancel();

// Write out the new build_outputs file.
var buildOutputsAsset = new Asset(buildOuputsId,
JSON.encode(result.outputs.map((output) => output.id.serialize()).toList()));
await writer.writeAsString(buildOutputsAsset);

return result;
}

Expand All @@ -100,6 +94,83 @@ AssetReader get _reader => Zone.current[_assetReaderKey];
AssetWriter get _writer => Zone.current[_assetWriterKey];
PackageGraph get _packageGraph => Zone.current[_packageGraphKey];

/// Asset containing previous build outputs.
AssetId get _buildOutputsId =>
new AssetId(_packageGraph.root.name, '.build/build_outputs.json');

/// Deletes all previous output files.
Future _deletePreviousOutputs(List<List<Phase>> phaseGroups) async {
if (await _reader.hasInput(_buildOutputsId)) {
// Cache file exists, just delete all outputs contained in it.
var previousOutputs =
JSON.decode(await _reader.readAsString(_buildOutputsId));
await _writer.delete(_buildOutputsId);
return Future.wait(previousOutputs.map((output) {
return _writer.delete(new AssetId.deserialize(output));
}));
}

// No cache file exists, run `declareOutputs` on all phases
final allInputs = await _allInputs(phaseGroups);
final conflictingOutputs = new Set<AssetId>();

for (var group in phaseGroups) {
final groupOutputIds = <AssetId>[];
for (var phase in group) {
var inputs = _matchingInputs(allInputs, phase.inputSets);
for (var input in inputs) {
for (var builder in phase.builders) {
var outputs = builder.declareOutputs(input);
groupOutputIds.addAll(outputs);
for (var output in outputs) {
if (allInputs[output.package]?.contains(output) == true) {
conflictingOutputs.add(output);
}
}
}
}
}

/// Once the group is done, add all outputs so they can be used in the next
/// phase.
for (var outputId in groupOutputIds) {
allInputs.putIfAbsent(outputId.package, () => new Set<AssetId>());
allInputs[outputId.package].add(outputId);
}
}

// Check conflictingOuputs, prompt user to delete files.
if (conflictingOutputs.isNotEmpty) {
stdout.writeln('Found ${conflictingOutputs.length} declared outputs '
'which already exist on disk. This is likely because the `.build` '
'folder was deleted.');
var done = false;
while(!done) {
stdout.write('Delete these files (y/n) (or list them (l))?: ');
var input = stdin.readLineSync();
switch(input) {
case 'y':
stdout.writeln('Deleting files...');
await Future.wait(conflictingOutputs.map((output) {
return _writer.delete(output);
}));
done = true;
break;
case 'n':
done = true;
break;
case 'l':
for (var output in conflictingOutputs) {
stdout.writeln(output);
}
break;
default:
stdout.writeln('Unrecognized option $input, (y/n/l) expected.');
}
}
}
}

/// Runs the [phaseGroups] and returns a [Future<BuildResult>] which completes
/// once all [Phase]s are done.
Future<BuildResult> _runPhases(List<List<Phase>> phaseGroups) async {
Expand Down
31 changes: 30 additions & 1 deletion test/generate/build_test.dart
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
// Copyright (c) 2016, the Dart project authors. Please see the AUTHORS file
// for details. 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:convert';
import 'dart:io';

import 'package:test/test.dart';

Expand Down Expand Up @@ -211,6 +213,30 @@ main() {
// Second run, should have no extra outputs.
await testPhases(phases, inputs, outputs: outputs, writer: writer);
});

test('can recover from a deleted build_outputs.json cache', () async {
var phases = [
[
new Phase([new CopyBuilder()], [new InputSet('a')]),
]
];
final writer = new InMemoryAssetWriter();
var inputs = {'a|web/a.txt': 'a', 'a|lib/b.txt': 'b'};
var outputs = {'a|web/a.txt.copy': 'a', 'a|lib/b.txt.copy': 'b'};
// First run, nothing special.
await testPhases(phases, inputs, outputs: outputs, writer: writer);

// Delete the `build_outputs.json` file!
var outputId = makeAssetId('a|.build/build_outputs.json');
await writer.delete(outputId);

// Second run, should have no extra outputs.
var done = testPhases(phases, inputs, outputs: outputs, writer: writer);
// Should block on user input.
await new Future.delayed(new Duration(seconds: 1));
// Now it should complete!
await done;
}, skip: 'Need to manually add a `y` to stdin for this test to run.');
}

testPhases(List<List<Phase>> phases, Map<String, String> inputs,
Expand All @@ -222,6 +248,7 @@ testPhases(List<List<Phase>> phases, Map<String, String> inputs,
writer ??= new InMemoryAssetWriter();
final actualAssets = writer.assets;
final reader = new InMemoryAssetReader(actualAssets);

inputs.forEach((serializedId, contents) {
writer.writeAsString(makeAsset(serializedId, contents));
});
Expand All @@ -233,7 +260,9 @@ testPhases(List<List<Phase>> phases, Map<String, String> inputs,

var result = await build(phases,
reader: reader, writer: writer, packageGraph: packageGraph);
expect(result.status, status);
expect(result.status, status,
reason: 'Exception:\n${result.exception}\n'
'Stack Trace:\n${result.stackTrace}');
if (exceptionMatcher != null) {
expect(result.exception, exceptionMatcher);
}
Expand Down

0 comments on commit 4f2148f

Please sign in to comment.