elasticsearch-api 7.6.0 → 7.9.0.pre

data/utils/thor/generator/endpoint_specifics.rb

@@ -1,8 +1,19 @@
-# frozen_string_literal: true
-
-# Licensed to Elasticsearch B.V under one or more agreements.
-# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
-# See the LICENSE file in the project root for more information
+# 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.
 
 module Elasticsearch
   module API
@@ -67,7 +78,7 @@ module Elasticsearch
       def module_name_helper(name)
         return name.upcase if %w[sql ssl].include? name
 
-        name.split("_").map(&:capitalize).join
+        name.split('_').map(&:capitalize).join
       end
 
       def termvectors_path
@@ -87,7 +98,7 @@ module Elasticsearch
       def ping_perform_request
         <<~SRC
           begin
-            perform_request(method, path, params, body).status == 200 ? true : false
+            perform_request(method, path, params, body, headers).status == 200 ? true : false
           rescue Exception => e
             if e.class.to_s =~ /NotFound|ConnectionFailed/ || e.message =~ /Not\s*Found|404|ConnectionFailed/i
               false
@@ -158,6 +169,13 @@ module Elasticsearch
           end
         SRC
       end
+
+      def bulk_doc_helper(info)
+        <<~SRC
+          # @option arguments [String|Array] :body #{info}. Array of Strings, Header/Data pairs,
+          # or the conveniency "combined" format can be passed, refer to Elasticsearch::API::Utils.__bulkify documentation.
+        SRC
+      end
     end
   end
 end

data/utils/thor/generator/files_helper.rb

@@ -1,4 +1,22 @@
+# 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 'pathname'
+require_relative '../../../lib/elasticsearch/api/version.rb'
 
 module Elasticsearch
   module API
@@ -32,6 +50,11 @@ module Elasticsearch
             File.extname(f) != '.json'
         end
       end
+
+      def self.gem_version
+        regex = /([0-9]{1,2}\.[0-9x]{1,2})/
+        Elasticsearch::API::VERSION.match(regex)[0]
+      end
     end
   end
 end

data/utils/thor/lister.rb

@@ -1,6 +1,19 @@
-# Licensed to Elasticsearch B.V under one or more agreements.
-# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
-# See the LICENSE file in the project root for more information
+# 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.
 
 # encoding: UTF-8
 

data/utils/thor/templates/_documentation_top.erb

@@ -12,8 +12,19 @@
 <%# URL parameters -%>
 <%- @params.each do |name, info| -%>
   <%= docs_helper(name, info) -%>
-<%- end %>
-<%= '  '*(@namespace_depth+3) + '# @option arguments [Hash] :body ' + (@spec['body']['description'] ? @spec['body']['description'].strip : 'TODO: Description') + (@spec['body']['required'] ? ' (*Required*)' : '') + "\n" if @spec['body'] -%>
+<%- end -%>
+# @option arguments [Hash] :headers Custom HTTP headers
+<%- if @spec['body'] -%>
+  <%- if @method_name == 'bulk' -%>
+    <%= bulk_doc_helper(@spec['body']['description']) -%>
+  <%- else -%>
+    <%= '  '*(@namespace_depth+1) +
+    '# @option arguments [Hash] :body ' + (@spec['body']['description'] ?
+                                           @spec['body']['description'].strip : 'TODO: Description') +
+                                           (@spec['body']['required'] ? ' (*Required*)' : '') + "\n"
+    -%>
+  <%- end -%>
+<%- end -%>
 <% if @deprecation_note -%>
   #
   # *Deprecation notice*:
@@ -23,5 +34,5 @@
 <% end -%>
 <%= '  '*(@namespace_depth+3) -%>#
 <%# Documentation link -%>
-<%=  '  '*(@namespace_depth+3) %># @see <%= @spec['documentation']['url'] ? @spec['documentation']['url'].gsub!(/\/(current|master)\//, '/7.5/') : "[TODO]" %>
+<%=  '  '*(@namespace_depth+3) %># @see <%= @spec['documentation']['url'] ? @spec['documentation']['url'].gsub(/\/(current|master)\//, "/#{Elasticsearch::API::FilesHelper.gem_version}/") : "[TODO]" %>
 <%= '  '*(@namespace_depth+3) %>#

data/utils/thor/templates/_perform_request.erb

@@ -16,22 +16,23 @@ when 'mtermvectors'
 <%- end -%>
 <%- if ['bulk', 'msearch', 'msearch_template'].include? @method_name -%>
   <%= self.send("#{@method_name}_body_helper".to_s) %>
-  <%= '  '*(@namespace_depth+4) %>perform_request(method, path, params, payload, {"Content-Type" => "application/x-ndjson"}).body
+  headers.merge!("Content-Type" => "application/x-ndjson")
+  <%= '  '*(@namespace_depth+4) %>perform_request(method, path, params, payload, headers).body
 <%- elsif @method_name == 'ping' -%>
   <%= ping_perform_request %>
 <%- else -%>
   <%- if needs_ignore_404?(@endpoint_name) %>
     <%= __utils %>.__rescue_from_not_found do
-      perform_request(method, path, params, body).status == 200 ? true : false
+      perform_request(method, path, params, body, headers).status == 200 ? true : false
     end
   <%- elsif needs_complex_ignore_404?(@endpoint_name) -%>
     if Array(arguments[:ignore]).include?(404)
-      <%= __utils %>.__rescue_from_not_found { perform_request(method, path, params, body).body }
+      <%= __utils %>.__rescue_from_not_found { perform_request(method, path, params, body, headers).body }
     else
-      perform_request(method, path, params, body).body
+      perform_request(method, path, params, body, headers).body
     end
   <%- else -%>
-      perform_request(method, path, params, body).body
+      perform_request(method, path, params, body, headers).body
   <%- end -%>
 <%- end -%>
 <%= '  '*(@namespace_depth+3) %>end

data/utils/thor/templates/method.erb

@@ -1,6 +1,19 @@
-# Licensed to Elasticsearch B.V under one or more agreements.
-# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
-# See the LICENSE file in the project root for more information
+# 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.
 
 module Elasticsearch
 <%- if @current_api == :xpack -%>
@@ -13,7 +26,7 @@ module Elasticsearch
 <%= '  '*(@namespace_depth+2) %>module Actions
 <%= ERB.new(File.new("./thor/templates/_documentation_top.erb").read, trim_mode: '-').result(binding) -%>
 <%# Method definition -%>
-<%= '  '*(@namespace_depth+3) -%>def <%= @method_name %>(arguments={})
+<%= '  '*(@namespace_depth+3) -%>def <%= @method_name %>(arguments = {})
 <%- if @endpoint_name == 'create' -%>
   <%= '  '*(@namespace_depth+3) %>if arguments[:id]
   <%= '  '*(@namespace_depth+3) %>  index arguments.update op_type: 'create'
@@ -30,6 +43,7 @@ module Elasticsearch
       <%= '  '*(@namespace_depth+3) + "raise ArgumentError, \"Required argument '#{required}' missing\" unless arguments[:#{required}]" + "\n" -%>
     <%- end -%>
     <%- end -%>
+    headers = arguments.delete(:headers) || {}
     <%- # Method setup -%>
     <%= ERB.new(File.new("./thor/templates/_method_setup.erb").read, trim_mode: '-').result(binding) %>
     <%- # Perform request -%>

data/utils/thor/templates/test_helper.rb

@@ -1,6 +1,19 @@
-# Licensed to Elasticsearch B.V under one or more agreements.
-# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
-# See the LICENSE file in the project root for more information
+# 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.
 
 RUBY_1_8 = defined?(RUBY_VERSION) && RUBY_VERSION < '1.9'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elasticsearch-api
 version: !ruby/object:Gem::Version
-  version: 7.6.0
+  version: 7.9.0.pre
 platform: ruby
 authors:
 - Karel Minarik
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-07 00:00:00.000000000 Z
+date: 2020-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -383,10 +383,16 @@ files:
 - lib/elasticsearch/api/actions/cat/thread_pool.rb
 - lib/elasticsearch/api/actions/clear_scroll.rb
 - lib/elasticsearch/api/actions/cluster/allocation_explain.rb
+- lib/elasticsearch/api/actions/cluster/delete_component_template.rb
+- lib/elasticsearch/api/actions/cluster/delete_voting_config_exclusions.rb
+- lib/elasticsearch/api/actions/cluster/exists_component_template.rb
+- lib/elasticsearch/api/actions/cluster/get_component_template.rb
 - lib/elasticsearch/api/actions/cluster/get_settings.rb
 - lib/elasticsearch/api/actions/cluster/health.rb
 - lib/elasticsearch/api/actions/cluster/params_registry.rb
 - lib/elasticsearch/api/actions/cluster/pending_tasks.rb
+- lib/elasticsearch/api/actions/cluster/post_voting_config_exclusions.rb
+- lib/elasticsearch/api/actions/cluster/put_component_template.rb
 - lib/elasticsearch/api/actions/cluster/put_settings.rb
 - lib/elasticsearch/api/actions/cluster/remote_info.rb
 - lib/elasticsearch/api/actions/cluster/reroute.rb
@@ -394,6 +400,10 @@ files:
 - lib/elasticsearch/api/actions/cluster/stats.rb
 - lib/elasticsearch/api/actions/count.rb
 - lib/elasticsearch/api/actions/create.rb
+- lib/elasticsearch/api/actions/dangling_indices/delete_dangling_index.rb
+- lib/elasticsearch/api/actions/dangling_indices/import_dangling_index.rb
+- lib/elasticsearch/api/actions/dangling_indices/list_dangling_indices.rb
+- lib/elasticsearch/api/actions/dangling_indices/params_registry.rb
 - lib/elasticsearch/api/actions/delete.rb
 - lib/elasticsearch/api/actions/delete_by_query.rb
 - lib/elasticsearch/api/actions/delete_by_query_rethrottle.rb
@@ -409,16 +419,22 @@ files:
 - lib/elasticsearch/api/actions/get_script_languages.rb
 - lib/elasticsearch/api/actions/get_source.rb
 - lib/elasticsearch/api/actions/index.rb
+- lib/elasticsearch/api/actions/indices/add_block.rb
 - lib/elasticsearch/api/actions/indices/analyze.rb
 - lib/elasticsearch/api/actions/indices/clear_cache.rb
 - lib/elasticsearch/api/actions/indices/clone.rb
 - lib/elasticsearch/api/actions/indices/close.rb
 - lib/elasticsearch/api/actions/indices/create.rb
+- lib/elasticsearch/api/actions/indices/create_data_stream.rb
+- lib/elasticsearch/api/actions/indices/data_streams_stats.rb
 - lib/elasticsearch/api/actions/indices/delete.rb
 - lib/elasticsearch/api/actions/indices/delete_alias.rb
+- lib/elasticsearch/api/actions/indices/delete_data_stream.rb
+- lib/elasticsearch/api/actions/indices/delete_index_template.rb
 - lib/elasticsearch/api/actions/indices/delete_template.rb
 - lib/elasticsearch/api/actions/indices/exists.rb
 - lib/elasticsearch/api/actions/indices/exists_alias.rb
+- lib/elasticsearch/api/actions/indices/exists_index_template.rb
 - lib/elasticsearch/api/actions/indices/exists_template.rb
 - lib/elasticsearch/api/actions/indices/exists_type.rb
 - lib/elasticsearch/api/actions/indices/flush.rb
@@ -427,7 +443,9 @@ files:
 - lib/elasticsearch/api/actions/indices/freeze.rb
 - lib/elasticsearch/api/actions/indices/get.rb
 - lib/elasticsearch/api/actions/indices/get_alias.rb
+- lib/elasticsearch/api/actions/indices/get_data_stream.rb
 - lib/elasticsearch/api/actions/indices/get_field_mapping.rb
+- lib/elasticsearch/api/actions/indices/get_index_template.rb
 - lib/elasticsearch/api/actions/indices/get_mapping.rb
 - lib/elasticsearch/api/actions/indices/get_settings.rb
 - lib/elasticsearch/api/actions/indices/get_template.rb
@@ -435,15 +453,19 @@ files:
 - lib/elasticsearch/api/actions/indices/open.rb
 - lib/elasticsearch/api/actions/indices/params_registry.rb
 - lib/elasticsearch/api/actions/indices/put_alias.rb
+- lib/elasticsearch/api/actions/indices/put_index_template.rb
 - lib/elasticsearch/api/actions/indices/put_mapping.rb
 - lib/elasticsearch/api/actions/indices/put_settings.rb
 - lib/elasticsearch/api/actions/indices/put_template.rb
 - lib/elasticsearch/api/actions/indices/recovery.rb
 - lib/elasticsearch/api/actions/indices/refresh.rb
+- lib/elasticsearch/api/actions/indices/resolve_index.rb
 - lib/elasticsearch/api/actions/indices/rollover.rb
 - lib/elasticsearch/api/actions/indices/segments.rb
 - lib/elasticsearch/api/actions/indices/shard_stores.rb
 - lib/elasticsearch/api/actions/indices/shrink.rb
+- lib/elasticsearch/api/actions/indices/simulate_index_template.rb
+- lib/elasticsearch/api/actions/indices/simulate_template.rb
 - lib/elasticsearch/api/actions/indices/split.rb
 - lib/elasticsearch/api/actions/indices/stats.rb
 - lib/elasticsearch/api/actions/indices/unfreeze.rb
@@ -503,6 +525,7 @@ files:
 - lib/elasticsearch/api/namespace/cat.rb
 - lib/elasticsearch/api/namespace/cluster.rb
 - lib/elasticsearch/api/namespace/common.rb
+- lib/elasticsearch/api/namespace/dangling_indices.rb
 - lib/elasticsearch/api/namespace/indices.rb
 - lib/elasticsearch/api/namespace/ingest.rb
 - lib/elasticsearch/api/namespace/nodes.rb
@@ -511,7 +534,6 @@ files:
 - lib/elasticsearch/api/namespace/tasks.rb
 - lib/elasticsearch/api/utils.rb
 - lib/elasticsearch/api/version.rb
-- spec/README.md
 - spec/elasticsearch/api/actions/abort_benchmark_spec.rb
 - spec/elasticsearch/api/actions/benchmark_spec.rb
 - spec/elasticsearch/api/actions/bulk_spec.rb
@@ -547,6 +569,9 @@ files:
 - spec/elasticsearch/api/actions/cluster/stats_spec.rb
 - spec/elasticsearch/api/actions/count_spec.rb
 - spec/elasticsearch/api/actions/create_document_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/delete_dangling_indices_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/import_dangling_indices_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/list_dangling_indices_spec.rb
 - spec/elasticsearch/api/actions/delete_by_query_spec.rb
 - spec/elasticsearch/api/actions/delete_document_spec.rb
 - spec/elasticsearch/api/actions/delete_script_spec.rb
@@ -558,11 +583,13 @@ files:
 - spec/elasticsearch/api/actions/get_script_spec.rb
 - spec/elasticsearch/api/actions/hashie_spec.rb
 - spec/elasticsearch/api/actions/index_document_spec.rb
+- spec/elasticsearch/api/actions/indices/add_block_spec.rb
 - spec/elasticsearch/api/actions/indices/analyze_spec.rb
 - spec/elasticsearch/api/actions/indices/clear_cache_spec.rb
 - spec/elasticsearch/api/actions/indices/clone_spec.rb
 - spec/elasticsearch/api/actions/indices/close_spec.rb
 - spec/elasticsearch/api/actions/indices/create_spec.rb
+- spec/elasticsearch/api/actions/indices/data_streams_stats_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_alias_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_template_spec.rb
@@ -641,11 +668,10 @@ files:
 - spec/elasticsearch/api/utils_spec.rb
 - spec/rest_yaml_tests_helper.rb
 - spec/spec_helper.rb
-- test/integration/yaml_test_runner.rb
-- test/test_helper.rb
 - utils/Gemfile
 - utils/README.md
 - utils/Thorfile
+- utils/thor/.rubocop.yml
 - utils/thor/generate_source.rb
 - utils/thor/generator/endpoint_specifics.rb
 - utils/thor/generator/files_helper.rb
@@ -657,10 +683,14 @@ files:
 - utils/thor/templates/method.erb
 - utils/thor/templates/test.erb
 - utils/thor/templates/test_helper.rb
-homepage: https://github.com/elasticsearch/elasticsearch-ruby/tree/master/elasticsearch-api
+homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.x/index.html
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  homepage_uri: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.x/index.html
+  changelog_uri: https://github.com/elastic/elasticsearch-ruby/blob/7.x/CHANGELOG.md
+  source_code_uri: https://github.com/elastic/elasticsearch-ruby/tree/7.x/elasticsearch-api
+  bug_tracker_uri: https://github.com/elastic/elasticsearch-ruby/issues
 post_install_message: 
 rdoc_options:
 - "--charset=UTF-8"
@@ -673,16 +703,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Ruby API for Elasticsearch.
 test_files:
-- spec/README.md
 - spec/elasticsearch/api/actions/abort_benchmark_spec.rb
 - spec/elasticsearch/api/actions/benchmark_spec.rb
 - spec/elasticsearch/api/actions/bulk_spec.rb
@@ -718,6 +747,9 @@ test_files:
 - spec/elasticsearch/api/actions/cluster/stats_spec.rb
 - spec/elasticsearch/api/actions/count_spec.rb
 - spec/elasticsearch/api/actions/create_document_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/delete_dangling_indices_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/import_dangling_indices_spec.rb
+- spec/elasticsearch/api/actions/dangling_indices/list_dangling_indices_spec.rb
 - spec/elasticsearch/api/actions/delete_by_query_spec.rb
 - spec/elasticsearch/api/actions/delete_document_spec.rb
 - spec/elasticsearch/api/actions/delete_script_spec.rb
@@ -729,11 +761,13 @@ test_files:
 - spec/elasticsearch/api/actions/get_script_spec.rb
 - spec/elasticsearch/api/actions/hashie_spec.rb
 - spec/elasticsearch/api/actions/index_document_spec.rb
+- spec/elasticsearch/api/actions/indices/add_block_spec.rb
 - spec/elasticsearch/api/actions/indices/analyze_spec.rb
 - spec/elasticsearch/api/actions/indices/clear_cache_spec.rb
 - spec/elasticsearch/api/actions/indices/clone_spec.rb
 - spec/elasticsearch/api/actions/indices/close_spec.rb
 - spec/elasticsearch/api/actions/indices/create_spec.rb
+- spec/elasticsearch/api/actions/indices/data_streams_stats_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_alias_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_spec.rb
 - spec/elasticsearch/api/actions/indices/delete_template_spec.rb
@@ -812,5 +846,3 @@ test_files:
 - spec/elasticsearch/api/utils_spec.rb
 - spec/rest_yaml_tests_helper.rb
 - spec/spec_helper.rb
-- test/integration/yaml_test_runner.rb
-- test/test_helper.rb

data/spec/README.md

@@ -1,61 +0,0 @@
-# Rest API YAML Spec Runner
-
-The file that traverses the yaml files and loads a **TestFile** object per each of them:
-`elasticsearch-api/spec/elasticsearch/api/rest_api_yaml_spec.rb`
-
-You can use the SINGLE_TEST env variable to run just one test, or add code like this on the first line of the tests.each block:  
-```ruby
-next unless file =~ /indices.put_mapping\/all_path_options_with_types.yml/
-```
-
-#### TestFile object
-Class representing a single test file. Contains setup, teardown and tests.   
-`../api-spec-testing/test_file.rb`
-
-#### Test object
-Every single test in the test file is represented in the Test object.   
-`../api-spec-testing/test_file/test.rb`
-
-#### TaskGroup objects
-
-Tests are ordered in task groups, an array of TaskGroup objects.  
-`../api-spec-testing/test_file/task_group.rb`  
-
-Task Groups are a representation of a block of actions consisting of 'do' actions and their verifications. e.g.: 
-```yaml
- - do:
-      index:
-          index:  test-index
-          id:     1
-          body:   { foo: bar }
-
- - match:   { _index:   test-index }
- - match:   { _id:      "1"}
- - match:   { _version: 1}
-```
-
-**Before** each test, the spec runner runs `clear_data` on the test_file. This clears indices, index templates, snapshots and repositories. For xpack it also clears roles, users, privileges, datafeeds, ml_jobs and more.
-
-**After** each test, it runs the test file teardown and `clear_data` again.
-
-For each TaskGroup, it sees what's in the task group definition and runs an expectation test.
-
-# Rest YAML tests Helper
-
-`elasticsearch-api/spec/rest_yaml_tests_helper.rb`
-
-- `ADMIN_CLIENT` is defined here.
-- `SINGLE_TEST` is defined here.
-- Skipped tests are listed here
-
-# Spec Helper
-
-- `DEFAULT_CLIENT` is defined here
-
-# RSpec Matchers
-
-The tests use custom [RSpec Matchers](https://www.rubydoc.info/gems/rspec-expectations/RSpec/Matchers) defined in `api-spec-testing/rspec_matchers.rb`.
-
-# Enable Logging
-
-To enable logging, set the environment `QUIET` to false before running the tests. In CI, this is located in the [Dockerfile](https://github.com/elastic/elasticsearch-ruby/blob/master/.ci/Dockerfile). The environment variable is evaluated in the Rest YAML tests Helper file.