Start sketching out a buildAll() method.

pkg/barback/lib/src/errors.dart

 // Copyright (c) 2013, 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.
 
 library barback.errors;
 
 import 'dart:async';
 
 import 'package:stack_trace/stack_trace.dart';
 
 import 'asset_id.dart';
 import 'transformer.dart';
 
 /// Error thrown when an asset with [id] cannot be found.
 class AssetNotFoundException implements Exception {
   final AssetId id;
 
   AssetNotFoundException(this.id);
 
   String toString() => "Could not find asset $id.";
 }
 
+/// Recursively replaces any occurrences of [AggregateException] in [errors]

[nweiz, 2013/08/20 22:29:03]

Remove "Recursively"

[Bob Nystrom, 2013/08/21 18:10:23]

Done.

+/// with the list of errors it contains.
+Iterable<BarbackException> flattenAggregateExceptions(
+    Iterable<BarbackException> errors) {
+  return errors.expand((error) {
+    if (error is! AggregateException) return [error];
+    return error.errors;
+  });
+}
+
 /// The interface for exceptions from the barback graph or its transformers.
 ///
 /// These exceptions are never produced by programming errors in barback.
-abstract class BarbackException implements Exception {}
+abstract class BarbackException implements Exception {
+  /// Takes a collection of [BarbackExceptions] and returns a single exception
+  /// that contains them all.
+  ///
+  /// If [errors] is empty, returns `null`. If it only has one error, that
+  /// error is returned. Otherwise, an [AggregateException] is returned.
+  static BarbackException aggregate(Iterable<BarbackException> errors) {
+    if (errors.isEmpty) return null;
+    if (errors.length == 1) return errors.single;
+    return new AggregateException(errors);
+  }
+}
+
+/// An error that wraps a collection of other [BarbackException]s.
+///
+/// It implicitly flattens any [AggregateException]s that occur in the list of
+/// exceptions it wraps.
+class AggregateException implements BarbackException {
+  final Set<BarbackException> errors;
+
+  AggregateException(Iterable<BarbackException> errors)
+      : errors = flattenAggregateExceptions(errors).toSet();
+
+  String toString() => "Multiple errors occurred:\n\n- ${errors.join('\n- ')}";

[nweiz, 2013/08/20 22:29:03]

We should be prepared for an individual error to be multiple lines long. Barback
already has [prefixLines] in utils, so you can use that.

[Bob Nystrom, 2013/08/21 18:10:23]

Done.

+}
 
 /// Error thrown when two or more transformers both output an asset with [id].
 class AssetCollisionException implements BarbackException {
   /// All the transforms that output an asset with [id].
   ///
   /// If this only contains a single transform, that indicates that a
   /// transformer produced an output that collides with a source asset or an
   /// asset from a previous phase.
   final Set<TransformInfo> transforms;
   final AssetId id;
@@ skipping 22 matching lines @@
   /// The transform that output the asset.
   final TransformInfo transform;
   final AssetId id;
 
   InvalidOutputException(this.transform, this.id);
 
   String toString() => "Transform $transform emitted $id, which wasn't in the "
       "same package (${transform.primaryId.package}).";
 }
 
+/// Base class for an error that wraps another.
+abstract class WrappedException implements BarbackException {

[nweiz, 2013/08/20 22:29:03]

This class should be private.

[Bob Nystrom, 2013/08/21 18:10:23]

Done.

+  /// The wrapped exception.
+  final error;
+
+  WrappedException(this.error);
+
+  String get _message;
+
+  String toString() {
+    var result = "$_message: $error";
+
+    var stack = getAttachedStackTrace(error);
+    if (stack != null) {
+      result = "$result\n${new Trace.from(stack).terse}";
+    }
+
+    return result;
+  }
+}
+
 /// Error wrapping an exception thrown by a transform.
-class TransformerException implements BarbackException {
+class TransformerException extends WrappedException {
   /// The transform that threw the exception.
   final TransformInfo transform;
 
-  /// The wrapped exception.
-  final error;
+  TransformerException(this.transform, error)
+      : super(error);
 
-  TransformerException(this.transform, this.error);
-
-  String toString() => "Transform $transform threw error: $error\n" +
-    new Trace.from(getAttachedStackTrace(error)).terse.toString();
+  String get _message => "Transform $transform threw error";
 }
 
 /// Error thrown when a source asset [id] fails to load.
 ///
 /// This can be thrown either because the source asset was expected to exist and
 /// did not or because reading it failed somehow.
-class AssetLoadException implements BarbackException {
+class AssetLoadException extends WrappedException {
   final AssetId id;
 
-  /// The wrapped exception.
-  final error;
+  AssetLoadException(this.id, error)
+      : super(error);
 
-  AssetLoadException(this.id, this.error);
-
-  String toString() => "Failed to load source asset $id: $error\n"
-      "${new Trace.from(getAttachedStackTrace(error)).terse}";
+  String get _message => "Failed to load source asset $id";
 }
 
 /// Information about a single transform in the barback graph.
 ///
 /// Identifies a single transformation in the barback graph.
 ///
 /// A transformation is uniquely identified by the ID of its primary input, and
 /// the transformer that is applied to it.
 class TransformInfo {
   /// The transformer that's run for this transform.
   final Transformer transformer;
 
   /// The id of this transform's primary asset.
   final AssetId primaryId;
 
   TransformInfo(this.transformer, this.primaryId);
 
   bool operator==(other) =>
       other is TransformInfo &&
       other.transformer == transformer &&
       other.primaryId == primaryId;
 
   int get hashCode => transformer.hashCode ^ primaryId.hashCode;
 
   String toString() => "$transformer on $primaryId";
 }