elasticsearch-api 8.3.0 → 8.4.0

data/lib/elasticsearch/api/actions/transform/upgrade_transforms.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -28,7 +28,7 @@ module Elasticsearch
         # @option arguments [Time] :timeout Controls the time to wait for the upgrade
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/upgrade-transforms.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/upgrade-transforms.html
         #
         def upgrade_transforms(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/update.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -40,7 +40,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body The request definition requires either `script` or partial `doc` (*Required*)
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/docs-update.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update.html
       #
       def update(arguments = {})
         raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]

data/lib/elasticsearch/api/actions/update_by_query.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -59,7 +59,7 @@ module Elasticsearch
       # @option arguments [Hash] :headers Custom HTTP headers
       # @option arguments [Hash] :body The search definition using the Query DSL
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/docs-update-by-query.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update-by-query.html
       #
       def update_by_query(arguments = {})
         raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]

data/lib/elasticsearch/api/actions/update_by_query_rethrottle.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
       # @option arguments [Number] :requests_per_second The throttle to set on this request in floating sub-requests per second. -1 means set no throttle. (*Required*)
       # @option arguments [Hash] :headers Custom HTTP headers
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/docs-update-by-query.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update-by-query.html
       #
       def update_by_query_rethrottle(arguments = {})
         raise ArgumentError, "Required argument 'task_id' missing" unless arguments[:task_id]

data/lib/elasticsearch/api/actions/watcher/ack_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -28,7 +28,7 @@ module Elasticsearch
         # @option arguments [List] :action_id A comma-separated list of the action ids to be acked
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-ack-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-ack-watch.html
         #
         def ack_watch(arguments = {})
           raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/api/actions/watcher/activate_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [String] :watch_id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-activate-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-activate-watch.html
         #
         def activate_watch(arguments = {})
           raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/api/actions/watcher/deactivate_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [String] :watch_id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-deactivate-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-deactivate-watch.html
         #
         def deactivate_watch(arguments = {})
           raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/api/actions/watcher/delete_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [String] :id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-delete-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-delete-watch.html
         #
         def delete_watch(arguments = {})
           raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]

data/lib/elasticsearch/api/actions/watcher/execute_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -29,7 +29,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Execution control
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-execute-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-execute-watch.html
         #
         def execute_watch(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/watcher/get_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [String] :id Watch ID
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-get-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-get-watch.html
         #
         def get_watch(arguments = {})
           raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]

data/lib/elasticsearch/api/actions/watcher/put_watch.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -32,7 +32,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body The watch
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-put-watch.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-put-watch.html
         #
         def put_watch(arguments = {})
           raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]

data/lib/elasticsearch/api/actions/watcher/query_watches.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body From, size, query, sort and search_after
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-query-watches.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-query-watches.html
         #
         def query_watches(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/watcher/start.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -26,7 +26,7 @@ module Elasticsearch
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-start.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-start.html
         #
         def start(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/watcher/stats.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -28,7 +28,7 @@ module Elasticsearch
         # @option arguments [Boolean] :emit_stacktraces Emits stack traces of currently running watches
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-stats.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-stats.html
         #
         def stats(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/watcher/stop.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -26,7 +26,7 @@ module Elasticsearch
         #
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/watcher-api-stop.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api-stop.html
         #
         def stop(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/xpack/info.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -28,7 +28,7 @@ module Elasticsearch
         # @option arguments [Boolean] :accept_enterprise If this param is used it must be set to true *Deprecated*
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/info-api.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/info-api.html
         #
         def info(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/actions/xpack/usage.rb

@@ -15,7 +15,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-# Auto generated from build hash 7faba7ad1bfe9ef9b821e7bca858346ca80e6030
+# Auto generated from build hash f284cc16f4d4b4289bc679aa1529bb504190fe80
 # @see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec
 #
 module Elasticsearch
@@ -27,7 +27,7 @@ module Elasticsearch
         # @option arguments [Time] :master_timeout Specify timeout for watch write operation
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.3/usage-api.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/usage-api.html
         #
         def usage(arguments = {})
           arguments = arguments.clone

data/lib/elasticsearch/api/version.rb

@@ -17,6 +17,6 @@
 
 module Elasticsearch
   module API
-    VERSION = '8.3.0'.freeze
+    VERSION = '8.4.0'.freeze
   end
 end

data/spec/elasticsearch/api/actions/security/update_api_key_spec.rb

@@ -0,0 +1,34 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require 'spec_helper'
+
+describe 'client#security#update_api_key' do
+  let(:expected_args) do
+    [
+      'PUT',
+      '_security/api_key/foo',
+      {},
+      nil,
+      {}
+    ]
+  end
+
+  it 'performs the request' do
+    expect(client_double.security.update_api_key(id: 'foo')).to be_a Elasticsearch::API::Response
+  end
+end

data/spec/elasticsearch/api/rest_api_yaml_spec.rb

@@ -17,9 +17,11 @@
 
 require 'spec_helper'
 require 'rest_api_tests_helper'
+require_relative './run_rspec_matchers'
+
+LOGGER = Logger.new($stdout)
 
 describe 'Rest API YAML tests' do
-  LOGGER = Logger.new($stdout)
   if REST_API_YAML_FILES.empty?
     LOGGER.error 'No test files found!'
     LOGGER.info 'Use rake rake elasticsearch:download_artifacts in the root directory of the project to download the test artifacts.'
@@ -37,8 +39,7 @@ describe 'Rest API YAML tests' do
       next
     end
 
-    ctx = file.gsub("#{YAML_FILES_DIRECTORY}/", '')
-    context ctx do
+    context file.gsub("#{YAML_FILES_DIRECTORY}/", '') do
       let(:client) { DEFAULT_CLIENT }
 
       test_file.tests.each do |test|
@@ -59,98 +60,8 @@ describe 'Rest API YAML tests' do
               task_group.run(client)
             end
 
-            # 'catch' is in the task group definition
-            if task_group.catch_exception?
-              it 'sends the request and throws the expected error' do
-                expect(task_group.exception).to match_error(task_group.expected_exception_message)
-              end
-
-              # 'match' on error description is in the task group definition
-              if task_group.has_match_clauses?
-                task_group.match_clauses.each do |match|
-                  it 'contains the expected error in the request response' do
-                    regexp = if (val = match['match'].values.first.to_s).include?('\\s')
-                               Regexp.new(val.gsub('\\\\', '\\').gsub('/', ''))
-                             else
-                               Regexp.new(Regexp.escape(val))
-                             end
-                    expect(task_group.exception.message).to match(regexp)
-                  end
-                end
-              end
-            else
-              # 'match' is in the task group definition
-              if task_group.has_match_clauses?
-                task_group.match_clauses.each do |match|
-                  it "has the expected value (#{match['match'].values.join(',')}) in the response field (#{match['match'].keys.join(',')})" do
-                    expect(task_group.response).to match_response(match['match'], test)
-                  end
-                end
-              end
-
-              # 'length' is in the task group definition
-              if task_group.has_length_match_clauses?
-                task_group.length_match_clauses.each do |match|
-                  it "the '#{match['length'].keys.join(',')}' field have the expected length" do
-                    expect(task_group.response).to match_response_field_length(match['length'], test)
-                  end
-                end
-              end
-
-              # 'is_true' is in the task group definition
-              if task_group.has_true_clauses?
-                task_group.true_clauses.each do |match|
-                  it "sends the request and the '#{match['is_true']}' field is set to true" do
-                    expect(task_group.response).to match_true_field(match['is_true'], test)
-                  end
-                end
-              end
-
-              # 'is_false' is in the task group definition
-              if task_group.has_false_clauses?
-                task_group.false_clauses.each do |match|
-                  it "sends the request and the '#{match['is_false']}' field is set to true" do
-                    expect(task_group.response).to match_false_field(match['is_false'], test)
-                  end
-                end
-              end
-
-              # 'gte' is in the task group definition
-              if task_group.has_gte_clauses?
-                task_group.gte_clauses.each do |match|
-                  it "sends the request and the '#{match['gte']}' field is greater than or equal to the expected value" do
-                    expect(task_group.response).to match_gte_field(match['gte'], test)
-                  end
-                end
-              end
-
-              # 'gt' is in the task group definition
-              if task_group.has_gt_clauses?
-                task_group.gt_clauses.each do |match|
-                  it "sends the request and the '#{match['gt']}' field is greater than the expected value" do
-                    expect(task_group.response).to match_gt_field(match['gt'], test)
-                  end
-                end
-              end
-
-              # 'lte' is in the task group definition
-              if task_group.has_lte_clauses?
-                task_group.lte_clauses.each do |match|
-                  it "sends the request and the '#{match['lte']}' field is less than or equal to the expected value" do
-                    expect(task_group.response).to match_lte_field(match['lte'], test)
-                  end
-                end
-              end
-
-              # 'lt' is in the task group definition
-              if task_group.has_lt_clauses?
-                task_group.lt_clauses.each do |match|
-                  it "sends the request and the '#{match['lt']}' field is less than the expected value" do
-                    expect(task_group.response).to match_lt_field(match['lt'], test)
-                  end
-                end
-              end
-            end
+            # ./run_task_groups.rb
+            run_rspec_matchers_on_task_group(task_group, test)
           end
         end
       end

data/spec/elasticsearch/api/run_rspec_matchers.rb

@@ -0,0 +1,111 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# 'catch' is in the task group definition
+def run_rspec_matchers_on_task_group(task_group, test)
+  if task_group.catch_exception?
+    it 'sends the request and throws the expected error' do
+      expect(task_group.exception).to match_error(task_group.expected_exception_message)
+    end
+
+    # 'match' on error description is in the task group definition
+    if task_group.has_match_clauses?
+      task_group.match_clauses.each do |match|
+        it 'contains the expected error in the request response' do
+          regexp = if (val = match['match'].values.first.to_s).include?('\\s')
+                     Regexp.new(val.gsub('\\\\', '\\').gsub('/', ''))
+                   else
+                     Regexp.new(Regexp.escape(val))
+                   end
+          expect(task_group.exception.message).to match(regexp)
+        end
+      end
+    end
+  else
+    # 'match' is in the task group definition
+    if task_group.has_match_clauses?
+      task_group.match_clauses.each do |match|
+        it "has the expected value (#{match['match'].values.join(',')}) in the response field (#{match['match'].keys.join(',')})" do
+          expect(task_group.response).to match_response(match['match'], test)
+        end
+      end
+    end
+
+    # 'length' is in the task group definition
+    if task_group.has_length_match_clauses?
+      task_group.length_match_clauses.each do |match|
+        it "the '#{match['length'].keys.join(',')}' field have the expected length" do
+          expect(task_group.response).to match_response_field_length(match['length'], test)
+        end
+      end
+    end
+
+    # 'is_true' is in the task group definition
+    if task_group.has_true_clauses?
+      task_group.true_clauses.each do |match|
+        it "sends the request and the '#{match['is_true']}' field is set to true" do
+          expect(task_group.response).to match_true_field(match['is_true'], test)
+        end
+      end
+    end
+
+    # 'is_false' is in the task group definition
+    if task_group.has_false_clauses?
+      task_group.false_clauses.each do |match|
+        it "sends the request and the '#{match['is_false']}' field is set to true" do
+          expect(task_group.response).to match_false_field(match['is_false'], test)
+        end
+      end
+    end
+
+    # 'gte' is in the task group definition
+    if task_group.has_gte_clauses?
+      task_group.gte_clauses.each do |match|
+        it "sends the request and the '#{match['gte']}' field is greater than or equal to the expected value" do
+          expect(task_group.response).to match_gte_field(match['gte'], test)
+        end
+      end
+    end
+
+    # 'gt' is in the task group definition
+    if task_group.has_gt_clauses?
+      task_group.gt_clauses.each do |match|
+        it "sends the request and the '#{match['gt']}' field is greater than the expected value" do
+          expect(task_group.response).to match_gt_field(match['gt'], test)
+        end
+      end
+    end
+
+    # 'lte' is in the task group definition
+    if task_group.has_lte_clauses?
+      task_group.lte_clauses.each do |match|
+        it "sends the request and the '#{match['lte']}' field is less than or equal to the expected value" do
+          expect(task_group.response).to match_lte_field(match['lte'], test)
+        end
+      end
+    end
+
+    # 'lt' is in the task group definition
+    if task_group.has_lt_clauses?
+      task_group.lt_clauses.each do |match|
+        it "sends the request and the '#{match['lt']}' field is less than the expected value" do
+          expect(task_group.response).to match_lt_field(match['lt'], test)
+        end
+      end
+    end
+  end
+end

data/utils/README.md

@@ -24,6 +24,11 @@ $ thor code:generate
 $ IGNORE_VERSION=true thor code:generate
 ```
 
+- You can use the environment variable `BUILD_HASH` to update the build hash for the generated code from the `tmp/rest-api-spec/build_hash` file. This file is updated every time you use the `elasticsearch:download_artifacts` Rake task is used in the root of the project to download the latest Elasticsearch specs and tests:
+```bash
+$ BUILD_HASH=true thor code:generate
+```
+
 ### Development
 
 The main entry point is `generate_source.rb`, which contains a class that implements a Thor task: `generate`:

data/utils/thor/generate_source.rb

@@ -47,7 +47,12 @@ module Elasticsearch
       method_option :tests,   type: :boolean, default: false,  desc: 'Generate test files'
 
       def generate
-        @build_hash = File.read(File.expand_path('../../../tmp/rest-api-spec/build_hash',__dir__))
+        @build_hash = if ENV['BUILD_HASH']
+                        File.read(File.expand_path('../../../tmp/rest-api-spec/build_hash',__dir__))
+                      else
+                        original_build_hash
+                      end
+
         self.class.source_root File.expand_path(__dir__)
         generate_source
         # -- Tree output
@@ -103,6 +108,33 @@ module Elasticsearch
         end
 
         run_rubocop
+        add_hash
+      end
+
+      def add_hash
+        Dir.glob("#{FilesHelper.output_dir}/**/*.rb").each do |file|
+          content = File.read(file)
+          new_content = content.gsub(/(^#\sunder\sthe\sLicense.\n#)/) do |_|
+            match = Regexp.last_match
+            "#{match[1]}\n#{build_hash_comment}"
+          end
+          File.open(file, 'w') { |f| f.puts new_content }
+        end
+      end
+
+      def build_hash_comment
+        [
+          "Auto generated from build hash #{@build_hash}",
+          '@see https://github.com/elastic/elasticsearch/tree/main/rest-api-spec',
+          ''
+        ].map { |b| "# #{b}" }.join("\n").strip
+      end
+
+      def original_build_hash
+        content = File.read("#{FilesHelper.output_dir}/info.rb")
+        return unless (match = content.match(/Auto generated from build hash ([a-f0-9]+)/))
+
+        match[1]
       end
 
       def __full_namespace