new function Table::get()

CHANGELOG.md

@@ -8,6 +8,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ## [7.4.0] - Unreleased
 ### Added
 - `SelectAggregate` query allows to set not only fields but anything (math operations, for instance) and save the result as a column
+- `Select` query has the `whereSprintf` and `orWhereSprintf` modifiers.
+- New method `Table::get` To return a row from a table
+
+### Deprecated
+- Magic method to return rows from a table using a field. Use `$table->get(['slug' => 'value'])` instead `$table->slug('value')`.
 
 ## [7.3.6] - 2019-12-25
 ### Added

README.md

@@ -134,12 +134,12 @@ $db->post[] = [
 $totalPost = count($db->post);
 ```
 
-### Select by other unique keys
+### Select by other fields
 
-If you want to select a row by other key than `id`, just use a method with the field name:
+If you want to select a row by other key than `id`, just use the method `get`:
 
 ```php
-$post = $db->post->slug('post-slug');
+$post = $db->post->get(['slug' => 'post-slug']);
 ```
 
 ### Select or create
@@ -288,8 +288,10 @@ Function | Description
 `orderBy` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `catHaving` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `where` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
-`orWhere` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
+`whereSprintf` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `catWhere` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
+`orWhere` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
+`orWhereSprintf` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `whereEquals` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `limit` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)
 `offset` | [Atlas.Query Select()](http://atlasphp.io/cassini/query/select.html)

src/Table.php

@@ -400,17 +400,18 @@ public function getFields()
         return $this->fields;
     }
 
+    /**
+     * @deprecated
+     */
     public function __call(string $name, array $args): ?Row
     {
-        $field = $this->__get($name);
-
-        return $this->select()->one()->where("{$field} = ", $args[0])->run();
+        return $this->get([$name => $args[0]]);
     }
 
     /**
-     * Search a row with some values or create one if it does not exist
+     * Search a row with some values
      */
-    public function getOrCreate(array $data): Row
+    public function get(array $data): ?Row
     {
         $query = $this->select()->one();
 
@@ -420,13 +421,15 @@ public function getOrCreate(array $data): Row
             $query->where("{$field} = ", $value);
         }
 
-        $row = $query->run();
-
-        if ($row) {
-            return $row;
-        }
+        return $query->run();
+    }
 
-        return $this->create($data);
+    /**
+     * Search a row with some values or create one if it does not exist
+     */
+    public function getOrCreate(array $data): Row
+    {
+        return $this->get($data) ?: $this->create($data);
     }
 
     public function create(array $data = []): Row