jay_api 29.5.0 → 29.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f997e23215ab5ee73c077534d19889c9b91ae5c877a77859b75f454e555bb105
-  data.tar.gz: f0250fc57649d863fde276f3e753b9d8aecff90c0bd286a1a97fb12b447b1c33
+  metadata.gz: 469981ee390e1c409ff7e4e3faef1d9fb3579e87c9f1e2262f1664ba8d4731c3
+  data.tar.gz: 0f9b84be25dfc1a2f318edb8ae462714553e7898c278e1da0b9e38d211049719
 SHA512:
-  metadata.gz: bf6ba31a0f5960479de755757d6479b0c9373cc4b4e9e99ee55d853ba90417d1161b02d88d2103d8c86cd13a028f725293c3f13422c0422c51e0d64b6a906a40
-  data.tar.gz: ad81742c20b6a93b973972ee49b814ea61b3ecaac8ce0945aceac05dbd8020ec2c9d4dca701c261dadc7eeffbb3e40658ba6476ba015662217e0a8509785235f
+  metadata.gz: 23f0fd77caa519085f05b6efeff92c128895a912ffa3e75d83703f3b4a7b27cf76e39dfcb42652461fc730c3ff790df67913f0d7f52926ab8bebec86cf02196b
+  data.tar.gz: 48c2c4d5c97ef87fe7ce9ca0809d4b650549db40b654bb7b856438462b6b1c482bdd83f5c11840428fac5f51fc51cbc08cf43bec996f22abdf2e08a4f87050f8

data/CHANGELOG.md

@@ -8,6 +8,26 @@ Please mark backwards incompatible changes with an exclamation mark at the start
 
 ## [Unreleased]
 
+## [29.7.0] - 2026-04-28
+
+### Added
+- The `#cluster` method to `JayAPI::Elasticsearch::Client`. The method returns
+  an instance of `JayAPI::Elasticsearch::Cluster`.
+- The `Elasticsearch::Cluster` class. The class gives the user access to
+  cluster-level endpoints, currently including cluster health.
+
+## [29.6.0] - 2026-03-16
+
+### Deprecated
+- The `#task_by_id` method of the `Elasticsearch::Client` class.
+
+### Added
+- The `#all` method to `JayAPI::Elasticsearch::Tasks`. The method returns the
+  status of all running tasks on the Elasticsearch cluster.
+- The `#tasks` method to `JayAPI::Elasticsearch::Client`. The method returns an
+  instance of `JayAPI::Elasticsearch::Tasks`, which gives the user access to the
+  status of the tasks running on the Elasticsearch cluster.
+
 ## [29.5.0] - 2026-02-23
 
 ### Fixed

data/lib/jay_api/elasticsearch/client.rb

@@ -1,39 +1,24 @@
 # frozen_string_literal: true
 
 require 'timeout'
-require 'elasticsearch/transport/transport/errors'
 require 'faraday/error'
 require 'forwardable'
 
-require_relative '../abstract/connection'
+require_relative 'mixins/retriable_requests'
+require_relative 'cluster'
 require_relative 'stats'
+require_relative 'tasks'
 
 module JayAPI
   module Elasticsearch
-    # The JayAPI wrapper class over the Elastisearch::Client object. It mirrors
+    # The JayAPI wrapper class over the +Elasticsearch::Client+ object. It mirrors
     # the object's API, but if one of the ERRORS is raised, this Wrapper class will
     # rescue the error up to a few times and re-try the connection. This way the
     # connection to Elasticsearch will be more robust.
     class Client
       extend Forwardable
 
-      # The errors that, if raised, must cause a retry of the connection.
-      ERRORS = [
-        ::Elasticsearch::Transport::Transport::ServerError,
-        Faraday::TimeoutError
-      ].freeze
-
-      # Subclasses of the +Elasticsearch::Transport::Transport::ServerError+
-      # for which a retry doesn't make sense.
-      NON_RETRIABLE_ERRORS = [
-        ::Elasticsearch::Transport::Transport::Errors::BadRequest,
-        ::Elasticsearch::Transport::Transport::Errors::Unauthorized,
-        ::Elasticsearch::Transport::Transport::Errors::Forbidden,
-        ::Elasticsearch::Transport::Transport::Errors::NotFound,
-        ::Elasticsearch::Transport::Transport::Errors::MethodNotAllowed,
-        ::Elasticsearch::Transport::Transport::Errors::RequestEntityTooLarge,
-        ::Elasticsearch::Transport::Transport::Errors::NotImplemented
-      ].freeze
+      include JayAPI::Elasticsearch::Mixins::RetriableRequests
 
       attr_reader :transport_client, :logger, :max_attempts, :wait_strategy
 
@@ -88,6 +73,7 @@ module JayAPI
       # parameters. If the request fails, additional retries will be performed.
       # @see Elasticsearch::Client#tasks for more info about the arguments and
       #   the return value.
+      # @deprecated Use Tasks#by_id instead.
       def task_by_id(**args)
         retry_request { transport_client.tasks.get(**args) }
       end
@@ -98,13 +84,17 @@ module JayAPI
         @stats ||= ::JayAPI::Elasticsearch::Stats.new(transport_client)
       end
 
-      private
+      # @return [JayAPI::Elasticsearch::Tasks] An instance of the +Tasks+ class,
+      #   which can be used to retrieve the status of the tasks running on the
+      #   Elasticsearch cluster.
+      def tasks
+        @tasks ||= ::JayAPI::Elasticsearch::Tasks.new(client: self)
+      end
 
-      # @param [Proc] block The block to execute.
-      # @yieldreturn [Object] Whatever the block returns
-      def retry_request(&block)
-        Abstract::Connection.new(max_attempts: max_attempts, wait_strategy: wait_strategy.dup, logger: logger)
-                            .retry(errors: ERRORS, except: NON_RETRIABLE_ERRORS, &block)
+      # @return [JayAPI::Elasticsearch::Cluster] An instance of the +Cluster+
+      #   class, which gives the caller access to cluster-related endpoints.
+      def cluster
+        @cluster ||= ::JayAPI::Elasticsearch::Cluster.new(transport_client)
       end
     end
   end

data/lib/jay_api/elasticsearch/cluster.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+require_relative 'mixins/retriable_requests'
+
+module JayAPI
+  module Elasticsearch
+    # Represents the Elasticsearch cluster and provides access to
+    # cluster-level APIs.
+    class Cluster
+      extend Forwardable
+
+      def_delegator :cluster_client, :health
+
+      attr_reader :transport_client
+
+      # @param [Elasticsearch::Transport::Client] transport_client The transport
+      #   client to use to make requests to the cluster.
+      def initialize(transport_client)
+        @transport_client = transport_client
+      end
+
+      private
+
+      # @return [Elasticsearch::API::Cluster::ClusterClient] The client used to
+      #   access cluster-related information.
+      def cluster_client
+        @cluster_client ||= transport_client.cluster
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/mixins/retriable_requests.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'elasticsearch/transport/transport/errors'
+
+require_relative '../../abstract/connection'
+
+module JayAPI
+  module Elasticsearch
+    module Mixins
+      # A mixin that allows the including class to retry requests to
+      # Elasticsearch by leveraging the +Abstract::Connection+ class'
+      # capabilities.
+      module RetriableRequests
+        # The errors that, if raised, must cause a retry of the connection.
+        RETRIABLE_ERRORS = [
+          ::Elasticsearch::Transport::Transport::ServerError,
+          Faraday::TimeoutError
+        ].freeze
+
+        # Subclasses of the +Elasticsearch::Transport::Transport::ServerError+
+        # for which a retry doesn't make sense.
+        NON_RETRIABLE_ERRORS = [
+          ::Elasticsearch::Transport::Transport::Errors::BadRequest,
+          ::Elasticsearch::Transport::Transport::Errors::Unauthorized,
+          ::Elasticsearch::Transport::Transport::Errors::Forbidden,
+          ::Elasticsearch::Transport::Transport::Errors::NotFound,
+          ::Elasticsearch::Transport::Transport::Errors::MethodNotAllowed,
+          ::Elasticsearch::Transport::Transport::Errors::RequestEntityTooLarge,
+          ::Elasticsearch::Transport::Transport::Errors::NotImplemented
+        ].freeze
+
+        # @return [Integer] The maximum number of times a request should be
+        #   retried before giving up.
+        def max_attempts
+          raise_not_implemented(__method__)
+        end
+
+        # @return [JayAPI::Elasticsearch::WaitStrategy] The waiting strategy for
+        #   retries.
+        def wait_strategy
+          raise_not_implemented(__method__)
+        end
+
+        # @return [Logging::Logger] A logger to log messages.
+        def logger
+          raise_not_implemented(__method__)
+        end
+
+        # @return [Array<Class>] The array of errors that, if raised, must cause
+        #   a retry of the request.
+        def retriable_errors
+          RETRIABLE_ERRORS
+        end
+
+        # @return [Array<Class>] An array of subclasses of the
+        #   +Elasticsearch::Transport::Transport::ServerError+ for which a retry
+        #   doesn't make sense.
+        def non_retriable_errors
+          NON_RETRIABLE_ERRORS
+        end
+
+        private
+
+        # Uses the +Abstract::Connection+ class to retry the request enclosed in
+        #   the given block.
+        def retry_request(&)
+          Abstract::Connection.new(max_attempts:, wait_strategy: wait_strategy.dup, logger:)
+                              .retry(errors: retriable_errors, except: non_retriable_errors, &)
+        end
+
+        # @raise [NotImplementedError] Is always raised with the appropriate
+        #   error message.
+        def raise_not_implemented(method)
+          raise NotImplementedError, "Please implement the method ##{method} in #{self.class}"
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/mixins.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'mixins/retriable_requests'
+
+module JayAPI
+  module Elasticsearch
+    # A namespace for Elasticsearch related mixins.
+    module Mixins; end
+  end
+end

data/lib/jay_api/elasticsearch/tasks.rb

@@ -1,22 +1,52 @@
 # frozen_string_literal: true
 
 require 'active_support'
+require 'active_support/core_ext/enumerable'
 require 'active_support/core_ext/hash/indifferent_access'
+require 'forwardable'
+
+require_relative 'mixins/retriable_requests'
 
 module JayAPI
   module Elasticsearch
     # Represents Elasticsearch tasks. Returns information about the tasks
     # currently executing in the cluster.
-    # TODO: Add #all [JAY-593]
     class Tasks
+      extend Forwardable
+      include ::JayAPI::Elasticsearch::Mixins::RetriableRequests
+
       attr_reader :client
 
+      def_delegators :client, :transport_client, :max_attempts, :wait_strategy, :logger
+
       # @param [JayAPI::Elasticsearch::Client] client The Elasticsearch Client
       #   object
       def initialize(client:)
         @client = client
       end
 
+      # Gets the list of tasks running on the Elasticsearch cluster.
+      # For more information about this endpoint and the parameters please see:
+      # https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-tasks-list
+      # @param [Array<String>] actions A list of actions. Only tasks matching
+      #   these actions will be returned, if no task matches the result will be
+      #   empty.
+      # @param [Boolean] detailed Whether or not the result should include task
+      #   details or not.
+      # @return [Hash] A hash with the list of tasks running on the
+      #   Elasticsearch cluster.
+      def all(actions: nil, detailed: false)
+        # Needed because unlike many Elasticsearch methods Tasks#list doesn't
+        # call #listify over +actions+.
+        actions = actions&.then do |value|
+          value.is_a?(Array) ? value.join(',') : value
+        end
+
+        retry_request do
+          tasks_client.list({ actions:, detailed: }.compact_blank)
+        end
+      end
+
       # Retrieves info about the task with the passed +task_id+
       # For more information on how to build the query please refer to the
       # Elasticsearch DSL documentation:
@@ -29,7 +59,17 @@ module JayAPI
       # @raise [Elasticsearch::Transport::Transport::ServerError] If the
       #   query fails.
       def by_id(task_id)
-        client.task_by_id(task_id: task_id, wait_for_completion: true).deep_symbolize_keys
+        retry_request do
+          tasks_client.get(task_id:, wait_for_completion: true).deep_symbolize_keys
+        end
+      end
+
+      private
+
+      # @return [Elasticsearch::API::Tasks::TasksClient] The client used to
+      #   access tasks-related information.
+      def tasks_client
+        @tasks_client ||= transport_client.tasks
       end
     end
   end

data/lib/jay_api/elasticsearch.rb

@@ -4,10 +4,12 @@ require_relative 'elasticsearch/async'
 require_relative 'elasticsearch/batch_counter'
 require_relative 'elasticsearch/client'
 require_relative 'elasticsearch/client_factory'
+require_relative 'elasticsearch/cluster'
 require_relative 'elasticsearch/errors'
 require_relative 'elasticsearch/index'
 require_relative 'elasticsearch/indexes'
 require_relative 'elasticsearch/indices'
+require_relative 'elasticsearch/mixins'
 require_relative 'elasticsearch/query_builder'
 require_relative 'elasticsearch/query_results'
 require_relative 'elasticsearch/response'

data/lib/jay_api/version.rb

@@ -2,5 +2,5 @@
 
 module JayAPI
   # JayAPI gem's semantic version
-  VERSION = '29.5.0'
+  VERSION = '29.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jay_api
 version: !ruby/object:Gem::Version
-  version: 29.5.0
+  version: 29.7.0
 platform: ruby
 authors:
 - Accenture-Industry X
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-23 00:00:00.000000000 Z
+date: 2026-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -121,6 +121,7 @@ files:
 - lib/jay_api/elasticsearch/batch_counter.rb
 - lib/jay_api/elasticsearch/client.rb
 - lib/jay_api/elasticsearch/client_factory.rb
+- lib/jay_api/elasticsearch/cluster.rb
 - lib/jay_api/elasticsearch/errors.rb
 - lib/jay_api/elasticsearch/errors/elasticsearch_error.rb
 - lib/jay_api/elasticsearch/errors/end_of_query_results_error.rb
@@ -135,6 +136,8 @@ files:
 - lib/jay_api/elasticsearch/indices.rb
 - lib/jay_api/elasticsearch/indices/settings.rb
 - lib/jay_api/elasticsearch/indices/settings/blocks.rb
+- lib/jay_api/elasticsearch/mixins.rb
+- lib/jay_api/elasticsearch/mixins/retriable_requests.rb
 - lib/jay_api/elasticsearch/query_builder.rb
 - lib/jay_api/elasticsearch/query_builder/aggregations.rb
 - lib/jay_api/elasticsearch/query_builder/aggregations/aggregation.rb
@@ -225,7 +228,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: A collection of classes and modules to access JAY's functionality