First pass at build dependency graph for barback.

pkg/barback/lib/src/transform.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.transform;
+
+import 'dart:async';
+
+import 'asset.dart';
+import 'asset_id.dart';
+import 'asset_node.dart';
+import 'errors.dart';
+import 'transform_node.dart';
+
+/// Creates a [Transform] by forwarding to the private constructor.
+///
+/// Lets [TransformNode] create [Transforms] without giving a [Transform]
+/// itself a public constructor, which would be visible to external users.
+/// Unlike the [Transform] class, this function is not exported by barback.dart.
+Transform createTransform(TransformNode node, Set<AssetNode> inputs,
+                          Map<AssetId, Asset> outputs) =>
+    new Transform._(node, inputs, outputs);

[nweiz, 2013/06/20 23:06:08]

In ScheduledTest, I just bit the bullet and exposed some constructors I didn't
intend anyone to use. I feel like the code ended up cleaner that way. YMMV.

[Bob Nystrom, 2013/06/21 00:13:20]

This is a little more bullet-proof. Since this is an API that end users will
consume in non-test code, I like being as tight as possible. A bit
boilerplate-y, but I think it's actually kind of a neat trick.

+
+/// While a [Transformer] represents a *kind* of transformation, this defines
+/// one specific usage of it on a set of files.
+///
+/// This ephemeral object exists only during an actual transform application to
+/// facilitate communication between the [Transformer] and the code hosting
+/// the transformation. It lets the [Transformer] access inputs and generate
+/// outputs.
+class Transform {
+  final TransformNode _node;
+
+  final Set<AssetNode> _inputs;
+  final Map<AssetId, Asset> _outputs;
+
+  /// Gets the ID of the primary input for this transformation.
+  ///
+  /// While a transformation can use multiple input assets, one must be a
+  /// special "primary" asset. This will be the "entrypoint" or "main" input
+  /// file for a transformation.
+  ///
+  /// For example, with a dart2js transform, the primary input would be the
+  /// entrypoint Dart file. All of the other Dart files that that imports
+  /// would be secondary inputs.
+  AssetId get primaryId => _node.primary.id;
+
+  /// Gets the asset for the primary input.
+  Future<Asset> get primaryInput => getInput(primaryId);
+
+  Transform._(this._node, this._inputs, this._outputs);
+
+  /// Gets the asset for for an input [id].
+  ///
+  /// If an input with that ID cannot be found, throws an
+  /// [AssetNotFoundException].
+  Future<Asset> getInput(AssetId id) {
+    return new Future(() {
+      var node = _node.phase.inputs[id];
+      // TODO(rnystrom): Need to handle passthrough where an asset from a
+      // previous phase can be found.
+
+      // Throw if the input isn't found. This ensures the transformer's apply
+      // is exited. We'll then catch this and report it through the proper
+      // results stream.
+      if (node == null) throw new MissingInputException(id);
+
+      // Keep track of which assets this transform depends on.
+      _inputs.add(node);
+      return node.asset;
+    });
+  }
+
+  /// Stores [output] as the output created by this transformation for asset
+  /// [id]. A transformation can output as many assets as it wants.
+  void addOutput(AssetId id, Asset output) {
+    _outputs[id] = output;
+  }
+}