Add documents API sort

Author: Nymuxyzo

lib/meilisearch/index.rb

@@ -73,14 +73,15 @@ def document(document_id, fields: nil)
     #           :fields - Array of document attributes to show (optional).
     #           :filter - Filter queries by an attribute's value.
     #                     Available ONLY with Meilisearch v1.2 and newer (optional).
+    #           :sort   - A list of attributes written as an array or as a comma-separated string (optional)
     #
     # Returns the documents results object.
     def documents(options = {})
       Utils.version_error_handler(__method__) do
         if options.key?(:filter)
-          http_post "/indexes/#{@uid}/documents/fetch", Utils.filter(options, [:limit, :offset, :fields, :filter])
+          http_post "/indexes/#{@uid}/documents/fetch", Utils.filter(options, [:limit, :offset, :fields, :filter, :sort])
         else
-          http_get "/indexes/#{@uid}/documents", Utils.parse_query(options, [:limit, :offset, :fields])
+          http_get "/indexes/#{@uid}/documents", Utils.parse_query(options, [:limit, :offset, :fields, :sort])
         end
       end
     end

spec/meilisearch/index/documents_spec.rb

@@ -10,6 +10,7 @@
         { objectId: 456,  title: 'Le Petit Prince',                        comment: 'A french book' },
         { objectId: 1,    title: 'Alice In Wonderland',                    comment: 'A weird book' },
         { objectId: 1344, title: 'The Hobbit',                             comment: 'An awesome book' },
+        { objectId: 13,   title: 'Zen in the Art of Archery' },
         { objectId: 4,    title: 'Harry Potter and the Half-Blood Prince', comment: 'The best book' },
         { objectId: 42,   title: 'The Hitchhiker\'s Guide to the Galaxy' },
         { objectId: 2,    title: 'Le Rouge et le Noir' }
@@ -383,7 +384,7 @@
     describe '#documents' do
       before do
         index.add_documents(documents).await
-        index.update_filterable_attributes(['title', 'objectId']).await
+        index.update_filterable_attributes(['title', 'objectId', 'comment']).await
       end
 
       it 'browses documents' do
@@ -422,6 +423,28 @@
           { 'title' => a_kind_of(String) }
         )
       end
+
+      describe 'sorts documents' do
+        before do
+          index.update_sortable_attributes(['title']).await
+        end
+
+        it 'get' do
+          docs = index.documents(sort: ['title:asc'])
+          expect(docs['results'].first).to include('objectId' => 1, 'title' => 'Alice In Wonderland')
+          expect(docs['results'].last).to include('objectId' => 13, 'title' => 'Zen in the Art of Archery')
+
+          docs = index.documents(sort: ['title:desc'])
+          expect(docs['results'].first).to include('objectId' => 13, 'title' => 'Zen in the Art of Archery')
+          expect(docs['results'].last).to include('objectId' => 1, 'title' => 'Alice In Wonderland')
+        end
+
+        it 'post' do
+          docs = index.documents(filter: 'comment NOT EXISTS', sort: ['title:asc'])
+          expect(docs['results'].first).to include('objectId' => 2, 'title' => 'Le Rouge et le Noir')
+          expect(docs['results'].last).to include('objectId' => 13, 'title' => 'Zen in the Art of Archery')
+        end
+      end
     end
 
     describe '#update_documents' do