meilisearch-rails 0.3.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e05e5ed1e5210587bd2797412b0f5509b77151a620b79e4e8047c6c1722c3fb
-  data.tar.gz: cfb5a6a39cf21caa0532ae40d005a8c7fd3fff30dbbfa02c90dd1f31f63259df
+  metadata.gz: 914f91a350294c8909a15781828048a0501cb659f782fb22294e189d8f99c20d
+  data.tar.gz: c07ab9397326bed33fca52c556730b38adb4aba84df4ba02d784682280c01a12
 SHA512:
-  metadata.gz: 7a3e738a240fcbdc903d3a58acc9d5d68992a5e1adb56401fcd30a03e81c1fddbcc2024bed1338934de84d366ef58cc9e069243ad6ab5ca78c1330414e4a90b9
-  data.tar.gz: 88228f931aafcbdd69fa483594c3842aaf7603dac277333107dc8629656e96f2fb0b0b57d84039b81b922f95cc9ef6322fb5745a4626058f135357779e227e0c
+  metadata.gz: 15ce645d1ab372b13af052fea2fdca5a5f9ede5c1f4b11f483ccf3f389bdd21734743c847f858765860fa94f9db02866a09265b710d4068c932242035f203b2c
+  data.tar.gz: db881fdc4cec5de57c7eb294782c35f8a3494e82f181a52d41000cf7270e3d275a75191799341c72f54e2e87921c1ae55b10a8e621aa2ee63c568405fd04acce

data/Gemfile

@@ -1,7 +1,7 @@
 source 'http://rubygems.org'
 
 gem 'json', '~> 2.5', '>= 2.5.1'
-gem 'meilisearch', '~> 0.17.0'
+gem 'meilisearch', '~> 0.18.0'
 
 gem 'rubysl', '~> 2.0', platform: :rbx if defined?(RUBY_ENGINE) && RUBY_ENGINE == 'rbx'
 
@@ -28,7 +28,8 @@ group :test do
   gem 'activerecord-jdbc-adapter', platform: :jruby
   gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
   gem 'jdbc-sqlite3', platform: :jruby
-  gem 'rspec', '>= 2.5.0', '< 3.0'
+  gem 'rspec', '~> 3.0'
+  gem 'simplecov', require: 'false'
 
   gem 'byebug'
   gem 'dotenv', '~> 2.7', '>= 2.7.6'

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 MeiliSearch
+Copyright (c) 2021 Meilisearch
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,11 +1,11 @@
 <p align="center">
-  <img src="https://res.cloudinary.com/meilisearch/image/upload/v1587402338/SDKs/meilisearch_rails.svg" alt="MeiliSearch-Rails" width="200" height="200" />
+  <img src="https://raw.githubusercontent.com/meilisearch/integration-guides/main/assets/logos/meilisearch_rails.svg" alt="Meilisearch-Rails" width="200" height="200" />
 </p>
 
-<h1 align="center">MeiliSearch Rails</h1>
+<h1 align="center">Meilisearch Rails</h1>
 
 <h4 align="center">
-  <a href="https://github.com/meilisearch/MeiliSearch">MeiliSearch</a> |
+  <a href="https://github.com/meilisearch/meilisearch">Meilisearch</a> |
   <a href="https://docs.meilisearch.com">Documentation</a> |
   <a href="https://slack.meilisearch.com">Slack</a> |
   <a href="https://roadmap.meilisearch.com/tabs/1-under-consideration">Roadmap</a> |
@@ -19,21 +19,21 @@
   <a href="https://app.bors.tech/repositories/33032"><img src="https://bors.tech/images/badge_small.svg" alt="Bors enabled"></a>
 </p>
 
-<p align="center">⚡ The MeiliSearch integration for Ruby on Rails 💎</p>
+<p align="center">⚡ The Meilisearch integration for Ruby on Rails 💎</p>
 
-**MeiliSearch Rails** is the MeiliSearch integration for Ruby on Rails developers.
+**Meilisearch Rails** is the Meilisearch integration for Ruby on Rails developers.
 
-**MeiliSearch** is an open-source search engine. [Discover what MeiliSearch is!](https://github.com/meilisearch/MeiliSearch)
+**Meilisearch** is an open-source search engine. [Discover what Meilisearch is!](https://github.com/meilisearch/meilisearch)
 
 ## Table of Contents <!-- omit in toc -->
 
 - [📖 Documentation](#-documentation)
-- [🤖 Compatibility with MeiliSearch](#-compatibility-with-meilisearch)
+- [🤖 Compatibility with Meilisearch](#-compatibility-with-meilisearch)
 - [🚀 Getting Started](#-getting-started)
 - [⚙️ Settings](#️-settings)
 - [🔍 Custom search](#-custom-search)
 - [🪛 Options](#-options)
-  - [MeiliSearch configuration & environment](#meilisearch-configuration--environment)
+  - [Meilisearch configuration & environment](#meilisearch-configuration--environment)
   - [Index configuration](#index-configuration)
     - [Custom attribute definition](#custom-attribute-definition)
     - [Custom primary key](#custom-primary-key)
@@ -54,11 +54,11 @@
 
 The whole usage of this gem is detailed in this README.
 
-To learn more about MeiliSearch, check out our [Documentation](https://docs.meilisearch.com/learn/tutorials/getting_started.html) or our [API References](https://docs.meilisearch.com/reference/api/).
+To learn more about Meilisearch, check out our [Documentation](https://docs.meilisearch.com/learn/tutorials/getting_started.html) or our [API References](https://docs.meilisearch.com/reference/api/).
 
-## 🤖 Compatibility with MeiliSearch
+## 🤖 Compatibility with Meilisearch
 
-This package only guarantees the compatibility with the [version v0.24.0 of MeiliSearch](https://github.com/meilisearch/MeiliSearch/releases/tag/v0.24.0).
+This package only guarantees the compatibility with the [version v0.25.0 of Meilisearch](https://github.com/meilisearch/meilisearch/releases/tag/v0.25.0).
 
 ## 🔧 Installation <!-- omit in toc -->
 
@@ -76,18 +76,18 @@ source 'https://rubygems.org'
 gem 'meilisearch-rails'
 ```
 
-### Run MeiliSearch <!-- omit in toc -->
+### Run Meilisearch <!-- omit in toc -->
 
-There are many easy ways to [download and run a MeiliSearch instance](https://docs.meilisearch.com/reference/features/installation.html#download-and-launch).
+There are many easy ways to [download and run a Meilisearch instance](https://docs.meilisearch.com/reference/features/installation.html#download-and-launch).
 
 For example, if you use Docker:
 
 ```bash
-docker pull getmeili/meilisearch:latest # Fetch the latest version of MeiliSearch image from Docker Hub
+docker pull getmeili/meilisearch:latest # Fetch the latest version of Meilisearch image from Docker Hub
 docker run -it --rm -p 7700:7700 getmeili/meilisearch:latest ./meilisearch --master-key=masterKey
 ```
 
-NB: you can also download MeiliSearch from **Homebrew** or **APT**.
+NB: you can also download Meilisearch from **Homebrew** or **APT**.
 
 ## 🚀 Getting Started
 
@@ -96,9 +96,9 @@ NB: you can also download MeiliSearch from **Homebrew** or **APT**.
 Create a new file `config/initializers/meilisearch.rb` to setup your `MEILISEARCH_HOST` and `MEILISEARCH_API_KEY`
 
 ```ruby
-MeiliSearch.configuration = {
-  meilisearch_host: 'YourMeiliSearchHost', # example: http://localhost:7700
-  meilisearch_api_key: 'YourMeiliSearchAPIKey',
+MeiliSearch::Rails.configuration = {
+  meilisearch_host: 'YourMeilisearchHost', # example: http://localhost:7700
+  meilisearch_api_key: 'YourMeilisearchAPIKey',
 }
 ```
 
@@ -110,11 +110,11 @@ The following code will create a `Book` index and add search capabilities to you
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch do
-    attribute :title, :author # only the attributes 'title', and 'author' will be sent to MeiliSearch
-    # all attributes will be sent to MeiliSearch if block is left empty
+    attribute :title, :author # only the attributes 'title', and 'author' will be sent to Meilisearch
+    # all attributes will be sent to Meilisearch if block is left empty
   end
 end
 ```
@@ -128,7 +128,7 @@ We **strongly recommend the use of front-end search** through our [JavaScript AP
 Search returns ORM-compliant objects reloaded from your database.
 
 ```ruby
-# MeiliSearch is typo-tolerant:
+# Meilisearch is typo-tolerant:
 hits = Book.search('harry pottre')
 hits.each do |hit|
   puts hit.title
@@ -146,9 +146,9 @@ This gem supports:
 Specify the `:pagination_backend` in the configuration file:
 
 ```ruby
-MeiliSearch.configuration = {
-  meilisearch_host: 'YourMeiliSearchHost',
-  meilisearch_api_key: 'YourMeiliSearchAPIKey',
+MeiliSearch::Rails.configuration = {
+  meilisearch_host: 'YourMeilisearchHost',
+  meilisearch_api_key: 'YourMeilisearchAPIKey',
   pagination_backend: :kaminari #:will_paginate
 }
 ```
@@ -178,13 +178,13 @@ Book.search('harry potter', hitsPerPage: 10)
 
 #### Extra Configuration <!-- omit in toc -->
 
-Requests made to MeiliSearch may timeout and retry. To adapt the behavior to
+Requests made to Meilisearch may timeout and retry. To adapt the behavior to
 your needs, you can change the parameters during configuration:
 
 ```ruby
-MeiliSearch.configuration = {
-  meilisearch_host: 'YourMeiliSearchHost',
-  meilisearch_api_key: 'YourMeiliSearchAPIKey',
+MeiliSearch::Rails.configuration = {
+  meilisearch_host: 'YourMeilisearchHost',
+  meilisearch_api_key: 'YourMeilisearchAPIKey',
   timeout: 2,
   max_retries: 1,
 }
@@ -196,11 +196,12 @@ You can configure the index settings by adding them inside the `meilisearch` blo
 
 ```ruby
 class Book < ApplicationRecord
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch do
     searchable_attributes [:title, :author, :publisher, :description]
     filterable_attributes [:genre]
+    sortable_attributes [:title]
     ranking_rules [
       'proximity',
       'typo',
@@ -232,9 +233,20 @@ Book.search('Harry', attributesToHighlight: ['*'])
 👉 Don't forget that `attributes_to_highlight`, `attributes_to_crop`, and
 `crop_length` can be set up in the `meilisearch` block of your model.
 
+## 🔍 Sorted search
+
+As an example of how to use the sort option, here is how you could achieve
+returning all books sorted by title in ascending order:
+
+```ruby
+Book.search('*', sort: ['title:asc'])
+```
+
+👉 Don't forget to set up the `sortable_attributes` option in the `meilisearch` block of your model.
+
 ## 🪛 Options
 
-### MeiliSearch configuration & environment
+### Meilisearch configuration & environment
 
 #### Custom index_uid <!-- omit in toc -->
 
@@ -242,7 +254,7 @@ By default, the **index_uid** will be the class name, e.g. `Book`. You can custo
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch index_uid: 'MyCustomUID' do
   end
@@ -255,7 +267,7 @@ You can suffix the index UID with the current Rails environment using the follow
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch per_environment: true do # The index UID will be "Book_#{Rails.env}"
   end
@@ -272,7 +284,7 @@ You can add a custom attribute by using the `add_attribute` option or by using a
 
 ```ruby
 class Author < ApplicationRecord
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch do
     attribute :first_name, :last_name
@@ -304,7 +316,7 @@ Note that the primary key must have a **unique value**.
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch primary_key: 'ISBN' do
   end
@@ -317,7 +329,7 @@ As soon as you use those constraints, `add_documents` and `delete_documents` cal
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch if: :published?, unless: :premium? do
   end
@@ -341,7 +353,7 @@ You can index a record in several indexes using the `add_index` option:
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   PUBLIC_INDEX_UID = 'Books'
   SECURED_INDEX_UID = 'PrivateBooks'
@@ -369,7 +381,7 @@ You may want to share an index between several models. You'll need to ensure you
 
 ```ruby
 class Cat < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch index_uid: 'Animals', primary_key: :ms_id do
   end
@@ -381,7 +393,7 @@ class Cat < ActiveRecord::Base
 end
 
 class Dog < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch index_uid: 'Animals', primary_key: :ms_id do
   end
@@ -399,7 +411,7 @@ You can configure the auto-indexing & auto-removal process to use a queue to per
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch enqueue: true do # ActiveJob will be triggered using a `meilisearch` queue
   end
@@ -414,7 +426,7 @@ With **ActiveJob**:
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch enqueue: :trigger_job do
     attribute :title, :author, :description
@@ -430,7 +442,7 @@ class MyActiveJob < ApplicationJob
     if remove
       # The record has likely already been removed from your database so we cannot
       # use ActiveRecord#find to load it.
-      # We access the underlying MeiliSearch index object.
+      # We access the underlying Meilisearch index object.
       Book.index.delete_document(id)
     else
       # The record should be present.
@@ -444,7 +456,7 @@ With [**Sidekiq**](https://github.com/mperham/sidekiq):
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch enqueue: :trigger_sidekiq_worker do
     attribute :title, :author, :description
@@ -460,7 +472,7 @@ class MySidekiqWorker
     if remove
       # The record has likely already been removed from your database so we cannot
       # use ActiveRecord#find to load it.
-      # We access the underlying MeiliSearch index object.
+      # We access the underlying Meilisearch index object.
       Book.index.delete_document(id)
     else
       # The record should be present.
@@ -474,7 +486,7 @@ With [**DelayedJob**](https://github.com/collectiveidea/delayed_job):
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch enqueue: :trigger_delayed_job do
     attribute :title, :author, :description
@@ -498,7 +510,7 @@ Extend a change to a related record.
 
 ```ruby
 class Author < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   has_many :books
   # If your association uses belongs_to
@@ -508,7 +520,7 @@ class Author < ActiveRecord::Base
 end
 
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   belongs_to :author
   after_touch :index!
@@ -527,7 +539,7 @@ With **Sequel**, you can use the `touch` plugin to propagate changes.
 ```ruby
 # app/models/author.rb
 class Author < Sequel::Model
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   one_to_many :books
 
@@ -549,7 +561,7 @@ end
 
 # app/models/book.rb
 class Book < Sequel::Model
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   many_to_one :author
   after_touch :index!
@@ -572,7 +584,7 @@ You can strip all HTML tags from your attributes with the `sanitize` option.
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch sanitize: true do
   end
@@ -585,7 +597,7 @@ You can force the UTF-8 encoding of all your attributes using the `force_utf8_en
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch force_utf8_encoding: true do
   end
@@ -633,11 +645,11 @@ index = Book.index
 
 #### Exceptions <!-- omit in toc -->
 
-You can disable exceptions that could be raised while trying to reach MeiliSearch's API by using the `raise_on_failure` option:
+You can disable exceptions that could be raised while trying to reach Meilisearch's API by using the `raise_on_failure` option:
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   # Only raise exceptions in development environment.
   meilisearch raise_on_failure: Rails.env.development? do
@@ -653,13 +665,13 @@ You can force indexing and removing to be synchronous by setting the following o
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch synchronous: true do
   end
 end
 ```
-🚨 This is only recommended for testing purposes, the gem will call the `wait_for_pending_update` method that will stop your code execution until the asynchronous task has been processed by MeilSearch.
+🚨 This is only recommended for testing purposes, the gem will call the `wait_for_task` method that will stop your code execution until the asynchronous task has been processed by MeilSearch.
 
 ##### Disable auto-indexing & auto-removal <!-- omit in toc -->
 
@@ -667,7 +679,7 @@ You can disable auto-indexing and auto-removing setting the following options:
 
 ```ruby
 class Book < ActiveRecord::Base
-  include MeiliSearch
+  include MeiliSearch::Rails
 
   meilisearch auto_index: false, auto_remove: false do
   end
@@ -695,4 +707,4 @@ The provided features and the code base is inspired by [algoliasearch-rails](htt
 
 <hr>
 
-**MeiliSearch** provides and maintains many **SDKs and Integration tools** like this one. We want to provide everyone with an **amazing search experience for any kind of project**. If you want to contribute, make suggestions, or just know what's going on right now, visit us in the [integration-guides](https://github.com/meilisearch/integration-guides) repository.
+**Meilisearch** provides and maintains many **SDKs and Integration tools** like this one. We want to provide everyone with an **amazing search experience for any kind of project**. If you want to contribute, make suggestions, or just know what's going on right now, visit us in the [integration-guides](https://github.com/meilisearch/integration-guides) repository.

data/Rakefile

@@ -7,7 +7,7 @@ Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ''
 
   rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "MeiliSearch Rails #{version}"
+  rdoc.title = "Meilisearch Rails #{version}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end

data/lib/meilisearch/rails/configuration.rb

@@ -0,0 +1,23 @@
+module MeiliSearch
+  module Rails
+    module Configuration
+      def configuration
+        raise NotConfigured if @_config.blank?
+
+        @_config
+      end
+
+      def configuration=(configuration)
+        @_config = configuration
+      end
+
+      def client
+        ::MeiliSearch::Client.new(
+          configuration[:meilisearch_host] || 'http://localhost:7700',
+          configuration[:meilisearch_api_key],
+          configuration.slice(:timeout, :max_retries)
+        )
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/errors.rb

@@ -0,0 +1,14 @@
+module MeiliSearch
+  module Rails
+    class NoBlockGiven < StandardError; end
+
+    class BadConfiguration < StandardError; end
+
+    class NotConfigured < StandardError
+      def message
+        'Please configure Meilisearch. Set MeiliSearch::Rails.configuration = ' \
+          "{meilisearch_host: 'YOUR_MEILISEARCH_HOST', meilisearch_api_key: 'YOUR_API_KEY'}"
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/ms_job.rb

@@ -0,0 +1,11 @@
+module MeiliSearch
+  module Rails
+    class MSJob < ::ActiveJob::Base
+      queue_as :meilisearch
+
+      def perform(record, method)
+        record.send(method)
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/pagination/kaminari.rb

@@ -0,0 +1,48 @@
+unless defined? Kaminari
+  raise(MeiliSearch::BadConfiguration,
+        "Meilisearch: Please add 'kaminari' to your Gemfile to use kaminari pagination backend")
+end
+
+require 'kaminari/models/array_extension'
+
+module MeiliSearch
+  module Rails
+    module Pagination
+      class Kaminari < ::Kaminari::PaginatableArray
+        def initialize(array, options)
+          if RUBY_VERSION >= '3'
+            super(array, **options)
+          else
+            super(array, options)
+          end
+        end
+
+        def limit(_num)
+          # noop
+          self
+        end
+
+        def offset(_num)
+          # noop
+          self
+        end
+
+        class << self
+          def create(results, total_hits, options = {})
+            offset = ((options[:page] - 1) * options[:per_page])
+            array = new results, limit: options[:per_page], offset: offset, total_count: total_hits
+
+            if array.empty? && !results.empty?
+              # since Kaminari 0.16.0, you need to pad the results with nil values so it matches the offset param
+              # otherwise you'll get an empty array: https://github.com/amatsuda/kaminari/commit/29fdcfa8865f2021f710adaedb41b7a7b081e34d
+              results = ([nil] * offset) + results
+              array = new results, offset: offset, limit: options[:per_page], total_count: total_hits
+            end
+
+            array
+          end
+        end
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/pagination/will_paginate.rb

@@ -0,0 +1,22 @@
+begin
+  require 'will_paginate/collection'
+rescue LoadError
+  raise(MeiliSearch::BadConfiguration,
+        "MeiliSearch: Please add 'will_paginate' to your Gemfile to use will_paginate pagination backend")
+end
+
+module MeiliSearch
+  module Rails
+    module Pagination
+      class WillPaginate
+        def self.create(results, total_hits, options = {})
+          ::WillPaginate::Collection.create(options[:page], options[:per_page], total_hits) do |pager|
+            start = (options[:page] - 1) * options[:per_page]
+            paginated_results = results[start, options[:per_page]]
+            pager.replace paginated_results
+          end
+        end
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/pagination.rb

@@ -0,0 +1,20 @@
+module MeiliSearch
+  module Rails
+    module Pagination
+      autoload :WillPaginate, 'meilisearch/rails/pagination/will_paginate'
+      autoload :Kaminari, 'meilisearch/rails/pagination/kaminari'
+
+      def self.create(results, total_hits, options = {})
+        return results if MeiliSearch::Rails.configuration[:pagination_backend].nil?
+
+        begin
+          backend = MeiliSearch::Rails.configuration[:pagination_backend].to_s.classify
+
+          ::MeiliSearch::Rails::Pagination.const_get(backend).create(results, total_hits, options)
+        rescue NameError
+          raise(BadConfiguration, 'Unknown pagination backend')
+        end
+      end
+    end
+  end
+end

data/lib/meilisearch/rails/railtie.rb

@@ -0,0 +1,14 @@
+require 'rails'
+
+module MeiliSearch
+  module Rails
+    class Railtie < ::Rails::Railtie
+      rake_tasks do
+        load 'meilisearch/rails/tasks/meilisearch.rake'
+      end
+    end
+
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/meilisearch/rails/tasks/meilisearch.rake

@@ -0,0 +1,22 @@
+namespace :meilisearch do
+  desc 'Reindex all models'
+  task reindex: :environment do
+    puts 'Reindexing all Meilisearch models'
+
+    MeiliSearch::Rails::Utilities.reindex_all_models
+  end
+
+  desc 'Set settings to all indexes'
+  task set_all_settings: :environment do
+    puts 'Set settings in all Meilisearch models'
+
+    MeiliSearch::Rails::Utilities.set_settings_all_models
+  end
+
+  desc 'Clear all indexes'
+  task clear_indexes: :environment do
+    puts 'Clearing indexes from all Meilisearch models'
+
+    MeiliSearch::Rails::Utilities.clear_all_indexes
+  end
+end

data/lib/meilisearch/rails/utilities.rb

@@ -0,0 +1,46 @@
+module MeiliSearch
+  module Rails
+    module Utilities
+      class << self
+        def get_model_classes
+          if ::Rails.application && defined?(::Rails.autoloaders) && ::Rails.autoloaders.zeitwerk_enabled?
+            Zeitwerk::Loader.eager_load_all
+          elsif ::Rails.application
+            ::Rails.application.eager_load!
+          end
+          klasses = MeiliSearch::Rails.instance_variable_get(:@included_in)
+          (klasses + klasses.map(&:descendants).flatten).uniq
+        end
+
+        def clear_all_indexes
+          get_model_classes.each(&:clear_index!)
+        end
+
+        def reindex_all_models
+          klasses = get_model_classes
+
+          ::Rails.logger.info "\n\nReindexing #{klasses.count} models: #{klasses.to_sentence}.\n"
+
+          klasses.each do |klass|
+            ::Rails.logger.info klass
+            ::Rails.logger.info "Reindexing #{klass.count} records..."
+
+            klass.ms_reindex!
+          end
+        end
+
+        def set_settings_all_models
+          klasses = get_model_classes
+
+          ::Rails.logger.info "\n\nPushing settings for #{klasses.count} models: #{klasses.to_sentence}.\n"
+
+          klasses.each do |klass|
+            ::Rails.logger.info "Pushing #{klass} settings..."
+
+            klass.ms_set_settings
+          end
+        end
+      end
+    end
+  end
+end