Adding orderByDesc function to Builder (#893)

* Adding orderByDesc function to Builder

* Removing 'direction' parameter in orderByDesc docblock

* Update Builder.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: jdavidbakr

src/Builder.php

@@ -224,6 +224,17 @@ public function orderBy($column, $direction = 'asc')
         return $this;
     }
 
+    /**
+     * Add a descending "order by" clause to the search query.
+     *
+     * @param  string  $column
+     * @return $this
+     */
+    public function orderByDesc($column)
+    {
+        return $this->orderBy($column, 'desc');
+    }
+
     /**
      * Add an "order by" clause for a timestamp to the query.
      *

tests/Feature/CollectionEngineTest.php

@@ -107,6 +107,14 @@ public function test_it_can_paginate_results()
         $models = SearchableUser::search('laravel')->query($dummyQuery)->orderBy('name')->paginate(1, 'page', 2);
         $this->assertCount(1, $models);
         $this->assertEquals('Taylor Otwell', $models[0]->name);
+
+        $models = SearchableUser::search('laravel')->query($dummyQuery)->orderByDesc('name')->paginate(1, 'page', 1);
+        $this->assertCount(1, $models);
+        $this->assertEquals('Taylor Otwell', $models[0]->name);
+
+        $models = SearchableUser::search('laravel')->query($dummyQuery)->orderByDesc('name')->paginate(1, 'page', 2);
+        $this->assertCount(1, $models);
+        $this->assertEquals('Abigail Otwell', $models[0]->name);
     }
 
     public function test_limit_is_applied()
@@ -127,6 +135,10 @@ public function test_it_can_order_results()
         $models = SearchableUser::search('laravel')->orderBy('name', 'desc')->paginate(1, 'page', 1);
         $this->assertCount(1, $models);
         $this->assertEquals('Taylor Otwell', $models[0]->name);
+
+        $models = SearchableUser::search('laravel')->orderByDesc('name')->paginate(1, 'page', 1);
+        $this->assertCount(1, $models);
+        $this->assertEquals('Taylor Otwell', $models[0]->name);
     }
 
     public function test_it_can_order_by_latest_and_oldest()

tests/Feature/DatabaseEngineTest.php

@@ -166,12 +166,24 @@ public function test_it_can_order_results()
         $this->assertCount(1, $models);
         $this->assertEquals('Taylor Otwell', $models[0]->name);
 
+        $models = SearchableUser::search('laravel')->orderByDesc('name')->take(1)->get();
+        $this->assertCount(1, $models);
+        $this->assertEquals('Taylor Otwell', $models[0]->name);
+
         $modelsPaginate = SearchableUser::search('laravel')->orderBy('name', 'desc')->paginate(1, 'page', 1);
         $this->assertCount(1, $modelsPaginate);
         $this->assertEquals('Taylor Otwell', $modelsPaginate[0]->name);
 
+        $modelsPaginate = SearchableUser::search('laravel')->orderByDesc('name')->paginate(1, 'page', 1);
+        $this->assertCount(1, $modelsPaginate);
+        $this->assertEquals('Taylor Otwell', $modelsPaginate[0]->name);
+
         $modelsSimplePaginate = SearchableUser::search('laravel')->orderBy('name', 'desc')->simplePaginate(1, 'page', 1);
         $this->assertCount(1, $modelsSimplePaginate);
         $this->assertEquals('Taylor Otwell', $modelsSimplePaginate[0]->name);
+
+        $modelsSimplePaginate = SearchableUser::search('laravel')->orderByDesc('name')->simplePaginate(1, 'page', 1);
+        $this->assertCount(1, $modelsSimplePaginate);
+        $this->assertEquals('Taylor Otwell', $modelsSimplePaginate[0]->name);
     }
 }