elasticsearch-api 7.3.0 → 7.5.0

data/utils/thor/templates/_method_setup.erb

@@ -0,0 +1,35 @@
+<%- if @endpoint_name == 'indices.stats' %>
+  method = HTTP_GET
+  parts  = Utils.__extract_parts arguments, ParamsRegistry.get(:stats_parts)
+  path   = Utils.__pathify Utils.__listify(arguments[:index]), '_stats', Utils.__listify(parts)
+  params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(:stats_params)
+  params[:fields] = Utils.__listify(params[:fields], :escape => false) if params[:fields]
+  params[:groups] = Utils.__listify(params[:groups], :escape => false) if params[:groups]
+<%- else %>
+  <%= '  '*(@namespace_depth+4) %>arguments = arguments.clone
+  <%- if @method_name == 'mtermvectors' -%>
+    ids = arguments.delete(:ids)
+  <%- end -%>
+  <%- if @method_name == 'search' -%>
+    arguments[:index] = UNDERSCORE_ALL if ! arguments[:index] && arguments[:type]
+  <%- end -%>
+  <%- @parts.each do |name, _| %>
+    <%- unless @method_name == 'get_field_mapping' && name == 'fields' %>
+      <%= '  '*(@namespace_depth+3) + "_#{name}" %> = arguments.delete(:<%=name %>)
+    <%- end -%>
+  <%- end -%>
+
+  <%= '  '*(@namespace_depth+4) %>method = <%= @http_method %>
+  <%- if @method_name == 'termvectors' %>
+    endpoint = arguments.delete(:endpoint) || '_termvectors'
+  <%- end -%>
+  <%= '  '*(@namespace_depth+4) %>path   = <%= @http_path %>
+  <%- unless @params.empty? -%>
+    <%= '  '*(@namespace_depth+4) %>params = <%= __utils %>.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+  <%- else -%>
+    <%= '  '*(@namespace_depth+4) %>params = {}
+  <%- end -%>
+  <%- @specific_params.each do |param| -%>
+    <%= param %>
+  <%- end -%>
+<%- end -%>

data/utils/thor/templates/_params_registry.erb

@@ -0,0 +1,12 @@
+<%- unless @params.empty? -%>
+  <%= '  '*(@namespace_depth+3) %># Register this action with its valid params when the module is loaded.
+  <%= '  '*(@namespace_depth+3) %>#
+  <%= '  '*(@namespace_depth+3) %># @since 6.2.0
+  <%- if @endpoint_name == 'indices.stats' -%>
+    <%= indices_stats_params_registry %>
+  <%- else -%>
+    <%= '  '*(@namespace_depth+3) %>ParamsRegistry.register(:<%= @method_name %>, [
+    <%= '  '*(@namespace_depth+4) %><%= @params.keys.map { |k| ":#{k}" }.join(",\n#{'  '*(@namespace_depth+4)}") %>
+    <%= '  '*(@namespace_depth+3) %>].freeze)
+  <%- end -%>
+<%- end -%>

data/utils/thor/templates/_perform_request.erb

@@ -0,0 +1,37 @@
+<%-
+case @endpoint_name
+when 'mtermvectors'
+-%>
+  if ids
+    body = { :ids => ids }
+  else
+    body = arguments[:body]
+  end
+<%- when 'cluster.reroute', 'cluster.put_settings' %>
+  body = arguments[:body] || {}
+<%- when 'ml.find_file_structure' %>
+  body = <%= __utils %>.__bulkify(arguments.delete(:body))
+<%- else -%>
+  <%= '  '*(@namespace_depth+3) %>body   = <%= @spec['body'].nil? ? 'nil' : 'arguments[:body]' %>
+<%- 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
+<%- 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
+    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 }
+    else
+      perform_request(method, path, params, body).body
+    end
+  <%- else -%>
+      perform_request(method, path, params, body).body
+  <%- end -%>
+<%- end -%>
+<%= '  '*(@namespace_depth+3) %>end

data/utils/thor/templates/method.erb

@@ -0,0 +1,59 @@
+# 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
+
+module Elasticsearch
+<%- if @xpack -%>
+  <%= '  '*(@namespace_depth) %>module XPack
+<%- end %>
+<%= '  '*(@namespace_depth) %>module API
+<%- @module_namespace.each_with_index do |name, i| -%>
+  <%= '  '*i %>module <%= name.split("_").map(&:capitalize).join %>
+<%- end -%>
+<%= '  '*(@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={})
+<%- if @endpoint_name == 'create' -%>
+  <%= '  '*(@namespace_depth+3) %>if arguments[:id]
+  <%= '  '*(@namespace_depth+3) %>  index arguments.update op_type: 'create'
+  <%= '  '*(@namespace_depth+3) %>else
+  <%= '  '*(@namespace_depth+3) %>  index arguments
+  <%= '  '*(@namespace_depth+3) %>end
+  <%= '  '*(@namespace_depth+2) %>end
+<%- else -%>
+  <%- if @method_name == 'get_field_mapping' %>
+    _fields = arguments.delete(:field) || arguments.delete(:fields)
+    raise ArgumentError, "Required argument 'field' missing" unless _fields
+  <%- else -%>
+    <%- @required_parts.each do |required| %><%# Arguments -%>
+      <%= '  '*(@namespace_depth+3) + "raise ArgumentError, \"Required argument '#{required}' missing\" unless arguments[:#{required}]" + "\n" -%>
+    <%- end -%>
+    <%- end -%>
+    <%- # Method setup -%>
+    <%= ERB.new(File.new("./thor/templates/_method_setup.erb").read, trim_mode: '-').result(binding) %>
+    <%- # Perform request -%>
+    <%= ERB.new(File.new("./thor/templates/_perform_request.erb").read, trim_mode: '-').result(binding) %>
+<%- end -%>
+<%- if @method_name.match?(/^exists\S*/) -%>
+  alias_method :<%= @method_name %>?, :<%= @method_name %>
+<%- end -%>
+<%- if @method_name == 'termvectors' %>
+
+  # Deprecated: Use the plural version, {#termvectors}
+  #
+  def termvector(arguments={})
+    termvectors(arguments.merge endpoint: '_termvector')
+  end
+<%- end -%>
+<%# Params Registry Template -%>
+<%- unless @endpoint_name == 'create' -%>
+  <%= ERB.new(File.new("./thor/templates/_params_registry.erb").read, trim_mode: '-').result(binding) %>
+<%- end -%>
+
+<%- @namespace_depth.downto(1) do |i| -%>
+<%= '  '*(i-1) %>end
+<%- end if @namespace_depth > 0 -%>
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elasticsearch-api
 version: !ruby/object:Gem::Version
-  version: 7.3.0
+  version: 7.5.0
 platform: ruby
 authors:
 - Karel Minarik
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-01 00:00:00.000000000 Z
+date: 2020-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -266,16 +266,22 @@ dependencies:
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.17'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.17'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: simplecov-rcov
   requirement: !ruby/object:Gem::Requirement
@@ -334,7 +340,7 @@ dependencies:
         version: '2'
 description: 'Ruby API for Elasticsearch. See the `elasticsearch` gem for full integration.
 
-  '
+'
 email:
 - karel.minarik@elasticsearch.org
 executables: []
@@ -390,6 +396,7 @@ files:
 - lib/elasticsearch/api/actions/create.rb
 - lib/elasticsearch/api/actions/delete.rb
 - lib/elasticsearch/api/actions/delete_by_query.rb
+- lib/elasticsearch/api/actions/delete_by_query_rethrottle.rb
 - lib/elasticsearch/api/actions/delete_by_rethrottle.rb
 - lib/elasticsearch/api/actions/delete_script.rb
 - lib/elasticsearch/api/actions/exists.rb
@@ -402,6 +409,7 @@ files:
 - lib/elasticsearch/api/actions/index.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/delete.rb
@@ -421,6 +429,7 @@ files:
 - lib/elasticsearch/api/actions/indices/get_mapping.rb
 - lib/elasticsearch/api/actions/indices/get_settings.rb
 - lib/elasticsearch/api/actions/indices/get_template.rb
+- lib/elasticsearch/api/actions/indices/get_upgrade.rb
 - lib/elasticsearch/api/actions/indices/open.rb
 - lib/elasticsearch/api/actions/indices/params_registry.rb
 - lib/elasticsearch/api/actions/indices/put_alias.rb
@@ -470,6 +479,7 @@ files:
 - lib/elasticsearch/api/actions/search.rb
 - lib/elasticsearch/api/actions/search_shards.rb
 - lib/elasticsearch/api/actions/search_template.rb
+- lib/elasticsearch/api/actions/snapshot/cleanup_repository.rb
 - lib/elasticsearch/api/actions/snapshot/create.rb
 - lib/elasticsearch/api/actions/snapshot/create_repository.rb
 - lib/elasticsearch/api/actions/snapshot/delete.rb
@@ -547,6 +557,7 @@ files:
 - spec/elasticsearch/api/actions/index_document_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/delete_alias_spec.rb
@@ -602,7 +613,7 @@ files:
 - spec/elasticsearch/api/actions/reindex_spec.rb
 - spec/elasticsearch/api/actions/remote/info_spec.rb
 - spec/elasticsearch/api/actions/render_search_template_spec.rb
-- spec/elasticsearch/api/actions/scoll_spec.rb
+- spec/elasticsearch/api/actions/scroll_spec.rb
 - spec/elasticsearch/api/actions/search_shards_spec.rb
 - spec/elasticsearch/api/actions/search_spec.rb
 - spec/elasticsearch/api/actions/search_template_spec.rb
@@ -631,12 +642,17 @@ files:
 - test/test_helper.rb
 - utils/Gemfile
 - utils/Thorfile
-- utils/thor/generate_api.rb
 - utils/thor/generate_source.rb
+- utils/thor/generator/endpoint_specifics.rb
+- utils/thor/generator/files_helper.rb
 - utils/thor/lister.rb
-- utils/thor/templates/ruby/method.erb
-- utils/thor/templates/ruby/test.erb
-- utils/thor/templates/ruby/test_helper.rb
+- utils/thor/templates/_documentation_top.erb
+- utils/thor/templates/_method_setup.erb
+- utils/thor/templates/_params_registry.erb
+- utils/thor/templates/_perform_request.erb
+- 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
 licenses:
 - Apache-2.0
@@ -657,7 +673,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Ruby API for Elasticsearch.
@@ -710,6 +726,7 @@ test_files:
 - spec/elasticsearch/api/actions/index_document_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/delete_alias_spec.rb
@@ -765,7 +782,7 @@ test_files:
 - spec/elasticsearch/api/actions/reindex_spec.rb
 - spec/elasticsearch/api/actions/remote/info_spec.rb
 - spec/elasticsearch/api/actions/render_search_template_spec.rb
-- spec/elasticsearch/api/actions/scoll_spec.rb
+- spec/elasticsearch/api/actions/scroll_spec.rb
 - spec/elasticsearch/api/actions/search_shards_spec.rb
 - spec/elasticsearch/api/actions/search_spec.rb
 - spec/elasticsearch/api/actions/search_template_spec.rb

data/spec/elasticsearch/api/actions/scoll_spec.rb

@@ -1,21 +0,0 @@
-# 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
-
-require 'spec_helper'
-
-describe 'client#scroll' do
-
-  let(:expected_args) do
-    [
-        'GET',
-        '_search/scroll',
-        { scroll_id: 'cXVlcn...' },
-        nil
-    ]
-  end
-
-  it 'performs the request' do
-    expect(client_double.scroll(scroll_id: 'cXVlcn...')).to eq({})
-  end
-end

data/utils/thor/generate_api.rb

@@ -1,193 +0,0 @@
-# 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
-
-require 'thor'
-
-require 'pathname'
-require 'active_support/core_ext/hash/deep_merge'
-require 'active_support/inflector/methods'
-require 'rest_client'
-require 'json'
-require 'pry'
-
-module Elasticsearch
-
-  module API
-    module Utils
-      # controller.registerHandler(RestRequest.Method.GET, "/_cluster/health", this);
-      PATTERN_REST = /.*controller.registerHandler\(.*(?<method>GET|POST|PUT|DELETE|HEAD|OPTIONS|PATCH)\s*,\s*"(?<url>.*)"\s*,\s*.+\);/
-      # request.param("index"), request.paramAsBoolean("docs", indicesStatsRequest.docs()), etc
-      PATTERN_URL_PARAMS = /request.param.*\("(?<param>[a-z_]+)".*/
-      # controller.registerHandler(GET, "/{index}/_refresh", this)
-      PATTERN_URL_PARTS  = /\{(?<part>[a-zA-Z0-9\_\-]+)\}/
-      # request.hasContent()
-      PATTERN_HAS_BODY   = /request\.hasContent()/
-
-      # Parses the Elasticsearch source code and returns a Hash of REST API information/specs.
-      #
-      # Example:
-      #
-      #     {
-      #       "cluster.health" => [
-      #         { "method" => "GET",
-      #           "path"   => "/_cluster/health",
-      #           "parts"  => ["index"],
-      #           "params" => ["index", "local",  ... ],
-      #           "body"   => false
-      #     }
-      #
-      def __parse_java_source(path)
-        path  += '/' unless path =~ /\/$/ # Add trailing slash if missing
-        prefix = "src/main/java/org/elasticsearch/rest/action"
-
-        java_rest_files = Dir["#{path}#{prefix}/**/*.java"]
-
-        map = {}
-
-        java_rest_files.sort.each do |file|
-          content = File.read(file)
-          parts   = file.gsub(path+prefix, '').split('/')
-          name    = parts[0, parts.size-1].reject { |p| p =~ /^\s*$/ }.join('.')
-
-          # Remove the `admin` namespace
-          name.gsub! /admin\./, ''
-
-          # Extract params
-          url_params = content.scan(PATTERN_URL_PARAMS).map { |n| n.first }.sort
-
-          # Extract parts
-          url_parts = content.scan(PATTERN_URL_PARTS).map { |n| n.first }.sort
-
-          # Extract if body allowed
-          has_body  = !!content.match(PATTERN_HAS_BODY)
-
-          # Extract HTTP method and path
-          content.scan(PATTERN_REST) do |method, path|
-            (map[name] ||= []) << { 'method' => method,
-                                    'path'   => path,
-                                    'parts'  => url_parts,
-                                    'params' => url_params,
-                                    'body'   => has_body }
-          end
-
-        end
-
-        map
-      end
-
-      extend self
-    end
-
-    # Contains a generator which will parse the Elasticsearch *.java source files,
-    # extract information about REST API endpoints (URLs, HTTP methods, URL parameters, etc),
-    # and create a skeleton of the JSON API specification file for each endpoint.
-    #
-    # Usage:
-    #
-    #     $ thor help api:generate:spec
-    #
-    # Example:
-    #
-    # time thor api:generate:spec \
-    #             --force \
-    #             --verbose \
-    #             --crawl \
-    #             --elasticsearch=/path/to/elasticsearch/source/code
-    #
-    # Features:
-    #
-    # * Extract the API name from the source filename (eg. `admin/cluster/health/RestClusterHealthAction.java` -> `cluster.health`)
-    # * Extract the URLs from the `registerHandler` statements
-    # * Extract the URL parts (eg. `{index}`) from the URLs
-    # * Extract the URL parameters (eg. `{timeout}`) from the `request.param("ABC")` statements
-    # * Detect whether HTTP body is allowed for the API from `request.hasContent()` statements
-    # * Search the <http://elasticsearch.org> website to get proper documentation URLs
-    # * Assemble the JSON format for the API spec
-    #
-    class JsonGenerator < Thor
-      namespace 'api:spec'
-
-      include Thor::Actions
-
-      __root = Pathname( File.expand_path('../../..', __FILE__) )
-
-      # Usage: thor help api:generate:spec
-      #
-      desc "generate", "Generate JSON API spec files from Elasticsearch source code"
-      method_option :force,     type: :boolean, default: false,            desc: 'Overwrite the output'
-      method_option :verbose,   type: :boolean, default: false,            desc: 'Output more information'
-      method_option :output,    default: __root.join('tmp/out'),           desc: 'Path to output directory'
-      method_option :elasticsearch, default: __root.join('tmp/elasticsearch'), desc: 'Path to directory with Elasticsearch source code'
-      method_option :crawl,     type: :boolean, default: false,            desc: 'Extract URLs from Elasticsearch website'
-
-      def generate
-        self.class.source_root File.expand_path('../', __FILE__)
-
-        @output = Pathname(options[:output])
-
-        rest_actions = Utils.__parse_java_source(options[:elasticsearch].to_s)
-
-        if rest_actions.empty?
-          say_status 'ERROR', 'Cannot find Elasticsearch source in ' + options[:elasticsearch].to_s, :red
-          exit(1)
-        end
-
-        rest_actions.each do |name, info|
-          doc_url  = ""
-          parts    = info.reduce([]) { |sum, n| sum |= n['parts']; sum }.reduce({}) { |sum, n| sum[n] = {}; sum }
-          params   = info.reduce([]) { |sum, n| sum |= n['params']; sum }.reduce({}) { |sum, n| sum[n] = {}; sum }
-
-          if options[:crawl]
-            begin
-              response = RestClient.get "http://search.elasticsearch.org/elastic-search-website/guide/_search?q=#{URI.escape(name.gsub(/\./, ' '))}"
-              hits = JSON.load(response)['hits']['hits']
-              if hit = hits.first
-                if hit['_score'] > 0.2
-                  doc_title = hit['fields']['title']
-                  doc_url   = "http://elasticsearch.org" + hit['fields']['url']
-                end
-              end
-            rescue Exception => e
-              puts "[!] ERROR: #{e.inspect}"
-            end
-          end
-
-          spec     = {
-            name => {
-              'documentation' => doc_url,
-
-              'methods' => info.map { |n| n['method'] }.uniq,
-
-              'url' => {
-                'path'   => info.first['path'],
-                'paths'  => info.map { |n| n['path'] }.uniq,
-                'parts'  => parts,
-                'params' => params
-              },
-
-              'body' => info.first['body'] ? {} : nil
-            }
-          }
-
-          json = JSON.pretty_generate(spec, indent: '  ', array_nl: '', object_nl: "\n", space: ' ', space_before: ' ')
-
-          # Fix JSON array formatting
-          json.gsub!(/\[\s+/, '[')
-          json.gsub!(/, {2,}"/, ', "')
-
-          create_file @output.join( "#{name}.json" ), json + "\n"
-
-          if options[:verbose]
-            lines = json.split("\n")
-            say_status 'JSON',
-                       lines.first  + "\n" + lines[1, lines.size].map { |l| ' '*14 + l }.join("\n")
-          end
-        end
-      end
-
-      private
-
-    end
-  end
-end

data/utils/thor/templates/ruby/method.erb

@@ -1,62 +0,0 @@
-# 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
-
-module Elasticsearch
-  module API
-    <%- @module_namespace.each_with_index do |name, i| -%>
-    <%= '  '*i %>module <%= name == 'xpack' ? 'XPack' : name.capitalize %>
-    <%- end -%>
-    <%= '  '*@namespace_depth %>module Actions
-
-      <%= '  '*@namespace_depth %># <%= @spec['description'] || 'TODO: Description' %>
-      <%= '  '*@namespace_depth %>#
-<%# URL parts -%>
-      <%- @spec['url']['parts'].each do |name,info| -%>
-      <%- info['type'] = 'String' if info['type'] == 'enum' # Rename 'enums' to 'strings' -%>
-      <%= '  '*@namespace_depth + "# @option arguments [#{info['type'] ? info['type'].capitalize : 'String'}] :#{name} #{info['description'] ? info['description'].strip : '[TODO]'}" + ( info['required'] ? ' (*Required*)' : '' ) -%><%= " (options: #{info['options'].join(', '.strip)})" if info['options'] -%>
-      <%= "\n" -%>
-      <%- end -%>
-<%# Body -%>
-<%= '  '*(@namespace_depth+3) + '# @option arguments [Hash] :body ' + (@spec['body']['description'] ? @spec['body']['description'].strip : 'TODO: Description') + (@spec['body']['required'] ? ' (*Required*)' : '') + "\n" if @spec['body'] -%>
-<%# URL parameters -%>
-      <%- @spec['url']['params'].each do |name,info| -%>
-      <%- info['type'] = 'String' if info['type'] == 'enum' # Rename 'enums' to 'strings' -%>
-      <%= '  '*@namespace_depth + "# @option arguments [#{info['type'] ? info['type'].capitalize : 'String'}] :#{name} #{info['description'] ? info['description'].strip : '[TODO]'}" -%><%= " (options: #{info['options'].join(', ')})" if info['options'] -%>
-      <%=  "\n" -%>
-      <%- end if @spec['url']['parts'] -%>
-      <%= '  '*@namespace_depth -%>#
-<%# Documentation link -%>
-      <%= '  '*@namespace_depth %># @see <%= @spec['documentation'] ? @spec['documentation'] : "[TODO]" %>
-      <%= '  '*@namespace_depth %>#
-<%# Method definition -%>
-      <%= '  '*@namespace_depth -%>def <%= @method_name %>(arguments={})
-<%# Required arguments -%>
-      <%- @spec['url']['parts'].select { |name, info| info['required'] }.each do |name, info| -%>
-      <%= '  '*(@namespace_depth+1) + "raise ArgumentError, \"Required argument '#{name}' missing\" unless arguments[:#{name}]" + "\n" -%>
-      <%- end -%>
-<%- if @spec['body'] && @spec['body']['required'] -%>
-      <%= '  '*(@namespace_depth+1) + "raise ArgumentError, \"Required argument 'body' missing\" unless arguments[:body]" + "\n" -%>
-<%- end -%>
-<%# Method, path, params, body  -%>
-      <%- unless @spec['url']['params'].empty? -%>
-      <%= '  '*@namespace_depth %>  valid_params = [
-      <%= '  '*(@namespace_depth+2) %><%= @spec['url']['params'].keys.map { |k| ":#{k}" }.join(",\n#{'  '*(@namespace_depth+5)}") %> ]
-      <%- end -%>
-      <%= '  '*@namespace_depth %>  method = <%= @http_method %>
-      <%= '  '*@namespace_depth %>  path   = "<%= @http_path %>"
-      <%- unless @spec['url']['params'].empty? -%>
-      <%= '  '*@namespace_depth %>  params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, valid_params
-      <%- else -%>
-      <%= '  '*@namespace_depth %>  params = {}
-      <%- end -%>
-      <%= '  '*@namespace_depth %>  body   = <%= @spec['body'].nil? ? 'nil' : 'arguments[:body]' %>
-<%# Perform request %>
-      <%= '  '*@namespace_depth %>  perform_request(method, path, params, body).body
-      <%= '  '*@namespace_depth %>end
-      <%- @namespace_depth.downto(1) do |i| -%>
-      <%= '  '*(i-1) %>end
-      <%- end if @namespace_depth > 0 -%>
-    end
-  end
-end