Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(262)

Side by Side Diff: third_party/pkg/barback-0.13.0/lib/src/transformer.dart

Issue 291843011: Run pub tests against older versions of barback. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: code review Created 6 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
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.transformer.transformer; 5 library barback.transformer;
6 6
7 import 'dart:async'; 7 import 'dart:async';
8 8
9 import '../asset/asset_id.dart'; 9 import 'asset_id.dart';
10 import '../utils.dart';
11 import 'transform.dart'; 10 import 'transform.dart';
11 import 'utils.dart';
12 12
13 /// A [Transformer] represents a processor that takes in one or more input 13 /// A [Transformer] represents a processor that takes in one or more input
14 /// assets and uses them to generate one or more output assets. 14 /// assets and uses them to generate one or more output assets.
15 /// 15 ///
16 /// Dart2js, a SASS->CSS processor, a CSS spriter, and a tool to concatenate 16 /// Dart2js, a SASS->CSS processor, a CSS spriter, and a tool to concatenate
17 /// files are all examples of transformers. To define your own transformation 17 /// files are all examples of transformers. To define your own transformation
18 /// step, extend (or implement) this class. 18 /// step, extend (or implement) this class.
19 /// 19 ///
20 /// If possible, transformers should implement [DeclaringTransformer] as well to 20 /// If possible, transformers should implement [DeclaringTransformer] as well to
21 /// help barback optimize the package graph. 21 /// help barback optimize the package graph.
(...skipping 30 matching lines...) Expand all
52 /// 52 ///
53 /// A concrete example is dart2js. When you run dart2js, it will traverse 53 /// A concrete example is dart2js. When you run dart2js, it will traverse
54 /// all of the imports in your Dart source files and use the contents of all 54 /// all of the imports in your Dart source files and use the contents of all
55 /// of those to generate the final JS. However you still run dart2js "on" a 55 /// of those to generate the final JS. However you still run dart2js "on" a
56 /// single file: the entrypoint Dart file that has your `main()` method. 56 /// single file: the entrypoint Dart file that has your `main()` method.
57 /// This entrypoint file would be the primary input. 57 /// This entrypoint file would be the primary input.
58 /// 58 ///
59 /// If this is not overridden, defaults to allow any asset whose extension 59 /// If this is not overridden, defaults to allow any asset whose extension
60 /// matches one of the ones returned by [allowedExtensions]. If *that* is 60 /// matches one of the ones returned by [allowedExtensions]. If *that* is
61 /// not overridden, allows all assets. 61 /// not overridden, allows all assets.
62 /// 62 Future<bool> isPrimary(AssetId id) {
63 /// This may return a `Future<bool>` or, if it's entirely synchronous, a
64 /// `bool`.
65 isPrimary(AssetId id) {
66 // Allow all files if [primaryExtensions] is not overridden. 63 // Allow all files if [primaryExtensions] is not overridden.
67 if (allowedExtensions == null) return true; 64 if (allowedExtensions == null) return new Future.value(true);
68 65
69 for (var extension in allowedExtensions.split(" ")) { 66 for (var extension in allowedExtensions.split(" ")) {
70 if (id.path.endsWith(extension)) return true; 67 if (id.path.endsWith(extension)) return new Future.value(true);
71 } 68 }
72 69
73 return false; 70 return new Future.value(false);
74 } 71 }
75 72
76 /// Run this transformer on the primary input specified by [transform]. 73 /// Run this transformer on on the primary input specified by [transform].
77 /// 74 ///
78 /// The [transform] is used by the [Transformer] for two purposes (in 75 /// The [transform] is used by the [Transformer] for two purposes (in
79 /// addition to accessing the primary input). It can call `getInput()` to 76 /// addition to accessing the primary input). It can call `getInput()` to
80 /// request additional input assets. It also calls `addOutput()` to provide 77 /// request additional input assets. It also calls `addOutput()` to provide
81 /// generated assets back to the system. Either can be called multiple times, 78 /// generated assets back to the system. Either can be called multiple times,
82 /// in any order. 79 /// in any order.
83 /// 80 ///
84 /// In other words, a Transformer's job is to find all inputs for a 81 /// In other words, a Transformer's job is to find all inputs for a
85 /// transform, starting at the primary input, then generate all output assets 82 /// transform, starting at the primary input, then generate all output assets
86 /// and yield them back to the transform. 83 /// and yield them back to the transform.
87 /// 84 Future apply(Transform transform);
88 /// If this does asynchronous work, it should return a [Future] that completes
89 /// once it's finished.
90 apply(Transform transform);
91 85
92 String toString() => runtimeType.toString().replaceAll("Transformer", ""); 86 String toString() => runtimeType.toString().replaceAll("Transformer", "");
93 } 87 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698