OLD | NEW |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 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 | 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. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 library barback.barback; | 5 library barback.barback; |
6 | 6 |
7 import 'dart:async'; | 7 import 'dart:async'; |
8 | 8 |
9 import 'asset.dart'; | 9 import 'asset/asset.dart'; |
10 import 'asset_id.dart'; | 10 import 'asset/asset_id.dart'; |
11 import 'asset_set.dart'; | 11 import 'asset/asset_set.dart'; |
12 import 'log.dart'; | 12 import 'log.dart'; |
13 import 'build_result.dart'; | 13 import 'build_result.dart'; |
14 import 'errors.dart'; | 14 import 'errors.dart'; |
15 import 'package_graph.dart'; | 15 import 'graph/package_graph.dart'; |
16 import 'package_provider.dart'; | 16 import 'package_provider.dart'; |
17 import 'transformer.dart'; | 17 import 'transformer/transformer.dart'; |
18 | 18 |
19 /// A general-purpose asynchronous build dependency graph manager. | 19 /// A general-purpose asynchronous build dependency graph manager. |
20 /// | 20 /// |
21 /// It consumes source assets (including Dart files) in a set of packages, | 21 /// It consumes source assets (including Dart files) in a set of packages, |
22 /// runs transformations on them, and then tracks which sources have been | 22 /// runs transformations on them, and then tracks which sources have been |
23 /// modified and which transformations need to be re-run. | 23 /// modified and which transformations need to be re-run. |
24 /// | 24 /// |
25 /// To do this, you give barback a [PackageProvider] which can yield a set of | 25 /// To do this, you give barback a [PackageProvider] which can yield a set of |
26 /// [Transformer]s and raw source [Asset]s. Then you tell it which input files | 26 /// [Transformer]s and raw source [Asset]s. Then you tell it which input files |
27 /// have been added or modified by calling [updateSources]. Barback will | 27 /// have been added or modified by calling [updateSources]. Barback will |
(...skipping 81 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
109 /// | 109 /// |
110 /// To the extent that [transformers] is similar to the previous transformer | 110 /// To the extent that [transformers] is similar to the previous transformer |
111 /// phases for [package], the existing asset graph will be preserved. | 111 /// phases for [package], the existing asset graph will be preserved. |
112 /// | 112 /// |
113 /// Elements of the inner iterable of [transformers] must be either | 113 /// Elements of the inner iterable of [transformers] must be either |
114 /// [Transformer]s or [TransformerGroup]s. | 114 /// [Transformer]s or [TransformerGroup]s. |
115 void updateTransformers(String package, | 115 void updateTransformers(String package, |
116 Iterable<Iterable> transformers) => | 116 Iterable<Iterable> transformers) => |
117 _graph.updateTransformers(package, transformers); | 117 _graph.updateTransformers(package, transformers); |
118 } | 118 } |
OLD | NEW |