esse 0.0.2 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f309243fb21b878b0d14b85c16a2d344dd595659d7972cadc7cd40c246ffd9a
-  data.tar.gz: 670f66a022b7fe568fe9f995c0d8cd9832d65da5a9bfb21490a4a7e222540023
+  metadata.gz: 74a999f5083a3e258834ca27ac444c63e8f10e20940106f1415331d8a5e772b7
+  data.tar.gz: e7e2853b5fe1296795e6a5d306d12e2ac5c91e88cba671e2cd980ee1b1edfb2e
 SHA512:
-  metadata.gz: 99b6fa0017361c185cdf71c7505f6a37dcfc28127f04504496dc1fbdddf8b7ca4a2c06e6c2e56dd30464c90f3b2012fc982bcdb3ed5159a1b331bfbe3c2e30d1
-  data.tar.gz: db75895be7643f9bbedb9c81c071b4438e1f277637b2447dd7d8444c719820c41a97bdf69f0230e422a60412b2de93b674d2e459d0a324cb21bd49cbf2763f91
+  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

@@ -44,10 +44,14 @@ module Esse
               *indices.map do |index|
                 { remove: { index: index, alias: index_name } }
               end,
-              { add: {index: real_index_name(suffix), alias: index_name } }
+              { 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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Esse
+  module Backend
+    class Index
+      module InstanceMethods
+        # Close an index (keep the data on disk, but deny operations with the index).
+        #
+        # @option options [String, nil] :suffix The index suffix. Defaults to the index_version.
+        #   Use nil if you want to check existence of the `index_name` index or alias.
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Time] :timeout Explicit operation timeout
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html
+        def close!(suffix: index_version, **options)
+          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).
+        #
+        # @option options [String, nil] :suffix The index suffix. Defaults to the index_version.
+        #   Use nil if you want to check existence of the `index_name` index or alias.
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @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] 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
+          { 'errors' => true }
+        end
+      end
+
+      include InstanceMethods
+    end
+  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 # 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(suffix: nil, **options)
-          create!(suffix: suffix, **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! # 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!(suffix: nil, **options)
+        def create_index!(suffix: index_version, **options)
           options = DEFAULT_OPTIONS.merge(options)
-          name = real_index_name(suffix)
+          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,29 +6,30 @@ module Esse
       module InstanceMethods
         # Deletes ES index
         #
-        #   UsersIndex.backend.delete! # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
+        #   UsersIndex.elasticsearch.delete_index! # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
         #
-        # @param options [Hash] Options hash
-        # @option [String, nil] :suffix The index suffix Use nil if you want to delete the current 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!(suffix:)
-          name = suffix ? real_index_name(suffix) : index_name
-
-          client.indices.delete(index: name)
+        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 # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
+        #   UsersIndex.elasticsearch.delete_index # deletes `<prefix_>users<_suffix|_index_version|_timestamp>` index
         #
-        # @param options [Hash] Options hash
-        # @option [String] :suffix 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(suffix: index_version)
-          delete!(suffix: suffix)
+        # @param suffix [String, nil] The index suffix Use nil if you want to delete the current index.
+        # @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,14 +6,13 @@ 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.
         #   Use nil if you want to check existence of the `index_name` index or alias.
         def exist?(suffix: index_version)
-          name = suffix ? real_index_name(suffix) : index_name
-          client.indices.exists(index: name)
+          client.indices.exists(index: index_name(suffix: suffix))
         end
       end
 

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Esse
+  module Backend
+    class Index
+      module InstanceMethods
+        # Open a previously closed index
+        #
+        # @option options [String, nil] :suffix The index suffix. Defaults to the index_version.
+        #   Use nil if you want to check existence of the `index_name` index or alias.
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Time] :timeout Explicit operation timeout
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-open.html
+        def open!(suffix: index_version, **options)
+          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
+        #
+        # @option options [String, nil] :suffix The index suffix. Defaults to the index_version.
+        #   Use nil if you want to check existence of the `index_name` index or alias.
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @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] 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
+          { 'errors' => true }
+        end
+      end
+
+      include InstanceMethods
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Esse
+  module Backend
+    class Index
+      module InstanceMethods
+        # Performs the refresh operation in one or more indices.
+        #
+        # @note The refresh operation can adversely affect indexing throughput when used too frequently.
+        # @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
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-refresh.html
+        def refresh!(suffix: index_version, **options)
+          client.indices.refresh(
+            options.merge(index: index_name(suffix: suffix)),
+          )
+        end
+
+        # Performs the refresh operation in one or more indices.
+        #
+        # @note The refresh operation can adversely affect indexing throughput when used too frequently.
+        # @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] 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
+          { 'errors' => true }
+        end
+      end
+
+      include InstanceMethods
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Esse
+  module Backend
+    class Index
+      module InstanceMethods
+        # Deletes, creates and imports data to the index. Performs zero-downtime index resetting.
+        #
+        # @option options [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.
+        # @option options [Time] :timeout Explicit operation timeout
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-open-close.html
+        def reset_index!(suffix: index_version, **options)
+          existing = []
+          suffix ||= Esse.timestamp
+          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) }
+          true
+        end
+      end
+
+      include InstanceMethods
+    end
+  end
+end

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

@@ -4,12 +4,136 @@ module Esse
   module Backend
     class Index
       module InstanceMethods
-        def update_mapping!(**options)
-          # @TODO
+        # Create or update a mapping
+        #
+        # @option options [String] :type The name of the document type. This field is required for some elasticsearch versions
+        # @option options [Boolean] :ignore_conflicts Specify whether to ignore conflicts while updating the mapping
+        #   (default: false)
+        # @option options [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into
+        #   no concrete indices. (This includes `_all` string or when no indices have been specified)
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Boolean] :update_all_types Whether to update the mapping for all fields
+        #   with the same name across all types
+        # @option options [Time] :timeout Explicit operation timeout
+        # @option options [Boolean] :master_timeout Timeout for connection to master
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see http://www.elasticsearch.org/guide/reference/api/admin-indices-put-mapping/
+        def update_mapping!(suffix: index_version, **options)
+          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
 
-        def update_settings!(**options)
-          # @TODO
+        # Create or update a mapping
+        #
+        # @option options [String] :type The name of the document type. This field is required for some elasticsearch versions
+        # @option options [Boolean] :ignore_conflicts Specify whether to ignore conflicts while updating the mapping
+        #   (default: false)
+        # @option options [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into
+        #   no concrete indices. (This includes `_all` string or when no indices have been specified)
+        # @option options [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Boolean] :update_all_types Whether to update the mapping for all fields
+        #   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] 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
+          { '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
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Boolean] :include_defaults Whether to return all default clusters setting
+        # @option options [Boolean] :preserve_existing Whether to update existing settings.
+        #   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)
+        # @raise [Elasticsearch::Transport::Transport::Errors::BadRequest, Elasticsearch::Transport::Transport::Errors::NotFound]
+        #   in case of failure
+        # @return [Hash] the elasticsearch response
+        #
+        # @see http://www.elasticsearch.org/guide/reference/api/admin-indices-update-settings/
+        def update_settings!(suffix: index_version, **options)
+          response = nil
+
+          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
+        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
+        #   are open, closed or both. (options: open, closed)
+        # @option options [String] :ignore_indices When performed on multiple indices, allows to ignore
+        #   `missing` ones (options: none, missing) @until 1.0
+        # @option options [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
+        #   unavailable (missing, closed, etc)
+        # @option options [Boolean] :include_defaults Whether to return all default clusters setting
+        # @option options [Boolean] :preserve_existing Whether to update existing settings.
+        #   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] 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
+          { 'errors' => true }
         end
       end
 

data/lib/esse/backend/index.rb

@@ -10,11 +10,15 @@ module Esse
       require_relative 'index/delete'
       require_relative 'index/existance'
       require_relative 'index/update'
+      require_relative 'index/refresh'
+      require_relative 'index/reset'
       require_relative 'index/documents'
+      require_relative 'index/open'
+      require_relative 'index/close'
 
       extend Forwardable
 
-      NAMING = %i[index_name index_version].freeze
+      NAMING = %i[index_version].freeze
       DEFINITION = %i[settings_hash mappings_hash].freeze
 
       def_delegators :@index, :type_hash, *(NAMING + DEFINITION)
@@ -25,13 +29,25 @@ module Esse
 
       protected
 
-      def real_index_name(suffix = nil)
+      def index_name(suffix: nil)
+        suffix = Hstring.new(suffix).underscore.presence
+        return @index.index_name unless suffix
+
+        [@index.index_name, suffix].join('_')
+      end
+
+      def build_real_index_name(suffix = nil)
         suffix = Hstring.new(suffix).underscore.presence || index_version || Esse.timestamp
-        [index_name, suffix].compact.join('_')
+
+        index_name(suffix: suffix)
       end
 
       def client
-        @index.cluster.client
+        cluster.client
+      end
+
+      def cluster
+        @index.cluster
       end
     end
   end