Replace someElement with anyElement.

pkg/unittest/lib/src/iterable_matchers.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of matcher;
 
 /**
  * Returns a matcher which matches [Iterable]s in which all elements
  * match the given [matcher].
  */
@@ skipping 40 matching lines @@
       }
       mismatchDescription.add(' at index $index');
       return mismatchDescription;
     }
     return super.describeMismatch(item, mismatchDescription,
           matchState, verbose);
   }
 }
 
 /**
+ * Deprecated form of [anyElement].
+ */
+@deprecated
+Matcher someElement(matcher) => new _AnyElement(wrapMatcher(matcher));
+
+/**
  * Returns a matcher which matches [Iterable]s in which at least one
  * element matches the given [matcher].
  */
-Matcher someElement(matcher) => new _SomeElement(wrapMatcher(matcher));
+Matcher anyElement(matcher) => new _AnyElement(wrapMatcher(matcher));
 
-class _SomeElement extends _IterableMatcher {
+class _AnyElement extends _IterableMatcher {
   Matcher _matcher;
 
-  _SomeElement(this._matcher);
+  _AnyElement(this._matcher);
 
   bool matches(item, Map matchState) {
     return item.any((e) => _matcher.matches(e, matchState));

[Sean Eagan, 2013/07/25 16:55:15]

In describe below, 'some element ' -> 'any element ' ?

[gram, 2013/07/25 17:07:05]

I thought about that but IMO 'some element' reads better in the error messages;
I personally find the anyElement name less clear than someElement and we don't
need to change the message to match if it doesn't make sense. If you disagree
let me know.

To me, in English, you would typically say things like:

- you can come on any day; we will be here
- on some days it rains

and in the first case you really mean we will be here every day, so I find using
this as an assert is confusing; it suggests to me that you can 'pick any element
and the assert is true', i.e. 'the assert is true for all elements'.

   }
 
   Description describe(Description description) =>
       description.add('some element ').addDescriptionOf(_matcher);
 }
 
 /**
  * Returns a matcher which matches [Iterable]s that have the same
  * length and the same elements as [expected], and in the same order.
  * This is equivalent to equals but does not recurse.
@@ skipping 157 matching lines @@
       return mismatchDescription.
           add('has ').
           addDescriptionOf(matchState["actual"]).
           add(' which is not $_description ').
           addDescriptionOf(matchState["expected"]).
           add(' at index ${matchState["index"]}');
     }
   }
 }