Add findModel() to QB to create a single Model

This method will find and pick the first result matching the query. Only
a single Model will be returned; an invalid Model if the query returns
nothing.

models/Permission.php

@@ -122,7 +122,7 @@ public static function getPermissionFromName($perm_name)
         }
 
         return self::getQueryBuilder()
-            ->find($perm_name, 'name')
+            ->findModel($perm_name, 'name')
         ;
     }
 

src/Model/Model.php

@@ -218,6 +218,21 @@ public static function escape($string)
         return htmlspecialchars($string, ENT_QUOTES, 'UTF-8');
     }
 
+    /**
+     * Create a single model object from a database result
+     *
+     * @param array $result The MySQL row of the model
+     *
+     * @return static
+     */
+    public static function createFromDatabaseResult(&$result)
+    {
+        $model = new static($result['id'], $result);
+        $model->storeInCache();
+
+        return $model;
+    }
+
     /**
      * Create model objects, given their MySQL entries
      *
@@ -229,10 +244,7 @@ public static function createFromDatabaseResults(&$results)
         $models = array();
 
         foreach ($results as $result) {
-            $model = new static($result['id'], $result);
-            $model->storeInCache();
-
-            $models[] = $model;
+            $models[] = self::createFromDatabaseResult($result);
         }
 
         return $models;

src/QueryBuilder/QueryBuilderFlex.php

@@ -184,6 +184,28 @@ public function except($model)
         return $this;
     }
 
+    /**
+     * Find the first matching model in the database or return an invalid model.
+     *
+     * @param mixed  $value      The value to search for
+     * @param string $columnName The column name we'll be checking
+     *
+     * @return Model
+     */
+    public function findModel($value, $columnName = 'id')
+    {
+        $type = $this->modelType;
+
+        /** @var array $result */
+        $result = parent::find($value, $columnName);
+
+        if ($result === null) {
+            return $type::get(0);
+        }
+
+        return $type::createFromDatabaseResult($result);
+    }
+
     /**
      * Only show results from a specific page.
      *