Request: matchers specifically for streams

[kevmoo]

From @DartBot on March 4, 2013 4:40

This issue was originally filed by @sethladd

---

I'd love to see some matchers specifically for testing streams. The matchers package has a few matchers for handling Future (like completes).

Copied from original issue: dart-lang/sdk#8899

[kevmoo]

From @DartBot on March 4, 2013 4:40

This comment was originally written by @sethladd

---

File under Area=UnitTest

[kevmoo]

From @lrhn on March 4, 2013 13:33

Removed Type-Defect label.
Added Type-Enhancement, Area-UnitTest, Triaged labels.

[kevmoo]

From @DartBot on March 4, 2013 17:34

This comment was originally written by @seaneagan

---

For starters could make most Iterable Matchers also work for Streams, since the API is so similar:

isEmpty
hasLength
contains
isIn
orderedEquals
unorderedEquals
someElement (rename to anyElement, since Iterable.some is now Iterable.any)
everyElement

[kevmoo]

From @DartBot on March 4, 2013 19:35

This comment was originally written by @seaneagan

---

I think to help with implementing these sorts of Matchers, it would probably be useful if Matcher.matches were allowed to return a Future<bool> instead of just a bool.

[kevmoo]

From @DartBot on March 4, 2013 21:5

This comment was originally written by @seaneagan

---

And actually it would probably work better as a rich MatchResult object instead of a plain bool, so it can store data about why it didn't match, to be used in "describe":

class Matcher {
  /// returns either [MatchResult] or [Future<MatchResult>] representing the match result
  match(object);
}

class MatchResult {
  final bool isMatch;
  Description describe(Description description, {bool verbose = false});
}
class Match extends MatchResult {...}
class Mismatch extends MatchResult {...}

[kevmoo]

From @gramster on April 24, 2013 20:21

Regarding the mismatch state, we already have a mechanism for that (MatchState).

[kevmoo]

From @DartBot on April 24, 2013 21:10

This comment was originally written by @seaneagan

---

returning Future<bool> from Matcher.matches is filed as issue #10188

[kevmoo]

Added Pkg-Unittest label.

[kevmoo]

Removed Area-UnitTest label.
Added Area-Pkg label.

[kevmoo]

Removed Pkg-Unittest label.
Added Pkg-matcher label.

[kevmoo]

From @sethladd on June 4, 2015 22:52

cc @kevmoo @nex3

Please close if this isn't planned.

[kevmoo]

From @nex3 on June 4, 2015 23:41

This is still planned, although it'll be in test rather than matcher.

[nex3]

Duplicate of #25.