meilisearch 0.16.0 → 0.17.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c67baca928880c0efd95580e84a4b3f11f8fbab279a8eec5e6a7ffd64467ce85
-  data.tar.gz: ee39b314f6607c5ccd219d16bb6e0cb88d971b7113fa1c9091b11634b34e5062
+  metadata.gz: 276a1136bc7d85d5c0eaafa7475732990502af66a37859589dea606cffde3c97
+  data.tar.gz: e45996c09a5140cf5c66c9f1e30163ca91f37e3e469c00d396c88c318b9541ca
 SHA512:
-  metadata.gz: aa7d0a46d608c88ac58786f70d95001c845123c5df29fe3644ddfe8669f87744102076a6610b993b05dd733512922def3ece255fcd562dac103696f07c779a66
-  data.tar.gz: e6b254f4fc93e8e9f4a0f6aa8df701fbd30cc6565021c0c61f81e709fc96b3423ca0eb4cc6097eb2abba91c76ea6298128e4765c9f2f1f3ce58ba807a8d93bb7
+  metadata.gz: '09377cb9cd2eba0800459c57c229db29b9d497716248141125067b97026dabce8f1a6725b0a66336b98700e6cead512c0879e3d5162f402d04fd65277e373711'
+  data.tar.gz: 62f69c26b9516074cff7e97a4dde7a45261f511d762aef0ecbd933a5810b4ed3ec4136bb6ef3a9f0b04f9d6dd22699453a823014dd203a172d83d5bbc52f7993

data/lib/meilisearch/client.rb

@@ -6,15 +6,22 @@ module MeiliSearch
   class Client < HTTPRequest
     ### INDEXES
 
+    def raw_indexes
+      http_get('/indexes')
+    end
+
     def indexes
-      http_get '/indexes'
+      raw_indexes.map do |index_hash|
+        index_object(index_hash['uid'], index_hash['primaryKey'])
+      end
     end
 
     # Usage:
     # client.create_index('indexUID')
     # client.create_index('indexUID', primaryKey: 'id')
     def create_index(index_uid, options = {})
-      body = options.merge(uid: index_uid)
+      body = Utils.transform_attributes(options.merge(uid: index_uid))
+
       index_hash = http_post '/indexes', body
       index_object(index_hash['uid'], index_hash['primaryKey'])
     end
@@ -34,6 +41,17 @@ module MeiliSearch
       index_object(index_uid).delete
     end
 
+    # Usage:
+    # client.delete_index_if_exists('indexUID')
+    def delete_index_if_exists(index_uid)
+      index_object(index_uid).delete
+      true
+    rescue ApiError => e
+      raise e if e.code != 'index_not_found'
+
+      false
+    end
+
     # Usage:
     # client.index('indexUID')
     def index(index_uid)
@@ -44,6 +62,10 @@ module MeiliSearch
       index_object(index_uid).fetch_info
     end
 
+    def fetch_raw_index(index_uid)
+      index_object(index_uid).fetch_raw_info
+    end
+
     ### KEYS
 
     def keys

data/lib/meilisearch/error.rb

@@ -29,10 +29,15 @@ module MeiliSearch
 
     def get_meilisearch_error_info(http_body)
       @http_body = JSON.parse(http_body)
-      @ms_code = @http_body['errorCode']
+      @ms_code = @http_body['code']
       @ms_message = @http_body['message']
-      @ms_type = @http_body['errorType']
-      @ms_link = @http_body['errorLink']
+      @ms_type = @http_body['type']
+      @ms_link = @http_body['link']
+    rescue JSON::ParserError
+      # We might receive a JSON::ParserError when, for example, MeiliSearch is running behind
+      # some proxy (ELB or Nginx, for example), and the request timeouts, returning us
+      # a raw HTML body instead of a JSON as we were expecting
+      @ms_message = "The server has not returned a valid JSON HTTP body: #{http_body}"
     end
 
     def details

data/lib/meilisearch/http_request.rb

@@ -17,13 +17,17 @@ module MeiliSearch
         'Content-Type' => 'application/json',
         'X-Meili-API-Key' => api_key
       }.compact
+      @headers_no_body = {
+        'X-Meili-API-Key' => api_key
+      }.compact
     end
 
     def http_get(relative_path = '', query_params = {})
       send_request(
         proc { |path, config| self.class.get(path, config) },
         relative_path,
-        query_params
+        query_params: query_params,
+        headers: @headers_no_body
       )
     end
 
@@ -31,8 +35,9 @@ module MeiliSearch
       send_request(
         proc { |path, config| self.class.post(path, config) },
         relative_path,
-        query_params,
-        body
+        query_params: query_params,
+        body: body,
+        headers: @headers
       )
     end
 
@@ -40,22 +45,24 @@ module MeiliSearch
       send_request(
         proc { |path, config| self.class.put(path, config) },
         relative_path,
-        query_params,
-        body
+        query_params: query_params,
+        body: body,
+        headers: @headers
       )
     end
 
     def http_delete(relative_path = '')
       send_request(
         proc { |path, config| self.class.delete(path, config) },
-        relative_path
+        relative_path,
+        headers: @headers_no_body
       )
     end
 
     private
 
-    def send_request(http_method, relative_path, query_params = nil, body = nil)
-      config = http_config(query_params, body)
+    def send_request(http_method, relative_path, query_params: nil, body: nil, headers: nil)
+      config = http_config(query_params, body, headers)
       begin
         response = http_method.call(@base_url + relative_path, config)
       rescue Errno::ECONNREFUSED => e
@@ -64,12 +71,11 @@ module MeiliSearch
       validate(response)
     end
 
-    def http_config(query_params, body)
-      body = body.to_json
+    def http_config(query_params, body, headers)
       {
-        headers: @headers,
+        headers: headers,
         query: query_params,
-        body: body,
+        body: body.to_json,
         timeout: @options[:timeout] || 1,
         max_retries: @options[:max_retries] || 0
       }.compact

data/lib/meilisearch/index.rb

@@ -5,7 +5,7 @@ require 'timeout'
 
 module MeiliSearch
   class Index < HTTPRequest
-    attr_reader :uid, :primary_key
+    attr_reader :uid, :primary_key, :created_at, :updated_at
 
     def initialize(index_uid, url, api_key = nil, primary_key = nil, options = {})
       @uid = index_uid
@@ -14,27 +14,47 @@ module MeiliSearch
     end
 
     def fetch_info
-      index_hash = http_get "/indexes/#{@uid}"
-      @primary_key = index_hash['primaryKey']
+      index_hash = http_get indexes_path(id: @uid)
+      set_base_properties index_hash
       self
     end
 
+    def fetch_primary_key
+      fetch_info.primary_key
+    end
+    alias get_primary_key fetch_primary_key
+
+    def fetch_raw_info
+      index_hash = http_get indexes_path(id: @uid)
+      set_base_properties index_hash
+      index_hash
+    end
+
     def update(body)
-      index_hash = http_put "/indexes/#{@uid}", body
-      @primary_key = index_hash['primaryKey']
+      index_hash = http_put indexes_path(id: @uid), Utils.transform_attributes(body)
+      set_base_properties index_hash
+
       self
     end
+
     alias update_index update
 
     def delete
-      http_delete "/indexes/#{@uid}"
+      http_delete indexes_path(id: @uid)
     end
     alias delete_index delete
 
-    def fetch_primary_key
-      fetch_info.primary_key
+    def indexes_path(id: nil)
+      "/indexes/#{id}"
     end
-    alias get_primary_key fetch_primary_key
+    private :indexes_path
+
+    def set_base_properties(index_hash)
+      @primary_key = index_hash['primaryKey']
+      @created_at = Time.parse(index_hash['createdAt'])
+      @updated_at = Time.parse(index_hash['updatedAt'])
+    end
+    private :set_base_properties
 
     ### DOCUMENTS
 
@@ -46,7 +66,7 @@ module MeiliSearch
     alias get_one_document document
 
     def documents(options = {})
-      http_get "/indexes/#{@uid}/documents", options
+      http_get "/indexes/#{@uid}/documents", Utils.transform_attributes(options)
     end
     alias get_documents documents
 
@@ -76,6 +96,40 @@ module MeiliSearch
     end
     alias add_or_update_documents! update_documents!
 
+    def add_documents_in_batches(documents, batch_size = 1000, primary_key = nil)
+      update_ids = []
+      documents.each_slice(batch_size) do |batch|
+        update_ids.append(add_documents(batch, primary_key))
+      end
+      update_ids
+    end
+
+    def add_documents_in_batches!(documents, batch_size = 1000, primary_key = nil)
+      update_ids = add_documents_in_batches(documents, batch_size, primary_key)
+      responses = []
+      update_ids.each do |update_object|
+        responses.append(wait_for_pending_update(update_object['updateId']))
+      end
+      responses
+    end
+
+    def update_documents_in_batches(documents, batch_size = 1000, primary_key = nil)
+      update_ids = []
+      documents.each_slice(batch_size) do |batch|
+        update_ids.append(update_documents(batch, primary_key))
+      end
+      update_ids
+    end
+
+    def update_documents_in_batches!(documents, batch_size = 1000, primary_key = nil)
+      update_ids = update_documents_in_batches(documents, batch_size, primary_key)
+      responses = []
+      update_ids.each do |update_object|
+        responses.append(wait_for_pending_update(update_object['updateId']))
+      end
+      responses
+    end
+
     def delete_documents(documents_ids)
       if documents_ids.is_a?(Array)
         http_post "/indexes/#{@uid}/documents/delete-batch", documents_ids
@@ -115,8 +169,9 @@ module MeiliSearch
     ### SEARCH
 
     def search(query, options = {})
-      parsed_options = options.compact
-      http_post "/indexes/#{@uid}/search", { q: query.to_s }.merge(parsed_options)
+      parsed_options = Utils.transform_attributes({ q: query.to_s }.merge(options.compact))
+
+      http_post "/indexes/#{@uid}/search", parsed_options
     end
 
     ### UPDATES
@@ -176,7 +231,7 @@ module MeiliSearch
     alias get_settings settings
 
     def update_settings(settings)
-      http_post "/indexes/#{@uid}/settings", settings
+      http_post "/indexes/#{@uid}/settings", Utils.transform_attributes(settings)
     end
     alias settings= update_settings
 
@@ -296,5 +351,21 @@ module MeiliSearch
     def reset_filterable_attributes
       http_delete "/indexes/#{@uid}/settings/filterable-attributes"
     end
+
+    ### SETTINGS - SORTABLE ATTRIBUTES
+
+    def sortable_attributes
+      http_get "/indexes/#{@uid}/settings/sortable-attributes"
+    end
+    alias get_sortable_attributes sortable_attributes
+
+    def update_sortable_attributes(sortable_attributes)
+      http_post "/indexes/#{@uid}/settings/sortable-attributes", sortable_attributes
+    end
+    alias sortable_attributes= update_sortable_attributes
+
+    def reset_sortable_attributes
+      http_delete "/indexes/#{@uid}/settings/sortable-attributes"
+    end
   end
 end

data/lib/meilisearch/utils.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module MeiliSearch
+  module Utils
+    SNAKE_CASE = /[^a-zA-Z0-9]+(.)/.freeze
+
+    def self.transform_attributes(body)
+      case body
+      when Array
+        body.map { |item| transform_attributes(item) }
+      when Hash
+        parse(body)
+      else
+        body
+      end
+    end
+
+    def self.parse(body)
+      body
+        .transform_keys(&:to_s)
+        .transform_keys do |key|
+          key.include?('_') ? key.downcase.gsub(SNAKE_CASE, &:upcase).gsub('_', '') : key
+        end
+    end
+
+    private_class_method :parse
+  end
+end

data/lib/meilisearch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MeiliSearch
-  VERSION = '0.16.0'
+  VERSION = '0.17.2'
 end

data/lib/meilisearch.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'meilisearch/version'
+require 'meilisearch/utils'
 require 'meilisearch/client'
 require 'meilisearch/index'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: meilisearch
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.2
 platform: ruby
 authors:
 - Meili
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-24 00:00:00.000000000 Z
+date: 2021-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -19,7 +19,7 @@ dependencies:
         version: 0.17.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.21.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: 0.17.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.21.0
 description: An easy-to-use ruby client for Meilisearch API. See https://github.com/meilisearch/MeiliSearch
 email: bonjour@meilisearch.com
 executables: []
@@ -41,6 +41,7 @@ files:
 - lib/meilisearch/error.rb
 - lib/meilisearch/http_request.rb
 - lib/meilisearch/index.rb
+- lib/meilisearch/utils.rb
 - lib/meilisearch/version.rb
 homepage: https://github.com/meilisearch/meilisearch-ruby
 licenses: