OLD | NEW |
(Empty) | |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. |
| 4 |
| 5 library barback.graph.group_runner; |
| 6 |
| 7 import 'dart:async'; |
| 8 |
| 9 import '../asset/asset_node.dart'; |
| 10 import '../log.dart'; |
| 11 import '../transformer/transformer_group.dart'; |
| 12 import '../utils/stream_pool.dart'; |
| 13 import 'node_status.dart'; |
| 14 import 'phase.dart'; |
| 15 |
| 16 /// A class that processes all of the phases in a single transformer group. |
| 17 /// |
| 18 /// A group takes many inputs, processes them, and emits many outputs. |
| 19 class GroupRunner { |
| 20 /// The group this runner runs. |
| 21 final TransformerGroup _group; |
| 22 |
| 23 /// A string describing the location of [this] in the transformer graph. |
| 24 final String _location; |
| 25 |
| 26 /// The phases defined by this group. |
| 27 final _phases = new List<Phase>(); |
| 28 |
| 29 /// How far along [this] is in processing its assets. |
| 30 NodeStatus get status { |
| 31 // Just check the last phase, since it will check all the previous phases |
| 32 // itself. |
| 33 return _phases.last.status; |
| 34 } |
| 35 |
| 36 /// A stream that emits an event every time the group's status changes. |
| 37 Stream<NodeStatus> get onStatusChange => _onStatusChange; |
| 38 Stream _onStatusChange; |
| 39 |
| 40 /// A stream that emits any new assets emitted by [this]. |
| 41 /// |
| 42 /// Assets are emitted synchronously to ensure that any changes are thoroughly |
| 43 /// propagated as soon as they occur. |
| 44 Stream<AssetNode> get onAsset => _onAsset; |
| 45 Stream<AssetNode> _onAsset; |
| 46 |
| 47 /// A stream that emits an event whenever any transforms in this group logs |
| 48 /// an entry. |
| 49 Stream<LogEntry> get onLog => _onLogPool.stream; |
| 50 final _onLogPool = new StreamPool<LogEntry>.broadcast(); |
| 51 |
| 52 GroupRunner(Phase previous, this._group, this._location) { |
| 53 _addPhase(previous.addPhase(_location), []); |
| 54 for (var phase in _group.phases) { |
| 55 _addPhase(_phases.last.addPhase(), phase); |
| 56 } |
| 57 |
| 58 _onAsset = _phases.last.onAsset; |
| 59 _onStatusChange = _phases.last.onStatusChange; |
| 60 } |
| 61 |
| 62 /// Add a phase with [contents] to [this]'s list of phases. |
| 63 /// |
| 64 /// [contents] should be an inner [Iterable] from a [TransformGroup.phases] |
| 65 /// value. |
| 66 void _addPhase(Phase phase, Iterable contents) { |
| 67 _phases.add(phase); |
| 68 _onLogPool.add(phase.onLog); |
| 69 phase.updateTransformers(contents); |
| 70 } |
| 71 |
| 72 /// Force all [LazyTransformer]s' transforms in this group to begin producing |
| 73 /// concrete assets. |
| 74 void forceAllTransforms() { |
| 75 for (var phase in _phases) { |
| 76 phase.forceAllTransforms(); |
| 77 } |
| 78 } |
| 79 |
| 80 /// Removes this group and all sub-phases within it. |
| 81 void remove() { |
| 82 _onLogPool.close(); |
| 83 for (var phase in _phases) { |
| 84 phase.remove(); |
| 85 } |
| 86 } |
| 87 |
| 88 String toString() => "group in phase $_location for $_group"; |
| 89 } |
OLD | NEW |