Merge da949c7 into f4dc94c

src/Transform/AbstractTransformer.php

@@ -10,7 +10,12 @@
 
 abstract class AbstractTransformer implements TransformerInterface
 {
-    public final function __construct()
+    final public function __construct()
     {
     }
+
+    public function isString($value)
+    {
+        return is_scalar($value) || (\is_object($value) && method_exists($value, '__toString'));
+    }
 }

src/Transform/Transformation.php → src/Transform/Change.php

@@ -8,7 +8,7 @@
 namespace MilesAsylum\Slurp\Transform;
 
 
-abstract class Transformation
+abstract class Change
 {
     /**
      * @return string

src/Transform/DateTimeFormat.php

@@ -0,0 +1,46 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 15/08/18
+ * Time: 11:22 AM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+
+class DateTimeFormat extends Change
+{
+    private $formatFrom;
+
+    private $formatTo;
+
+    public function __construct($formatFrom, $formatTo)
+    {
+        $this->formatFrom = $formatFrom;
+        $this->formatTo = $formatTo;
+    }
+
+    /**
+     * @return string
+     */
+    public function getFormatFrom()
+    {
+        return $this->formatFrom;
+    }
+
+    /**
+     * @return string
+     */
+    public function getFormatTo()
+    {
+        return $this->formatTo;
+    }
+
+    /**
+     * @return string
+     */
+    public function transformedBy()
+    {
+        return DateTimeFormatTransformer::class;
+    }
+}

src/Transform/DateTimeFormatTransformer.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 15/08/18
+ * Time: 11:24 AM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+use MilesAsylum\Slurp\Transform\Exception\UnexpectedTypeException;
+
+class DateTimeFormatTransformer extends AbstractTransformer
+{
+    public function transform($value, Change $transformation)
+    {
+        if (!$transformation instanceof DateTimeFormat) {
+            throw new UnexpectedTypeException($transformation, DateTimeFormat::class);
+        }
+
+        if (!$this->isString($value)) {
+            throw new UnexpectedTypeException($value, 'string');
+        }
+
+        $value = \DateTime::createFromFormat($transformation->getFormatFrom(), $value);
+
+        if ($value === false) {
+            throw new \InvalidArgumentException(
+                sprintf(
+                    'The date value %s was not able to be converted from the format %s',
+                    $value,
+                    $transformation->getFormatFrom()
+                )
+            );
+        }
+
+        return $value->format($transformation->getFormatTo());
+    }
+}

src/Transform/Exception/UnexpectedTypeException.php

@@ -7,7 +7,6 @@
 
 namespace MilesAsylum\Slurp\Transform\Exception;
 
-
 class UnexpectedTypeException extends \InvalidArgumentException implements ExceptionInterface
 {
     public function __construct($value, string $expectedType)

src/Transform/StrCase.php

@@ -0,0 +1,31 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 13/08/18
+ * Time: 10:52 PM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+class StrCase extends Change
+{
+    private $caseChange;
+
+    const CASE_UPPER = 'upper';
+    const CASE_LOWER = 'lower';
+
+    public function __construct($caseChange)
+    {
+        $this->caseChange = $caseChange;
+    }
+
+    public function transformedBy()
+    {
+        return StrCaseTransformer::class;
+    }
+
+    public function getCaseChange()
+    {
+        return $this->caseChange;
+    }
+}

src/Transform/StrCaseTransformer.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 13/08/18
+ * Time: 10:53 PM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+use MilesAsylum\Slurp\Transform\Exception\UnexpectedTypeException;
+
+class StrCaseTransformer extends AbstractTransformer
+{
+    public function transform($value, Change $transformation)
+    {
+        if (!$transformation instanceof StrCase) {
+            throw new UnexpectedTypeException($transformation, StrCase::class);
+        }
+
+        if (!$this->isString($value)) {
+            throw new UnexpectedTypeException($value, 'string');
+        }
+
+        switch ($transformation->getCaseChange()) {
+            case StrCase::CASE_UPPER:
+                $value = strtoupper($value);
+                break;
+            case StrCase::CASE_LOWER:
+                $value = strtolower($value);
+                break;
+        }
+
+        return $value;
+    }
+}

src/Transform/Transformer.php

@@ -11,7 +11,7 @@
 class Transformer
 {
     /**
-     * @var Transformation[][]
+     * @var Change[][]
      */
     protected $columnTranslators = [];
 
@@ -33,7 +33,7 @@ public function __construct(TransformerLoader $loader, array $columns)
 
     /**
      * @param $columnName
-     * @param Transformation|Transformation[] $transformations
+     * @param Change|Change[] $transformations
      */
     public function addColumnTransformations($columnName, $transformations)
     {

src/Transform/TransformerInterface.php

@@ -9,5 +9,5 @@
 
 interface TransformerInterface
 {
-    public function transform($value, Transformation $transformation);
+    public function transform($value, Change $transformation);
 }

src/Transform/TransformerLoader.php

@@ -15,10 +15,10 @@ class TransformerLoader
     private $loadedTransformers = [];
 
     /**
-     * @param Transformation $transformation
+     * @param Change $transformation
      * @return TransformerInterface
      */
-    public function loadTransformer(Transformation $transformation)
+    public function loadTransformer(Change $transformation)
     {
         if (!isset($this->loadedTransformers[$transformation->transformedBy()])) {
             $transformedBy = $transformation->transformedBy();

src/Transform/Trim.php

@@ -0,0 +1,72 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 15/08/18
+ * Time: 10:45 AM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+
+class Trim extends Change
+{
+    /**
+     * @var string
+     */
+    private $chars;
+
+    /**
+     * @var bool
+     */
+    private $fromLeft;
+
+    /**
+     * @var bool
+     */
+    private $fromRight;
+
+    /**
+     * Trim constructor.
+     * @param bool $fromLeft
+     * @param bool $fromRight
+     * @param string $chars
+     */
+    public function __construct($fromLeft = true, $fromRight = true, $chars = " \t\n\r\0\x0B")
+    {
+        $this->chars = $chars;
+        $this->fromLeft = $fromLeft;
+        $this->fromRight = $fromRight;
+    }
+
+    /**
+     * @return string
+     */
+    public function getChars(): string
+    {
+        return $this->chars;
+    }
+
+    /**
+     * @return bool
+     */
+    public function fromLeft(): bool
+    {
+        return $this->fromLeft;
+    }
+
+    /**
+     * @return bool
+     */
+    public function fromRight(): bool
+    {
+        return $this->fromRight;
+    }
+
+    /**
+     * @return string
+     */
+    public function transformedBy()
+    {
+        return TrimTransformer::class;
+    }
+}

src/Transform/TrimTransformer.php

@@ -0,0 +1,34 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 15/08/18
+ * Time: 10:45 AM
+ */
+
+namespace MilesAsylum\Slurp\Transform;
+
+use MilesAsylum\Slurp\Transform\Exception\UnexpectedTypeException;
+
+class TrimTransformer extends AbstractTransformer
+{
+    public function transform($value, Change $transformation)
+    {
+        if (!$transformation instanceof Trim) {
+            throw new UnexpectedTypeException($transformation, Trim::class);
+        }
+
+        if (!$this->isString($value)) {
+            throw new UnexpectedTypeException($value, 'string');
+        }
+
+        if ($transformation->fromLeft() && $transformation->fromRight()) {
+            $value = trim($value, $transformation->getChars());
+        } elseif ($transformation->fromLeft()) {
+            $value = ltrim($value, $transformation->getChars());
+        } elseif ($transformation->fromRight()) {
+            $value = rtrim($value, $transformation->getChars());
+        }
+
+        return $value;
+    }
+}

src/Validate/Validator.php

@@ -65,4 +65,4 @@ protected function getCellValue($row, $column)
     {
         return $row[$this->colPositions[$column]];
     }
-}
+}

tests/Slurp/Transform/DateTimeFormatTest.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * Author: Courtney Miles
+ * Date: 15/08/18
+ * Time: 11:27 AM
+ */
+
+namespace MilesAsylum\Slurp\Tests\Slurp\Transform;
+
+use MilesAsylum\Slurp\Transform\DateTimeFormat;
+use MilesAsylum\Slurp\Transform\DateTimeFormatTransformer;
+use PHPUnit\Framework\TestCase;
+
+class DateTimeFormatTest extends TestCase
+{
+    public function testGetFormatFrom()
+    {
+        $this->assertSame(
+            'Y-m-d',
+            (new DateTimeFormat('Y-m-d', 'Y'))->getFormatFrom()
+        );
+    }
+
+    public function testGetFormatTo()
+    {
+        $this->assertSame(
+            'Y-m-d',
+            (new DateTimeFormat('Y', 'Y-m-d'))->getFormatTo()
+        );
+    }
+
+    public function testTransformedBy()
+    {
+        $this->assertSame(
+            DateTimeFormatTransformer::class,
+            (new DateTimeFormat('Y', 'Y'))->transformedBy()
+        );
+    }
+}