Add Apperture FieldMapper & unit tests

Signed-off-by: Tom Van Herreweghe <[email protected]>

Author: Miljar

src/Reader/Mapper.php

@@ -0,0 +1,56 @@
+<?php
+/**
+ * Mapper for mapping data between raw input and an Aperture VO
+ *
+ * @category    PHPExif
+ * @copyright   Copyright (c) 2016 Tom Van Herreweghe <[email protected]>
+ * @license     http://github.com/PHPExif/php-exif-exiftool/blob/master/LICENSE MIT License
+ * @link        http://github.com/PHPExif/php-exif-exiftool for the canonical source repository
+ * @package     Exiftool
+ */
+
+namespace PHPExif\Adapter\Exiftool\Reader\Mapper\Exif;
+
+use PHPExif\Common\Data\ExifInterface;
+use PHPExif\Common\Data\ValueObject\Aperture;
+use PHPExif\Common\Mapper\FieldMapper;
+use PHPExif\Common\Mapper\GuardInvalidArgumentsForExifTrait;
+
+/**
+ * Mapper
+ *
+ * @category    PHPExif
+ * @package     Common
+ */
+class ApertureFieldMapper implements FieldMapper
+{
+    use GuardInvalidArgumentsForExifTrait;
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getSupportedFields()
+    {
+        return array(
+            Aperture::class,
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function mapField($field, array $input, &$output)
+    {
+        $this->guardInvalidArguments($field, $input, $output);
+
+        if (!array_key_exists('composite:aperture', $input)) {
+            return;
+        }
+
+        $aperture = new Aperture(
+            $input['composite:aperture']
+        );
+
+        $output = $output->withAperture($aperture);
+    }
+}

src/Reader/Mapper/Exif/ApertureFieldMapper.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace Tests\PHPExif\Adapter\Exiftool\Reader\Mapper\Exif;
+
+use Mockery as m;
+use PHPExif\Adapter\Exiftool\Reader\Mapper\Exif\ApertureFieldMapper;
+use PHPExif\Common\Data\Exif;
+use PHPExif\Common\Data\ValueObject\Aperture;
+
+/**
+ * Class: ApertureFieldMapperTest
+ *
+ * @see \PHPUnit_Framework_TestCase
+ * @coversDefaultClass \PHPExif\Adapter\Exiftool\Reader\Mapper\Exif\ApertureFieldMapper
+ * @covers ::<!public>
+ */
+class ApertureFieldMapperTest extends BaseFieldMapperTest
+{
+    /**
+     * FQCN of the fieldmapper being tested
+     *
+     * @var mixed
+     */
+    protected $fieldMapperClass = ApertureFieldMapper::class;
+
+    /**
+     * List of supported fields
+     *
+     * @var array
+     */
+    protected $supportedFields = [
+        Aperture::class,
+    ];
+
+    /**
+     * Valid input data
+     *
+     * @var array
+     */
+    protected $validInput = [
+        'composite:aperture' => 5.0,
+    ];
+
+    /**
+     * @covers ::mapField
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testMapFieldHasDataInOutput()
+    {
+        $field = reset($this->supportedFields);
+        $output = new Exif;
+        $mapper = new $this->fieldMapperClass();
+
+        $originalData = $output->getAperture();
+        $mapper->mapField($field, $this->validInput, $output);
+        $newData = $output->getAperture();
+
+        $this->assertNotSame($originalData, $newData);
+
+        $this->assertInstanceOf(
+            Aperture::class,
+            $newData
+        );
+
+        $this->assertEquals(
+            'f/' . $this->validInput['composite:aperture'],
+            (string) $newData
+        );
+    }
+}

tests/unit/Reader/Mapper/Exif/ApertureFieldMapperTest.php

@@ -0,0 +1,137 @@
+<?php
+
+namespace Tests\PHPExif\Adapter\Exiftool\Reader\Mapper\Exif;
+
+use Mockery as m;
+use PHPExif\Common\Data\Exif;
+use PHPExif\Common\Exception\Mapper\UnsupportedFieldException;
+use PHPExif\Common\Exception\Mapper\UnsupportedOutputException;
+
+/**
+ * Class: BaseFieldMapperTest
+ *
+ * @see \PHPUnit_Framework_TestCase
+ */
+abstract class BaseFieldMapperTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * FQCN of the fieldmapper being tested
+     *
+     * @var mixed
+     */
+    protected $fieldMapperClass;
+
+    /**
+     * List of supported fields
+     *
+     * @var array
+     */
+    protected $supportedFields = [];
+
+    /**
+     * Valid input data
+     *
+     * @var array
+     */
+    protected $validInput = [];
+
+    /**
+     * @covers ::getSupportedFields
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testGetSupportedFieldsReturnsExpectedArray()
+    {
+        $mapper = new $this->fieldMapperClass();
+        $actual = $mapper->getSupportedFields();
+
+        $this->assertInternalType('array', $actual);
+
+        $this->assertEquals($this->supportedFields, $actual);
+    }
+
+    /**
+     * @covers ::mapField
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testMapFieldThrowsExceptionForUnsupportedField()
+    {
+        $this->setExpectedException(UnsupportedFieldException::class);
+
+        $field = 'foo';
+        $input = [];
+        $output = new Exif;
+        $mapper = new $this->fieldMapperClass();
+
+        $mapper->mapField($field, $input, $output);
+    }
+
+    /**
+     * @covers ::mapField
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testMapFieldThrowsExceptionForUnsupportedOutput()
+    {
+        $this->setExpectedException(UnsupportedOutputException::class);
+
+        $field = reset($this->supportedFields);
+        $input = [];
+        $output = new \stdClass;
+        $mapper = new $this->fieldMapperClass();
+
+        $mapper->mapField($field, $input, $output);
+    }
+
+    /**
+     * @covers ::mapField
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testMapFieldYieldsNewOutputForValidInput()
+    {
+        $field = reset($this->supportedFields);
+        $output = new Exif;
+        $mapper = new $this->fieldMapperClass();
+
+        $originalHash = spl_object_hash($output);
+
+        $mapper->mapField($field, $this->validInput, $output);
+
+        $newHash = spl_object_hash($output);
+
+        $this->assertNotEquals(
+            $originalHash,
+            $newHash
+        );
+    }
+
+    /**
+     * @covers ::mapField
+     * @group mapper
+     *
+     * @return void
+     */
+    public function testMapFieldYieldsSameOutputForInvalidInput()
+    {
+        $field = reset($this->supportedFields);
+        $output = new Exif;
+        $mapper = new $this->fieldMapperClass();
+
+        $originalHash = spl_object_hash($output);
+
+        $mapper->mapField($field, [], $output);
+
+        $newHash = spl_object_hash($output);
+
+        $this->assertEquals(
+            $originalHash,
+            $newHash
+        );
+    }
+}