Merge branch 'develop'

Author: Petr Knap

src/Enum/AbstractEnum.php

@@ -8,7 +8,6 @@
  * @author  Petr Knap <dev@petrknap.cz>
  * @since   2016-01-23
  * @package PetrKnap\Php\Enum
- * @version 1.0.1
  * @license https://github.com/petrknap/php-enum/blob/master/LICENSE MIT
  */
 abstract class AbstractEnum
@@ -56,7 +55,7 @@ protected function __construct($memberName)
      *
      * @param string $memberName enum key
      * @param array $args ignored
-     * @return mixed
+     * @return self
      */
     public static function __callStatic($memberName, array $args)
     {
@@ -155,4 +154,25 @@ private function get($memberName)
 
         return self::$members[get_called_class()][$memberName];
     }
+
+    /**
+     * @param mixed $value
+     * @return self
+     * @throws EnumException
+     */
+    public static function findByValue($value)
+    {
+        foreach (self::getMembers() as $n => $v) {
+            if ($value === $v) {
+                return self::__callStatic($n, []);
+            }
+        }
+        throw new EnumException(
+            sprintf(
+                "Value not found in %s",
+                get_called_class()
+            ),
+            EnumException::OUT_OF_RANGE
+        );
+    }
 }

tests/Enum/EnumTest.php

@@ -78,4 +78,26 @@ public function testGetMembers()
         $this->assertArrayHasKey("MY_FALSE", $members);
         $this->assertEquals(2, $members["MY_FALSE"]);
     }
+
+    /**
+     * @dataProvider dataFindByValue
+     * @param mixed $value
+     * @param mixed $expected
+     */
+    public function testFindByValue($value, $expected)
+    {
+        if ($expected instanceof \Exception) {
+            $this->setExpectedException(get_class($expected));
+        }
+        $this->assertSame($expected, MyBoolean::findByValue($value));
+    }
+
+    public function dataFindByValue()
+    {
+        return [
+            [1, MyBoolean::MY_TRUE()],
+            [2, MyBoolean::MY_FALSE()],
+            [3, new EnumException()]
+        ];
+    }
 }