Merge #585

585: Rename top level module r=curquiza a=ellnix

# Pull Request

## Related issue
Fixes #523

Co-authored-by: ellnix <[email protected]>

Author: meili-bors[bot]

README.md

@@ -76,7 +76,7 @@ gem 'meilisearch'
 ```ruby
 require 'meilisearch'
 
-client = MeiliSearch::Client.new('http://127.0.0.1:7700', 'masterKey')
+client = Meilisearch::Client.new('http://127.0.0.1:7700', 'masterKey')
 
 # An index is where the documents are stored.
 index = client.index('movies')

lib/meilisearch.rb

@@ -12,5 +12,40 @@
 require 'meilisearch/client'
 require 'meilisearch/index'
 
+module Meilisearch
+end
+
+# Softly deprecate the old spelling of the top level module
+# from MeiliSearch to Meilisearch
 module MeiliSearch
+  class << self
+    def const_missing(const_name)
+      _warn_about_deprecation
+
+      Meilisearch.const_get(const_name)
+    end
+
+    def method_missing(method_name, *args, **kwargs)
+      _warn_about_deprecation
+
+      Meilisearch.send(method_name, *args, **kwargs)
+    end
+
+    def respond_to_missing?(method_name, *)
+      Meilisearch.respond_to?(method_name) || super
+    end
+
+    private
+
+    def _warn_about_deprecation
+      return if @warned
+
+      Meilisearch::Utils.logger.warn <<~RENAMED_MODULE_WARNING
+        [meilisearch-ruby] The top-level module of Meilisearch has been renamed.
+        [meilisearch-ruby] Please update "MeiliSearch" to "Meilisearch".
+      RENAMED_MODULE_WARNING
+
+      @warned = true
+    end
+  end
 end

lib/meilisearch/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module MeiliSearch
+module Meilisearch
   class Client < HTTPRequest
-    include MeiliSearch::TenantToken
-    include MeiliSearch::MultiSearch
+    include Meilisearch::TenantToken
+    include Meilisearch::MultiSearch
 
     ### INDEXES
 

lib/meilisearch/error.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
-module MeiliSearch
+module Meilisearch
   class Error < StandardError
   end
 
   class ApiError < Error
     # :http_code    # e.g. 400, 404...
     # :http_message # e.g. Bad Request, Not Found...
-    # :http_body    # The response body received from the MeiliSearch API
-    # :ms_code      # The error code given by the MeiliSearch API
-    # :ms_type      # The error type given by the MeiliSearch API
-    # :ms_link      # The documentation link given by the MeiliSearch API
-    # :ms_message   # The error message given by the MeiliSearch API
+    # :http_body    # The response body received from the Meilisearch API
+    # :ms_code      # The error code given by the Meilisearch API
+    # :ms_type      # The error type given by the Meilisearch API
+    # :ms_link      # The documentation link given by the Meilisearch API
+    # :ms_message   # The error message given by the Meilisearch API
     # :message      # The detailed error message of this error class
 
     attr_reader :http_code, :http_message, :http_body, :ms_code, :ms_type, :ms_link, :ms_message, :message
@@ -26,7 +26,7 @@ def initialize(http_code, http_message, http_body)
       @http_body = parse_body(http_body)
       @ms_code = @http_body['code']
       @ms_type = @http_body['type']
-      @ms_message = @http_body.fetch('message', 'MeiliSearch API has not returned any error message')
+      @ms_message = @http_body.fetch('message', 'Meilisearch API has not returned any error message')
       @ms_link = @http_body.fetch('link', '<no documentation link found>')
       @message = "#{http_code} #{http_message} - #{@ms_message}. See #{ms_link}."
       super(details)
@@ -41,22 +41,22 @@ def parse_body(http_body)
         {}
       end
     rescue JSON::ParserError
-      # We might receive a JSON::ParserError when, for example, MeiliSearch is running behind
+      # 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
       { 'message' => "The server has not returned a valid JSON HTTP body: #{http_body}" }
     end
 
     def details
-      "MeiliSearch::ApiError - code: #{@ms_code} - type: #{ms_type} - message: #{@ms_message} - link: #{ms_link}"
+      "Meilisearch::ApiError - code: #{@ms_code} - type: #{ms_type} - message: #{@ms_message} - link: #{ms_link}"
     end
   end
 
   class CommunicationError < Error
     attr_reader :message
 
     def initialize(message)
-      @message = "An error occurred while trying to connect to the MeiliSearch instance: #{message}"
+      @message = "An error occurred while trying to connect to the Meilisearch instance: #{message}"
       super(@message)
     end
   end
@@ -80,8 +80,8 @@ def initialize(message = nil)
   end
 
   module TenantToken
-    class ExpireOrInvalidSignature < MeiliSearch::Error; end
-    class InvalidApiKey < MeiliSearch::Error; end
-    class InvalidSearchRules < MeiliSearch::Error; end
+    class ExpireOrInvalidSignature < Meilisearch::Error; end
+    class InvalidApiKey < Meilisearch::Error; end
+    class InvalidSearchRules < Meilisearch::Error; end
   end
 end

lib/meilisearch/http_request.rb

@@ -3,7 +3,7 @@
 require 'httparty'
 require 'meilisearch/error'
 
-module MeiliSearch
+module Meilisearch
   class HTTPRequest
     include HTTParty
 
@@ -93,7 +93,7 @@ def build_default_options_headers
         'Authorization' => ("Bearer #{@api_key}" unless @api_key.nil?),
         'User-Agent' => [
           @options.fetch(:client_agents, []),
-          MeiliSearch.qualified_version
+          Meilisearch.qualified_version
         ].flatten.join(';')
       }.compact
     end

lib/meilisearch/index.rb

@@ -2,7 +2,7 @@
 
 require 'meilisearch/http_request'
 
-module MeiliSearch
+module Meilisearch
   class Index < HTTPRequest
     attr_reader :uid, :primary_key, :created_at, :updated_at
 
@@ -233,7 +233,7 @@ def delete_documents!(documents_ids)
 
     def delete_document(document_id)
       if document_id.nil? || document_id.to_s.empty?
-        raise MeiliSearch::InvalidDocumentId, 'document_id cannot be empty or nil'
+        raise Meilisearch::InvalidDocumentId, 'document_id cannot be empty or nil'
       end
 
       encode_document = URI.encode_www_form_component(document_id)

lib/meilisearch/models/task.rb

@@ -2,7 +2,7 @@
 
 require 'forwardable'
 
-module MeiliSearch
+module Meilisearch
   module Models
     class Task
       extend Forwardable
@@ -88,7 +88,7 @@ def refresh(with: nil)
         self.metadata = with || @task_endpoint.task(uid)
 
         self
-      rescue MeiliSearch::ApiError => e
+      rescue Meilisearch::ApiError => e
         raise e unless e.http_code == 404
 
         @deleted = true

lib/meilisearch/multi_search.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module MeiliSearch
+module Meilisearch
   module MultiSearch
     def multi_search(data)
       body = Utils.transform_attributes(data)

lib/meilisearch/task.rb

@@ -3,7 +3,7 @@
 require 'meilisearch/http_request'
 require 'timeout'
 
-module MeiliSearch
+module Meilisearch
   class Task < HTTPRequest
     ALLOWED_PARAMS = [
       :limit, :from, :index_uids, :types, :statuses, :uids, :canceled_by,
@@ -46,7 +46,7 @@ def wait_for_task(task_uid, timeout_in_ms = 5000, interval_in_ms = 50)
         end
       end
     rescue Timeout::Error
-      raise MeiliSearch::TimeoutError
+      raise Meilisearch::TimeoutError
     end
 
     private

lib/meilisearch/tenant_token.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module MeiliSearch
+module Meilisearch
   module TenantToken
     HEADER = {
       typ: 'JWT',