Merge pull request #795 from yubarajshrestha/feature/790

Adds oldest, latest methods to QueryBuilder, fixes #790

src/masoniteorm/models/Model.py

@@ -259,6 +259,8 @@ class Model(TimeStampsMixin, ObservesEvents, metaclass=ModelMeta):
             "where_doesnt_have",
             "with_",
             "with_count",
+            "latest",
+            "oldest"
         )
     )
 

src/masoniteorm/query/QueryBuilder.py

@@ -2266,3 +2266,27 @@ def get_schema(self):
         return Schema(
             connection=self.connection, connection_details=self._connection_details
         )
+
+    def latest(self, *fields):
+        """Gets the latest record.
+
+        Returns:
+            querybuilder
+        """
+
+        if not fields:
+            fields = ("created_at",)
+
+        return self.order_by(column=",".join(fields), direction="DESC")
+
+    def oldest(self, *fields):
+        """Gets the oldest record.
+
+        Returns:
+            querybuilder
+        """
+
+        if not fields:
+            fields = ("created_at",)
+
+        return self.order_by(column=",".join(fields), direction="ASC")

tests/mssql/builder/test_mssql_query_builder.py

@@ -411,3 +411,27 @@ def test_truncate_without_foreign_keys(self):
         builder = self.get_builder(dry=True)
         sql = builder.truncate(foreign_keys=True)
         self.assertEqual(sql, "TRUNCATE TABLE [users]")
+
+    def test_latest(self):
+        builder = self.get_builder()
+        builder.latest("email")
+        self.assertEqual(
+            builder.to_sql(), "SELECT * FROM [users] ORDER BY [email] DESC"
+        )
+
+    def test_latest_multiple(self):
+        builder = self.get_builder()
+        builder.latest("email", "created_at")
+        self.assertEqual(
+            builder.to_sql(), "SELECT * FROM [users] ORDER BY [email] DESC, [created_at] DESC"
+        )
+
+    def test_oldest(self):
+        builder = self.get_builder()
+        builder.oldest("email")
+        self.assertEqual(builder.to_sql(), "SELECT * FROM [users] ORDER BY [email] ASC")
+
+    def test_oldest_multiple(self):
+        builder = self.get_builder()
+        builder.oldest("email", "created_at")
+        self.assertEqual(builder.to_sql(), "SELECT * FROM [users] ORDER BY [email] ASC, [created_at] ASC")

tests/mysql/builder/test_query_builder.py

@@ -917,3 +917,31 @@ def update_lock(self):
         builder.truncate()
         """
         return "SELECT * FROM `users` WHERE `users`.`votes` >= '100' FOR UPDATE"
+
+    def test_latest(self):
+        builder = self.get_builder()
+        builder.latest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def test_oldest(self):
+        builder = self.get_builder()
+        builder.oldest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def latest(self):
+        """
+        builder.order_by('email', 'des')
+        """
+        return "SELECT * FROM `users` ORDER BY `email` DESC"
+
+    def oldest(self):
+        """
+        builder.order_by('email', 'asc')
+        """
+        return "SELECT * FROM `users` ORDER BY `email` ASC"

tests/postgres/builder/test_postgres_query_builder.py

@@ -772,3 +772,31 @@ def shared_lock(self):
         builder.truncate()
         """
         return """SELECT * FROM "users" WHERE "users"."votes" >= '100' FOR SHARE"""
+
+    def test_latest(self):
+        builder = self.get_builder()
+        builder.latest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def test_oldest(self):
+        builder = self.get_builder()
+        builder.oldest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def oldest(self):
+        """
+        builder.order_by('email', 'asc')
+        """
+        return """SELECT * FROM "users" ORDER BY "email" ASC"""
+
+    def latest(self):
+        """
+        builder.order_by('email', 'des')
+        """
+        return """SELECT * FROM "users" ORDER BY "email" DESC"""

tests/sqlite/builder/test_sqlite_query_builder.py

@@ -971,3 +971,31 @@ def truncate_without_foreign_keys(self):
             'DELETE FROM "users"',
             "PRAGMA foreign_keys = ON",
         ]
+
+    def test_latest(self):
+        builder = self.get_builder()
+        builder.latest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def test_oldest(self):
+        builder = self.get_builder()
+        builder.oldest('email')
+        sql = getattr(
+            self, inspect.currentframe().f_code.co_name.replace("test_", "")
+        )()
+        self.assertEqual(builder.to_sql(), sql)
+
+    def oldest(self):
+        """
+        builder.order_by('email', 'asc')
+        """
+        return """SELECT * FROM "users" ORDER BY "email" ASC"""
+
+    def latest(self):
+        """
+        builder.order_by('email', 'des')
+        """
+        return """SELECT * FROM "users" ORDER BY "email" DESC"""