Added tests for Flatten and Collection strategies.

Added ignore keys option to Flatten strategy.
Added docblocks to Mapping.

Author: Bilge

src/Mapper/Mapping.php

@@ -1,12 +1,23 @@
 <?php
 namespace ScriptFUSION\Mapper;
 
+/**
+ * Represents a mapping of keys and mappable values.
+ */
 abstract class Mapping extends \ArrayObject
 {
+    /**
+     * Initializes this mapping.
+     */
     public function __construct()
     {
         parent::__construct($this->createMap());
     }
 
+    /**
+     * Creates a mapping of key names and mappable values.
+     *
+     * @return array Mapping.
+     */
     abstract protected function createMap();
 }

src/Mapper/Strategy/Flatten.php

@@ -3,9 +3,18 @@
 
 class Flatten extends Delegate
 {
+    private $ignoreKeys = false;
+
+    public function ignoreKeys($ignore = true)
+    {
+        $this->ignoreKeys = $ignore;
+
+        return $this;
+    }
+
     public function __invoke($data, $context = null)
     {
-        return iterator_to_array($this->flatten(parent::__invoke($data, $context)));
+        return iterator_to_array($this->flatten(parent::__invoke($data, $context)), !$this->ignoreKeys);
     }
 
     private function flatten($data)

test/Integration/Mapper/Strategy/CollectionTest.php

@@ -0,0 +1,41 @@
+<?php
+namespace ScriptFUSIONTest\Integration\Mapper\Strategy;
+
+use ScriptFUSION\Mapper\Mapper;
+use ScriptFUSION\Mapper\Strategy\Collection;
+use ScriptFUSION\Mapper\Strategy\CopyContext;
+use ScriptFUSIONTest\MockFactory;
+
+final class CollectionTest extends \PHPUnit_Framework_TestCase
+{
+    public function testNull()
+    {
+        /** @var Collection $collection */
+        $collection = (new Collection(null, null))->setMapper(MockFactory::mockMapper(null));
+
+        self::assertNull($collection([]));
+    }
+
+    public function testCollection()
+    {
+        /** @var Collection $collection */
+        $collection = (new Collection(
+            $this->createCollection('foo'),
+            [
+                'bar' => new CopyContext('foo'),
+            ]
+        ))->setMapper(new Mapper);
+
+        self::assertSame($this->createCollection('bar'), $collection([]));
+    }
+
+    private function createCollection($key)
+    {
+        return array_map(
+            function ($number) use ($key) {
+                return [$key => $number];
+            },
+            range(1, 10)
+        );
+    }
+}

test/Unit/Mapper/Strategy/FlattenTest.php

@@ -0,0 +1,41 @@
+<?php
+namespace ScriptFUSIONTest\Unit\Mapper\Strategy;
+
+use ScriptFUSION\Mapper\Strategy\Flatten;
+use ScriptFUSIONTest\MockFactory;
+
+final class FlattenTest extends \PHPUnit_Framework_TestCase
+{
+    public function testValues()
+    {
+        /** @var Flatten $flatten */
+        $flatten = (new Flatten(null))
+            ->ignoreKeys()
+            ->setMapper(MockFactory::mockMapper(['foo', ['bar', ['baz']]]))
+        ;
+
+        self::assertSame(['foo', 'bar', 'baz'], $flatten([]));
+    }
+
+    public function testUniqueKeys()
+    {
+        /** @var Flatten $flatten */
+        $flatten = (new Flatten(null))
+            ->setMapper(MockFactory::mockMapper(['foo' => 'foo', ['bar' => 'bar', ['baz' => 'baz']]]))
+        ;
+
+        self::assertSame(['foo' => 'foo', 'bar' => 'bar', 'baz' => 'baz'], $flatten([]));
+    }
+
+    public function testDuplicateKeys()
+    {
+        /** @var Flatten $flatten */
+        $flatten = (new Flatten(null))
+            ->setMapper(MockFactory::mockMapper(['foo' => 'foo', ['bar' => 'bar', ['bar' => 'baz']]]))
+        ;
+        self::assertSame(['foo' => 'foo', 'bar' => 'baz'], $flatten([]));
+
+        $flatten->setMapper(MockFactory::mockMapper(['foo' => 'foo', ['foo' => 'bar']]));
+        self::assertSame(['foo' => 'bar'], $flatten([]));
+    }
+}