| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2012, 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 matcher.string_matchers; | |
| 6 | |
| 7 import 'interfaces.dart'; | |
| 8 | |
| 9 /// Returns a matcher which matches if the match argument is a string and | |
| 10 /// is equal to [value] when compared case-insensitively. | |
| 11 Matcher equalsIgnoringCase(String value) => new _IsEqualIgnoringCase(value); | |
| 12 | |
| 13 class _IsEqualIgnoringCase extends _StringMatcher { | |
| 14 final String _value; | |
| 15 final String _matchValue; | |
| 16 | |
| 17 _IsEqualIgnoringCase(String value) | |
| 18 : _value = value, | |
| 19 _matchValue = value.toLowerCase(); | |
| 20 | |
| 21 bool matches(item, Map matchState) => | |
| 22 item is String && _matchValue == item.toLowerCase(); | |
| 23 | |
| 24 Description describe(Description description) => | |
| 25 description.addDescriptionOf(_value).add(' ignoring case'); | |
| 26 } | |
| 27 | |
| 28 /// Returns a matcher which matches if the match argument is a string and | |
| 29 /// is equal to [value], ignoring whitespace. | |
| 30 /// | |
| 31 /// In this matcher, "ignoring whitespace" means comparing with all runs of | |
| 32 /// whitespace collapsed to single space characters and leading and trailing | |
| 33 /// whitespace removed. | |
| 34 /// | |
| 35 /// For example, the following will all match successfully: | |
| 36 /// | |
| 37 /// expect("hello world", equalsIgnoringCase("hello world")); | |
| 38 /// expect(" hello world", equalsIgnoringCase("hello world")); | |
| 39 /// expect("hello world ", equalsIgnoringCase("hello world")); | |
| 40 /// | |
| 41 /// The following will not match: | |
| 42 /// | |
| 43 /// expect("helloworld", equalsIgnoringCase("hello world")); | |
| 44 /// expect("he llo world", equalsIgnoringCase("hello world")); | |
| 45 Matcher equalsIgnoringWhitespace(String value) => | |
| 46 new _IsEqualIgnoringWhitespace(value); | |
| 47 | |
| 48 class _IsEqualIgnoringWhitespace extends _StringMatcher { | |
| 49 final String _value; | |
| 50 final String _matchValue; | |
| 51 | |
| 52 _IsEqualIgnoringWhitespace(String value) | |
| 53 : _value = value, | |
| 54 _matchValue = collapseWhitespace(value); | |
| 55 | |
| 56 bool matches(item, Map matchState) => | |
| 57 item is String && _matchValue == collapseWhitespace(item); | |
| 58 | |
| 59 Description describe(Description description) => | |
| 60 description.addDescriptionOf(_matchValue).add(' ignoring whitespace'); | |
| 61 | |
| 62 Description describeMismatch(item, Description mismatchDescription, | |
| 63 Map matchState, bool verbose) { | |
| 64 if (item is String) { | |
| 65 return mismatchDescription.add('is '). | |
| 66 addDescriptionOf(collapseWhitespace(item)). | |
| 67 add(' with whitespace compressed'); | |
| 68 } else { | |
| 69 return super.describeMismatch(item, mismatchDescription, | |
| 70 matchState, verbose); | |
| 71 } | |
| 72 } | |
| 73 } | |
| 74 | |
| 75 /// Returns a matcher that matches if the match argument is a string and | |
| 76 /// starts with [prefixString]. | |
| 77 Matcher startsWith(String prefixString) => new _StringStartsWith(prefixString); | |
| 78 | |
| 79 class _StringStartsWith extends _StringMatcher { | |
| 80 final String _prefix; | |
| 81 | |
| 82 const _StringStartsWith(this._prefix); | |
| 83 | |
| 84 bool matches(item, Map matchState) => | |
| 85 item is String && item.startsWith(_prefix); | |
| 86 | |
| 87 Description describe(Description description) => | |
| 88 description.add('a string starting with ').addDescriptionOf(_prefix); | |
| 89 } | |
| 90 | |
| 91 /// Returns a matcher that matches if the match argument is a string and | |
| 92 /// ends with [suffixString]. | |
| 93 Matcher endsWith(String suffixString) => new _StringEndsWith(suffixString); | |
| 94 | |
| 95 class _StringEndsWith extends _StringMatcher { | |
| 96 final String _suffix; | |
| 97 | |
| 98 const _StringEndsWith(this._suffix); | |
| 99 | |
| 100 bool matches(item, Map matchState) => | |
| 101 item is String && item.endsWith(_suffix); | |
| 102 | |
| 103 Description describe(Description description) => | |
| 104 description.add('a string ending with ').addDescriptionOf(_suffix); | |
| 105 } | |
| 106 | |
| 107 /// Returns a matcher that matches if the match argument is a string and | |
| 108 /// contains a given list of [substrings] in relative order. | |
| 109 /// | |
| 110 /// For example, `stringContainsInOrder(["a", "e", "i", "o", "u"])` will match | |
| 111 /// "abcdefghijklmnopqrstuvwxyz". | |
| 112 | |
| 113 Matcher stringContainsInOrder(List<String> substrings) => | |
| 114 new _StringContainsInOrder(substrings); | |
| 115 | |
| 116 class _StringContainsInOrder extends _StringMatcher { | |
| 117 final List<String> _substrings; | |
| 118 | |
| 119 const _StringContainsInOrder(this._substrings); | |
| 120 | |
| 121 bool matches(item, Map matchState) { | |
| 122 if (!(item is String)) { | |
| 123 return false; | |
| 124 } | |
| 125 var from_index = 0; | |
| 126 for (var s in _substrings) { | |
| 127 from_index = item.indexOf(s, from_index); | |
| 128 if (from_index < 0) return false; | |
| 129 } | |
| 130 return true; | |
| 131 } | |
| 132 | |
| 133 Description describe(Description description) => | |
| 134 description.addAll('a string containing ', ', ', ' in order', | |
| 135 _substrings); | |
| 136 } | |
| 137 | |
| 138 /// Returns a matcher that matches if the match argument is a string and | |
| 139 /// matches the regular expression given by [re]. | |
| 140 /// | |
| 141 /// [re] can be a [RegExp] instance or a [String]; in the latter case it will be | |
| 142 /// used to create a RegExp instance. | |
| 143 Matcher matches(re) => new _MatchesRegExp(re); | |
| 144 | |
| 145 class _MatchesRegExp extends _StringMatcher { | |
| 146 RegExp _regexp; | |
| 147 | |
| 148 _MatchesRegExp(re) { | |
| 149 if (re is String) { | |
| 150 _regexp = new RegExp(re); | |
| 151 } else if (re is RegExp) { | |
| 152 _regexp = re; | |
| 153 } else { | |
| 154 throw new ArgumentError('matches requires a regexp or string'); | |
| 155 } | |
| 156 } | |
| 157 | |
| 158 bool matches(item, Map matchState) => | |
| 159 item is String ? _regexp.hasMatch(item) : false; | |
| 160 | |
| 161 Description describe(Description description) => | |
| 162 description.add("match '${_regexp.pattern}'"); | |
| 163 } | |
| 164 | |
| 165 // String matchers match against a string. We add this intermediate | |
| 166 // class to give better mismatch error messages than the base Matcher class. | |
| 167 abstract class _StringMatcher extends Matcher { | |
| 168 const _StringMatcher(); | |
| 169 Description describeMismatch(item, Description mismatchDescription, | |
| 170 Map matchState, bool verbose) { | |
| 171 if (!(item is String)) { | |
| 172 return mismatchDescription. | |
| 173 addDescriptionOf(item). | |
| 174 add(' not a string'); | |
| 175 } else { | |
| 176 return super.describeMismatch(item, mismatchDescription, | |
| 177 matchState, verbose); | |
| 178 } | |
| 179 } | |
| 180 } | |
| 181 | |
| 182 /// Utility function to collapse whitespace runs to single spaces | |
| 183 /// and strip leading/trailing whitespace. | |
| 184 String collapseWhitespace(String string) { | |
| 185 var result = new StringBuffer(); | |
| 186 var skipSpace = true; | |
| 187 for (var i = 0; i < string.length; i++) { | |
| 188 var character = string[i]; | |
| 189 if (_isWhitespace(character)) { | |
| 190 if (!skipSpace) { | |
| 191 result.write(' '); | |
| 192 skipSpace = true; | |
| 193 } | |
| 194 } else { | |
| 195 result.write(character); | |
| 196 skipSpace = false; | |
| 197 } | |
| 198 } | |
| 199 return result.toString().trim(); | |
| 200 } | |
| 201 | |
| 202 bool _isWhitespace(String ch) => | |
| 203 ch == ' ' || ch == '\n' || ch == '\r' || ch == '\t'; | |
| OLD | NEW |