Merge pull request #82 from chadicus/master

Add alias for Strings::translate

Author: chadicus

README.md

@@ -247,6 +247,13 @@ $value = \TraderInteractive\Filter\Strings::stripTags('A string with <p>tags</p>
 assert($value === 'a string with tags');
 ```
 
+#### Strings::translate
+Aliased in the filterer as `translate`, this filter will accept a string value and return its translated value found in the given $valueMap.
+```php
+$value = \TraderInteractive\Filter\Strings::tranlsate('bar', ['foo' => 'translated to bar', 'bar' => 'translated to foo']);
+assert($value === 'translated to foo');
+```
+
 #### Url::filter
 Aliased in the filterer as `url`, this filter verifies that the argument is a URL string according to
 [RFC2396](http://www.faqs.org/rfcs/rfc2396). The second parameter can be set to `true` to allow

composer.json

@@ -35,7 +35,7 @@
         "traderinteractive/filter-dates": "^3.0",
         "traderinteractive/filter-floats": "^3.0",
         "traderinteractive/filter-ints": "^3.0",
-        "traderinteractive/filter-strings": "^3.2.0"
+        "traderinteractive/filter-strings": "^3.3"
     },
     "require-dev": {
         "php-coveralls/php-coveralls": "^1.0",

src/Filterer.php

@@ -34,6 +34,7 @@ final class Filterer
         'string' => '\\TraderInteractive\\Filter\\Strings::filter',
         'strip-tags' => '\\TraderInteractive\\Filter\\Strings::stripTags',
         'timezone' => '\\TraderInteractive\\Filter\\DateTimeZone::filter',
+        'translate' => '\\TraderInteractive\\Filter\\Strings::translate',
         'uint' => '\\TraderInteractive\\Filter\\UnsignedInt::filter',
         'url' => '\\TraderInteractive\\Filter\\Url::filter',
     ];

tests/FiltererTest.php

@@ -210,6 +210,12 @@ public function provideValidFilterData() : array
                 'options' => [],
                 'result' => [true, ['field' => '%value%'], null, []],
             ],
+            'translate alias' => [
+                'spec' => ['field' => [['translate', ['active' => 'A', 'inactive' => 'I']]]],
+                'input' => ['field' => 'inactive'],
+                'options' => [],
+                'result' => [true, ['field' => 'I'], null, []],
+            ],
         ];
     }