esse 0.0.5 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c1da621c23c6e5ed445c51dc56d789e117874b545dd647e377ca69202d60a3c
-  data.tar.gz: 60c5e597a2ed96b98af47cb90b7e29e4959b3d7dad0d842ea9858d2308a44e75
+  metadata.gz: 74a999f5083a3e258834ca27ac444c63e8f10e20940106f1415331d8a5e772b7
+  data.tar.gz: e7e2853b5fe1296795e6a5d306d12e2ac5c91e88cba671e2cd980ee1b1edfb2e
 SHA512:
-  metadata.gz: c8e3de9e3f05a9f404eaf80ce334d3d9afb06f33040ef6240db1d3535ec657e32107c25df35c8eede19551c7e4fb162c92e0fb775baea4a743aab64768d3f1b0
-  data.tar.gz: 5863ce26c2aaa3617fa665de6f85309866613f827a1b2a27490808aeb2c9a68e85b0fee7a0e59b0c3353140d5e7cc5062ced0e225728b9ea06048a4e4a2b556b
+  metadata.gz: 04a5efa492606d9385b07d8f076966b85bf825ffb49d37c9e35edd8fa5be5c4d283ac193097733f16583f920472aa83e2f1c05a00188649932c2c63ce6f14e53
+  data.tar.gz: 34b4426c3014edfcfe2c1320da019ba6b5c2566842baeb78e14e73df1df173f7a3a7298505b94128180a094aa953ee83dbf09a0e48791d65aa70f04f9e2c5fd9

data/exec/esse

@@ -6,4 +6,6 @@ $LOAD_PATH.unshift File.expand_path('../lib', __dir__)
 require 'esse'
 require 'esse/cli'
 
-Esse::CLI.start(ARGV)
+Esse::CLI.with_friendly_errors do
+  Esse::CLI.start(ARGV)
+end

data/lib/esse/backend/index/aliases.rb

@@ -47,7 +47,11 @@ module Esse
               { add: {index: build_real_index_name(suffix), alias: index_name } }
             ],
           }
-          client.indices.update_aliases(options)
+
+          Esse::Events.instrument('elasticsearch.update_aliases') do |payload|
+            payload[:request] = options
+            payload[:response] = client.indices.update_aliases(options)
+          end
         end
 
         # Replaces all existing aliases by the respective suffixed index from argument.
@@ -55,11 +59,11 @@ module Esse
         # @param options [Hash] Hash of paramenters that will be passed along to elasticsearch request
         # @option [String] :suffix The suffix of the index used for versioning.
         # @raise [Elasticsearch::Transport::Transport::Errors::NotFound] in case of failure
-        # @return [Hash, false] the elasticsearch response, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         def update_aliases(suffix:, **options)
           update_aliases!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::Errors::NotFound
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index/close.rb

@@ -21,7 +21,10 @@ module Esse
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html
         def close!(suffix: index_version, **options)
-          client.indices.close(options.merge(index: index_name(suffix: suffix)))
+          Esse::Events.instrument('elasticsearch.close') do |payload|
+            payload[:request] = attributes = options.merge(index: index_name(suffix: suffix))
+            payload[:response] = client.indices.close(**attributes)
+          end
         end
 
         # Close an index (keep the data on disk, but deny operations with the index).
@@ -35,13 +38,13 @@ module Esse
         # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
         #   unavailable (missing, closed, etc)
         # @option options [Time] :timeout Explicit operation timeout
-        # @return [Hash, false] the elasticsearch response, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html
         def close(suffix: index_version, **options)
           close!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::ServerError
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index/create.rb

@@ -10,43 +10,54 @@ module Esse
 
         # Creates index and applies mappings and settings.
         #
-        #   UsersIndex.backend.create_index # creates index named `<prefix_>users_<suffix|index_version|timestamp>`
+        #   UsersIndex.elasticsearch.create_index # creates index named `<prefix_>users_<suffix|index_version|timestamp>`
         #
         # @param options [Hash] Options hash
         # @option options [Boolean] :alias Update `index_name` alias along with the new index
         # @option options [String] :suffix The index suffix. Defaults to the `IndexClass#index_version` or
         #   `Esse.timestamp`. Suffixed index names might be used for zero-downtime mapping change.
-        # @return [Hash, false] the elasticsearch response or false in case of unsuccessful creation.
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see http://www.elasticsearch.org/blog/changing-mapping-with-zero-downtime/
-        def create_index(suffix: nil, **options)
+        def create_index(suffix: index_version, **options)
           create_index!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::Errors::BadRequest
-          false
+          { 'errors' => true }
         end
 
         # Creates index and applies mappings and settings.
         #
-        #   UsersIndex.backend.create_index! # creates index named `<prefix_>users_<suffix|index_version|timestamp>`
+        #   UsersIndex.elasticsearch.create_index! # creates index named `<prefix_>users_<suffix|index_version|timestamp>`
         #
         # @param options [Hash] Options hash
         # @option options [Boolean] :alias Update `index_name` alias along with the new index
         # @option options [String] :suffix The index suffix. Defaults to the `IndexClass#index_version` or
         #   `Esse.timestamp`. Suffixed index names might be used for zero-downtime mapping change.
+        # @option arguments [String] :wait_for_active_shards Set the number of active shards
+        #    to wait for before the operation returns.
+        # @option arguments [Time] :timeout Explicit operation timeout
+        # @option arguments [Time] :master_timeout Specify timeout for connection to master
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body The configuration for the index (`settings` and `mappings`)
         # @raise [Elasticsearch::Transport::Transport::Errors::NotFound] when index already exists
         # @return [Hash] the elasticsearch response
         #
         # @see http://www.elasticsearch.org/blog/changing-mapping-with-zero-downtime/
-        def create_index!(suffix: nil, **options)
+        def create_index!(suffix: index_version, **options)
           options = DEFAULT_OPTIONS.merge(options)
           name = build_real_index_name(suffix)
           definition = [settings_hash, mappings_hash].reduce(&:merge)
 
-          if options[:alias] && name != index_name
+          if options.delete(:alias) && name != index_name
             definition[:aliases] = { index_name => {} }
           end
 
-          client.indices.create(index: name, body: definition)
+          Esse::Events.instrument('elasticsearch.create_index') do |payload|
+            payload[:request] = opts = options.merge(index: name, body: definition)
+            payload[:response] = response = client.indices.create(**opts)
+            cluster.wait_for_status! if response
+            response
+          end
         end
       end
 

data/lib/esse/backend/index/delete.rb

@@ -6,25 +6,30 @@ module Esse
       module InstanceMethods
         # Deletes ES index
         #
-        #   UsersIndex.backend.delete_index! # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
+        #   UsersIndex.elasticsearch.delete_index! # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
         #
         # @param suffix [String, nil] The index suffix Use nil if you want to delete the current index.
         # @raise [Elasticsearch::Transport::Transport::Errors::NotFound] when index does not exists
         # @return [Hash] elasticsearch response
-        def delete_index!(suffix:)
-          client.indices.delete(index: index_name(suffix: suffix))
+        def delete_index!(suffix: index_version, **options)
+          Esse::Events.instrument('elasticsearch.delete_index') do |payload|
+            payload[:request] = opts = options.merge(index: index_name(suffix: suffix))
+            payload[:response] = response = client.indices.delete(**opts)
+            cluster.wait_for_status! if response
+            response
+          end
         end
 
         # Deletes ES index
         #
-        #   UsersIndex.backend.delete_index # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
+        #   UsersIndex.elasticsearch.delete_index # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
         #
         # @param suffix [String, nil] The index suffix Use nil if you want to delete the current index.
-        # @return [Hash, false] elasticsearch response, of false in case of error.
-        def delete_index(suffix: index_version)
-          delete_index!(suffix: suffix)
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
+        def delete_index(suffix: index_version, **options)
+          delete_index!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::Errors::NotFound
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index/documents.rb

@@ -6,13 +6,13 @@ module Esse
       module InstanceMethods
         def import!(**options)
           type_hash.each_value do |type|
-            type.backend.import!(**options)
+            type.elasticsearch.import!(**options)
           end
         end
 
         def import(**options)
           type_hash.each_value do |type|
-            type.backend.import(**options)
+            type.elasticsearch.import(**options)
           end
         end
       end

data/lib/esse/backend/index/existance.rb

@@ -6,7 +6,7 @@ module Esse
       module InstanceMethods
         # Checks the index existance. Returns true or false
         #
-        #   UsersIndex.backend.exist? #=> true
+        #   UsersIndex.elasticsearch.exist? #=> true
         #
         # @param options [Hash] Options hash
         # @option options [String, nil] :suffix The index suffix. Defaults to the index_version.

data/lib/esse/backend/index/open.rb

@@ -21,7 +21,10 @@ module Esse
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-open.html
         def open!(suffix: index_version, **options)
-          client.indices.open(options.merge(index: index_name(suffix: suffix)))
+          Esse::Events.instrument('elasticsearch.open') do |payload|
+            payload[:request] = attributes = options.merge(index: index_name(suffix: suffix))
+            payload[:response] = client.indices.open(**attributes)
+          end
         end
 
         # Open a previously closed index
@@ -35,13 +38,13 @@ module Esse
         # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
         #   unavailable (missing, closed, etc)
         # @option options [Time] :timeout Explicit operation timeout
-        # @return [Hash, false] the elasticsearch response, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-open.html
         def open(suffix: index_version, **options)
           open!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::ServerError
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index/refresh.rb

@@ -27,13 +27,13 @@ module Esse
         # @param :suffix [String, nil] :suffix The index suffix. Defaults to the index_version.
         #   A uniq index name will be generated if one index already exist with the given alias.
         # @param options [Hash] Options hash
-        # @return [Hash, false] the elasticsearch response, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-refresh.html
         def refresh(suffix: index_version, **options)
           refresh!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::ServerError
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index/reset.rb

@@ -17,14 +17,12 @@ module Esse
         def reset_index!(suffix: index_version, **options)
           existing = []
           suffix ||= Esse.timestamp
-          while exist?(suffix: suffix).tap { |exist| existing << suffix if exist }
-            suffix = Esse.timestamp
-          end
+          suffix = Esse.timestamp while exist?(suffix: suffix).tap { |exist| existing << suffix if exist }
 
           create_index!(suffix: suffix, **options)
           import!(suffix: suffix, **options)
           update_aliases!(suffix: suffix)
-          existing.each { |s| delete_index!(suffix: suffix, **options) }
+          existing.each { |_s| delete_index!(suffix: suffix, **options) }
           true
         end
       end

data/lib/esse/backend/index/update.rb

@@ -27,7 +27,14 @@ module Esse
         #
         # @see http://www.elasticsearch.org/guide/reference/api/admin-indices-put-mapping/
         def update_mapping!(suffix: index_version, **options)
-          client.indices.put_mapping(options.merge(index: index_name(suffix: suffix), body: mappings_hash.fetch(Esse::MAPPING_ROOT_KEY)))
+          Esse::Events.instrument('elasticsearch.update_mapping') do |payload|
+            body = mappings_hash.fetch(Esse::MAPPING_ROOT_KEY)
+            if (type = options[:type])
+              body = body[type.to_s] || body[type.to_sym]
+            end
+            payload[:request] = opts = options.merge(index: index_name(suffix: suffix), body: body)
+            payload[:response] = client.indices.put_mapping(**opts)
+          end
         end
 
         # Create or update a mapping
@@ -47,16 +54,15 @@ module Esse
         #   with the same name across all types
         # @option options [Time] :timeout Explicit operation timeout
         # @option options [Boolean] :master_timeout Timeout for connection to master
-        # @return [Hash, false] the elasticsearch response, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see http://www.elasticsearch.org/guide/reference/api/admin-indices-put-mapping/
         def update_mapping(suffix: index_version, **options)
           update_mapping!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::ServerError
-          false
+          { 'errors' => true }
         end
 
-
         # Closes the index for read/write operations, updates the index settings, and open it again
         #
         # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
@@ -78,12 +84,31 @@ module Esse
         def update_settings!(suffix: index_version, **options)
           response = nil
 
-          close!(suffix: suffix)
-          begin
-            body = settings_hash(cluster_settings: false).fetch(Esse::SETTING_ROOT_KEY)
-            response = client.indices.put_settings(options.merge(index: index_name(suffix: suffix), body: body))
-          ensure
-            open!(suffix: suffix)
+          settings = settings_hash.fetch(Esse::SETTING_ROOT_KEY).transform_keys(&:to_s)
+          settings.delete('number_of_shards') # Can't change number of shards for an index
+          analysis = settings.delete('analysis')
+
+          if settings.any?
+            # When changing the number of replicas the index needs to be open. Changing the number of replicas on a
+            # closed index might prevent the index to be opened correctly again.
+            Esse::Events.instrument('elasticsearch.update_settings') do |payload|
+              payload[:request] = opts = options.merge(index: index_name(suffix: suffix), body: { index: settings })
+              payload[:response] = response = client.indices.put_settings(**opts)
+            end
+          end
+
+          if analysis
+            # It is also possible to define new analyzers for the index. But it is required to close the
+            # index first and open it after the changes are made.
+            close!(suffix: suffix)
+            begin
+              Esse::Events.instrument('elasticsearch.update_settings') do |payload|
+                payload[:request] = opts = options.merge(index: index_name(suffix: suffix), body: { analysis: analysis })
+                payload[:response] = response = client.indices.put_settings(**opts)
+              end
+            ensure
+              open!(suffix: suffix)
+            end
           end
 
           response
@@ -102,13 +127,13 @@ module Esse
         #   If set to `true` existing settings on an index remain unchanged, the default is `false`
         # @option options [Time] :master_timeout Specify timeout for connection to master
         # @option options [Boolean] :flat_settings Return settings in flat format (default: false)
-        # @return [Hash, false] the elasticsearch response, false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see http://www.elasticsearch.org/guide/reference/api/admin-indices-update-settings/
         def update_settings(suffix: index_version, **options)
           update_settings!(suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::ServerError
-          false
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index.rb

@@ -43,7 +43,11 @@ module Esse
       end
 
       def client
-        @index.cluster.client
+        cluster.client
+      end
+
+      def cluster
+        @index.cluster
       end
     end
   end

data/lib/esse/backend/index_type/documents.rb

@@ -15,7 +15,7 @@ module Esse
             bulk(index: batch, suffix: suffix, **options)
           end
         end
-        alias import! import
+        alias_method :import!, :import
 
         # Performs multiple indexing or delete operations in a single API call.
         # This reduces overhead and can greatly increase indexing speed.
@@ -53,7 +53,7 @@ module Esse
 
           client.bulk(definition)
         end
-        alias bulk! bulk
+        alias_method :bulk!, :bulk
 
         # Adds a JSON document to the specified index and makes it searchable. If the document
         # already exists, updates the document and increments its version.
@@ -69,10 +69,10 @@ module Esse
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/docs-index_.html
         def index(id:, body:, suffix: nil, **options)
           client.index(
-            options.merge(index: index_name(suffix: suffix), type: type_name, id: id, body: body),
+            index: index_name(suffix: suffix), type: type_name, id: id, body: body, **options
           )
         end
-        alias index! index
+        alias_method :index!, :index
 
         # Updates a document using the specified script.
         #
@@ -88,7 +88,7 @@ module Esse
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/docs-update.html
         def update!(id:, body:, suffix: nil, **options)
           client.update(
-            options.merge(index: index_name(suffix: suffix), type: type_name, id: id, body: body),
+            index: index_name(suffix: suffix), type: type_name, id: id, body: body, **options
           )
         end
 
@@ -100,13 +100,13 @@ module Esse
         # @option [String, Integer] :id The `_id` of the elasticsearch document
         # @option [Hash] :body the body of the request
         # @option [String, nil] :suffix The index suffix. Defaults to the nil.
-        # @return [Hash, false] the elasticsearch response hash, or false in case of failure
+        # @return [Hash] the elasticsearch response, or an hash with 'errors' as true in case of failure
         #
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/docs-update.html
         def update(id:, body:, suffix: nil, **options)
           update!(id: id, body: body, suffix: suffix, **options)
         rescue Elasticsearch::Transport::Transport::Errors::NotFound
-          false
+          { 'errors' => true }
         end
 
         # Removes a JSON document from the specified index.

data/lib/esse/cli/event_listener.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative '../primitives'
+
+module Esse
+  module CLI
+    module EventListener
+      extend Output
+
+      module_function
+
+      def [](event_name)
+        method_name = Hstring.new(event_name).underscore.to_sym
+        return unless respond_to?(method_name)
+
+        method(method_name)
+      end
+
+      def elasticsearch_create_index(event)
+        print_message '[%<runtime>s] Index %<name>s successfuly created',
+          name: colorize(event[:request][:index], :bold),
+          runtime: formatted_runtime(event[:runtime])
+        if (aliases = event.to_h.dig(:request, :body, :aliases)).is_a?(Hash)
+          print_message ' --> Aliases: %<aliases>s', aliases: aliases.keys.join(', ')
+        end
+      end
+
+      def elasticsearch_delete_index(event)
+        print_message '[%<runtime>s] Index %<name>s successfuly deleted',
+          name: colorize(event[:request][:index], :bold),
+          runtime: formatted_runtime(event[:runtime])
+      end
+
+      def elasticsearch_close(event)
+        print_message '[%<runtime>s] Index %<name>s successfuly closed',
+          name: colorize(event[:request][:index], :bold),
+          runtime: formatted_runtime(event[:runtime])
+      end
+
+      def elasticsearch_open(event)
+        print_message '[%<runtime>s] Index %<name>s successfuly opened',
+          name: colorize(event[:request][:index], :bold),
+          runtime: formatted_runtime(event[:runtime])
+      end
+
+      def elasticsearch_update_mapping(event)
+        if event[:request][:type]
+          print_message '[%<runtime>s] Index %<name>s mapping for type %<type>s successfuly updated',
+            name: colorize(event[:request][:index], :bold),
+            type: event[:request][:type],
+            runtime: formatted_runtime(event[:runtime])
+        else
+          print_message '[%<runtime>s] Index %<name>s successfuly updated mapping',
+            name: colorize(event[:request][:index], :bold),
+            runtime: formatted_runtime(event[:runtime])
+        end
+      end
+
+      def elasticsearch_update_settings(event)
+        print_message '[%<runtime>s] Index %<name>s successfuly updated settings',
+          name: colorize(event[:request][:index], :bold),
+          runtime: formatted_runtime(event[:runtime])
+      end
+
+      def elasticsearch_update_aliases(event)
+        actions = event[:request][:body][:actions]
+        removed = actions.select { |a| a.key?(:remove) }
+        added = actions.select { |a| a.key?(:add) }
+        print_message '[%<runtime>s] Successfuly updated aliases:',
+          runtime: formatted_runtime(event[:runtime])
+
+        removed.each do |action|
+          print_message '%<padding>s-> Index %<name>s removed from alias %<alias>s',
+            name: colorize(action[:remove][:index], :bold),
+            alias: colorize(action[:remove][:alias], :bold),
+            padding: runtime_padding(event[:runtime])
+        end
+        added.each do |action|
+          print_message '%<padding>s-> Index %<name>s added to alias %<alias>s',
+            name: colorize(action[:add][:index], :bold),
+            alias: colorize(action[:add][:alias], :bold),
+            padding: runtime_padding(event[:runtime])
+        end
+      end
+    end
+  end
+end

data/lib/esse/cli/generate.rb

@@ -7,7 +7,7 @@ require_relative 'base'
 module Esse
   module CLI
     class Generate < Base
-      NAMESPACE_PATTERN_RE = %r{\:|/|\\}i.freeze
+      NAMESPACE_PATTERN_RE = %r{:|/|\\}i.freeze
 
       def self.source_root
         File.dirname(__FILE__)
@@ -30,13 +30,17 @@ module Esse
         @types.each do |type|
           @type = Hstring.new(type).underscore
           copy_file(
-            'templates/mappings.json',
+            'templates/type_mappings.json',
             base_dir.join(index_name, 'templates', "#{@type}_mapping.json"),
           )
           template(
-            'templates/serializer.rb.erb',
+            'templates/type_serializer.rb.erb',
             base_dir.join(index_name, 'serializers', "#{@type}_serializer.rb"),
           )
+          template(
+            'templates/type_collection.rb.erb',
+            base_dir.join(index_name, 'collections', "#{@type}_collection.rb"),
+          )
         end
       end
 

data/lib/esse/cli/index/base_operation.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Esse
+  module CLI
+    class Index::BaseOperation
+      include Output
+
+      def initialize(indices:, **options)
+        @indices = Array(indices)
+        @options = options
+      end
+
+      # @abstract
+      # @void
+      def run
+        raise NotImplementedError
+      end
+
+      private
+
+      def validate_indices_option!
+        if @indices.empty?
+          raise InvalidOption.new(<<~END)
+            You must specify at least one index class.
+
+            Example:
+              > esse index create CityIndex
+              > esse index create CityIndex, StateIndex
+          END
+        end
+      end
+
+      def indices
+        eager_load_indices!
+        @indices.map do |class_name|
+          const_exist = begin
+            Kernel.const_defined?(class_name)
+          rescue NameError
+            false
+          end
+
+          raise InvalidOption.new(<<~END, class_name: class_name) unless const_exist
+            Unrecognized index class: %<class_name>p. Are you sure you specified the correct index class?
+          END
+
+          klass = Kernel.const_get(class_name)
+          unless klass < Esse::Index
+            path = Esse.config.indices_directory.join(Hstring.new(class_name).underscore.to_s)
+            raise InvalidOption.new(<<~END, class_name: class_name, path: path)
+              %<class_name>s must be a subclass of Esse::Index.
+
+              Example:
+                # %<path>s.rb
+                class %<class_name>s < Esse::Index
+                  # the index definition goes here
+                end
+            END
+          end
+
+          klass
+        end
+      end
+
+      def eager_load_indices!
+        return false unless Esse.config.indices_directory.exist?
+
+        Esse.config.indices_directory.each_child do |path|
+          next unless path.extname == '.rb'
+
+          require(path.expand_path.to_s)
+        end
+        true
+      end
+    end
+  end
+end

data/lib/esse/cli/index/close.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'base_operation'
+
+module Esse
+  module CLI
+    class Index::Close < Index::BaseOperation
+      def run
+        validate_options!
+        indices.each do |index|
+          index.elasticsearch.close!(**options)
+        end
+      end
+
+      private
+
+      def options
+        @options.slice(*@options.keys - CLI_IGNORE_OPTS)
+      end
+
+      def validate_options!
+        validate_indices_option!
+      end
+    end
+  end
+end