Add Model::findBy method

Author: natanfelles

src/Model.php

@@ -9,6 +9,7 @@
  */
 namespace Framework\MVC;
 
+use Closure;
 use DateTime;
 use DateTimeZone;
 use Exception;
@@ -482,6 +483,28 @@ public function getPager() : Pager
         return $this->pager;
     }
 
+    /**
+     * Find a row by column name and value.
+     *
+     * @param string $column
+     * @param Closure|float|int|string|null $value
+     *
+     * @return array<string,float|int|string|null>|Entity|stdClass|null
+     */
+    public function findBy(
+        string $column,
+        Closure | float | int | string | null $value
+    ) : array | Entity | stdClass | null {
+        $data = $this->getDatabaseToRead()
+            ->select()
+            ->from($this->getTable())
+            ->whereEqual($column, $value)
+            ->limit(1)
+            ->run()
+            ->fetchArray();
+        return $data ? $this->makeEntity($data) : null;
+    }
+
     /**
      * Find a row based on Primary Key.
      *

tests/ModelTest.php

@@ -27,6 +27,13 @@ protected function setUp() : void
         $this->model = new ModelMock();
     }
 
+    public function testFindBy() : void
+    {
+        self::assertIsObject($this->model->findBy('id', 1));
+        self::assertNull($this->model->findBy('id', 1000));
+        self::assertIsObject($this->model->findBy('data', 'foo'));
+    }
+
     public function testFind() : void
     {
         self::assertIsObject($this->model->find(1));