feat: add costume sort order, limit and offset

- 71 tests, 98 assertions)

Author: SonyPradana

src/System/Database/MyModel/Model.php

@@ -48,6 +48,13 @@ class Model implements \ArrayAccess, \IteratorAggregate
      * @var Bind[] Binder for PDO bind */
     protected $binds = [];
 
+    // costume select -------------
+
+    protected int $limit_start    = 0;
+    protected int $limit_end      = 0;
+    protected int $offset         = 0;
+    protected string $sort_order  = '';
+
     // magic ----------------------
 
     /**
@@ -249,6 +256,8 @@ public function read(): bool
     {
         $query = new Select($this->table_name, ['*'], $this->pdo);
 
+        $query->sortOrderRef($this->limit_start, $this->limit_end, $this->offset, $this->sort_order);
+
         $all = $this->fetch($query);
 
         if ([] === $all) {
@@ -389,6 +398,95 @@ public function toArray(): array
         return $this->getColumns();
     }
 
+    // costume select ------------
+
+    /**
+     * Set data start for feact all data.
+     *
+     * @param int $limit_start limit start
+     * @param int $limit_end   limit end
+     *
+     * @return static
+     */
+    public function limit(int $limit_start, int $limit_end)
+    {
+        $this->limitStart($limit_start);
+        $this->limitEnd($limit_end);
+
+        return $this;
+    }
+
+    /**
+     * Set data start for feact all data.
+     *
+     * @param int $value limit start default is 0
+     *
+     * @return static
+     */
+    public function limitStart(int $value)
+    {
+        $this->limit_start = $value < 0 ? 0 : $value;
+
+        return $this;
+    }
+
+    /**
+     * Set data end for feact all data
+     * zero value meaning no data show.
+     *
+     * @param int $value limit start default
+     *
+     * @return static
+     */
+    public function limitEnd(int $value)
+    {
+        $this->limit_end = $value < 0 ? 0 : $value;
+
+        return $this;
+    }
+
+    /**
+     * Set offest.
+     *
+     * @param int $value offet
+     *
+     * @return static
+     */
+    public function offset(int $value)
+    {
+        $this->offset = $value < 0 ? 0 : $value;
+
+        return $this;
+    }
+
+    /**
+     * Set limit using limit and offset.
+     *
+     * @return static
+     */
+    public function limitOffset(int $limit, int $offset)
+    {
+        return $this
+            ->limitStart($limit)
+            ->limitEnd(0)
+            ->offset($offset);
+    }
+
+    /**
+     * Set sort column and order
+     * column name must register.
+     *
+     * @return static
+     */
+    public function order(string $column_name, int $order_using = MyQuery::ORDER_ASC, ?string $belong_to = null)
+    {
+        $order            = $order_using == 0 ? 'ASC' : 'DESC';
+        $belong_to        = $belong_to ?? $this->table_name;
+        $this->sort_order = "ORDER BY `$belong_to`.`$column_name` $order";
+
+        return $this;
+    }
+
     // array access --------------
 
     /**

src/System/Database/MyQuery/Select.php

@@ -201,4 +201,12 @@ private function getLimit(): string
 
         return "LIMIT $this->_limit_start, $this->_limit_end";
     }
+
+    public function sortOrderRef(int $limit_start, int $limit_end, int $offset, string $sort_ordder): void
+    {
+        $this->_limit_start = $limit_start;
+        $this->_limit_end   = $limit_end;
+        $this->_offset      = $offset;
+        $this->_sort_order  = $sort_ordder;
+    }
 }

tests/DataBase/Model/BaseModelTest.php

@@ -105,7 +105,7 @@ public function itCanCreateData()
      */
     public function itCanReadData()
     {
-        $user = new User($this->pdo, [[]], ['user' => ['taylor']]);
+        $user = new User($this->pdo, []);
 
         $this->assertTrue($user->read());
     }

tests/DataBase/Model/CostumeModelTest.php

@@ -5,6 +5,7 @@
 namespace System\Test\Database\Model;
 
 use System\Database\MyModel\Model;
+use System\Database\MyQuery;
 use System\Database\MyQuery\Insert;
 use System\Test\Database\BaseConnection;
 
@@ -112,6 +113,53 @@ public function itCanFilterModelChain(): void
             $this->assertGreaterThan(30, $profile->getter('gender'));
         }
     }
+
+    /**
+     * @test
+     *
+     * @group database
+     */
+    public function itCanlimitOrder(): void
+    {
+        $profiles = $this->profiles();
+        $profiles->limitEnd(2);
+        $profiles->read();
+
+        $this->assertEquals(2, $profiles->get()->count());
+    }
+
+    /**
+     * @test
+     *
+     * @group database
+     */
+    public function itCanlimitOffset(): void
+    {
+        $profiles = $this->profiles();
+        $profiles->limitOffset(1, 2);
+        $profiles->read();
+
+        $this->assertEquals(1, $profiles->get()->count());
+    }
+
+    /**
+     * @test
+     *
+     * @group database
+     */
+    public function itCanShortOrder(): void
+    {
+        $profiles = $this->profiles();
+
+        $profiles->order('user', MyQuery::ORDER_ASC);
+        $profiles->read();
+        $this->assertEquals([
+            'user'   => 'jesica',
+            'name'   => 'jesica w',
+            'gender' => 'female',
+            'age'    => 38,
+        ], $profiles->first());
+    }
 }
 
 class Profile extends Model