Marble testing

[mbonneau]

This PR is a preliminary implementation of marble testing as requested at SunshinePHP at the talk by @luijar see: https://github.com/ReactiveX/rxjs/blob/master/doc/writing-marble-tests.md

Example:

    public function testMapAddOne()
    {
        $cold     = '--1--2--|';
        $expected = '--2--3--|';

        $results = $this->scheduler->startWithCreate(function () use ($cold) {
            return $this->createCold($cold)->map(function ($x) { return $x + 1; });
        });

        $this->assertEquals($expected, $this->convertMessagesToMarbles($results->getMessages()));
    }

[luijar]

You guys rock! LOL Looking good...!!

[asm89]

Nice! :)

Off-topic, but are the slides for that talk somewhere? Cool to hear people are doing talks about RxPHP!

[asm89]

nit: perhaps extract this to some util? It might be useful in other contexts as well. E.g. demos and auto extracting marbles/tests from docs at some point.

[asm89]

nit: remove

[martinsik]

In RxJS 5 they very often use also spaces " " (https://github.com/ReactiveX/rxjs/blob/master/spec/operators/window-spec.ts).

This is what I used in #144

case '-': // nothing
case ' ':
    continue;

https://github.com/martinsik/RxPHP/blob/002671800236c56d872a68dc635a5836c4f39448/test/Rx/Functional/FunctionalTestCase.php#L156

[martinsik]

Just $eventMap[$i] assumes that the $eventMap array is indexed by time (eg. [0 => 'abc', 13 => 'def', 16 => ...])

For #144 I updated it to use the same approach as RxJS 5:

$eventKey = $marbles[$i];
$events[] = onNext($i * 10, isset($eventMap[$eventKey]) ? $eventMap[$eventKey] : $marbles[$i]);

So I can use it as [ 'x' => $x, 'y' => $y, 'z' => $z ]

https://github.com/martinsik/RxPHP/blob/002671800236c56d872a68dc635a5836c4f39448/test/Rx/Functional/FunctionalTestCase.php#L169

[martinsik]

I think I can't commit to your PR (or I don't know how) but when testing #144 I made also a method to convert subscription marbles to proper Subscription objects.

https://github.com/martinsik/RxPHP/blob/002671800236c56d872a68dc635a5836c4f39448/test/Rx/Functional/FunctionalTestCase.php#L120

This is then automatically used when calling assertSubscriptions.

https://github.com/martinsik/RxPHP/blob/002671800236c56d872a68dc635a5836c4f39448/test/Rx/Functional/FunctionalTestCase.php#L64

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling b2a3ae6 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling b2a3ae6 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling b2a3ae6 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling b2a3ae6 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling 3ea6d38 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling a619b72 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling 6e35541 on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.

[coveralls]

Coverage increased (+0.05%) to 100.0% when pulling 416034c on mbonneau:marbleTest into 52f7b01 on ReactiveX:2.x.