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 yaml.utils; | 5 library yaml.utils; |
6 | 6 |
| 7 import 'package:source_span/source_span.dart'; |
| 8 |
7 /// A pair of values. | 9 /// A pair of values. |
8 class Pair<E, F> { | 10 class Pair<E, F> { |
9 final E first; | 11 final E first; |
10 final F last; | 12 final F last; |
11 | 13 |
12 Pair(this.first, this.last); | 14 Pair(this.first, this.last); |
13 | 15 |
14 String toString() => '($first, $last)'; | 16 String toString() => '($first, $last)'; |
15 } | 17 } |
| 18 |
| 19 /// Print a warning. |
| 20 /// |
| 21 /// If [span] is passed, associates the warning with that span. |
| 22 void warn(String message, [SourceSpan span]) => |
| 23 yamlWarningCallback(message, span); |
| 24 |
| 25 /// A callback for emitting a warning. |
| 26 /// |
| 27 /// [message] is the text of the warning. If [span] is passed, it's the portion |
| 28 /// of the document that the warning is associated with and should be included |
| 29 /// in the printed warning. |
| 30 typedef YamlWarningCallback(String message, [SourceSpan span]); |
| 31 |
| 32 /// A callback for emitting a warning. |
| 33 /// |
| 34 /// In a very few cases, the YAML spec indicates that an implementation should |
| 35 /// emit a warning. To do so, it calls this callback. The default implementation |
| 36 /// prints a message using [print]. |
| 37 YamlWarningCallback yamlWarningCallback = (message, [span]) { |
| 38 // TODO(nweiz): Print to stderr with color when issue 6943 is fixed and |
| 39 // dart:io is available. |
| 40 if (span != null) message = span.message(message); |
| 41 print(message); |
| 42 }; |
| 43 |
| 44 |
OLD | NEW |