elasticsearch-api 8.10.0 → 8.12.0

data/spec/elasticsearch/api/perform_request_spec.rb

@@ -0,0 +1,86 @@
+# 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'
+require 'elastic-transport'
+require_relative '../../../utils/endpoint_spec'
+require_relative '../../../utils/thor/generator/files_helper'
+
+describe 'Perform request args' do
+  Elasticsearch::API::FilesHelper.files.each do |filepath|
+    spec = Elasticsearch::API::EndpointSpec.new(filepath)
+    next if spec.module_namespace.flatten.first == '_internal'
+
+    # These are the path parts defined by the user in the method argument
+    defined_path_parts = spec.path_params.inject({}) do |params, part|
+      params.merge(part => 'testing')
+    end
+
+    # These are the required params, we must pass them to the method even when testing
+    required_params = spec.required_parts.inject({}) do |params, part|
+      params.merge(part.to_sym => 'testing')
+    end
+
+    let(:client_double) do
+      Class.new { include Elasticsearch::API }.new.tap do |client|
+        expect(client).to receive(:perform_request) do |_, _, _, _, _, request_params|
+          # The create method ends up becoming an 'index' request
+          if expected_perform_request_params[:endpoint] == 'create'
+            expected_perform_request_params[:endpoint] = 'index'
+          end
+          # Check that the expected hash is passed to the perform_request method
+          expect(request_params).to eq(expected_perform_request_params)
+        end.and_return(response_double)
+      end
+    end
+
+    let(:response_double) do
+      double('response', status: 200, body: {}, headers: {})
+    end
+
+    context("'#{spec.endpoint_name}'") do
+      # The expected hash passed to perform_request contains the endpoint name and any defined path parts
+      let(:expected_perform_request_params) do
+        if defined_path_parts.empty?
+          { endpoint: spec.endpoint_name }
+        else
+          { endpoint: spec.endpoint_name, defined_params:  defined_path_parts}
+        end
+      end
+
+      if spec.path_parts.empty?
+        it "passes the endpoint id to the request" do
+          if spec.module_namespace.empty?
+            client_double.send(spec.method_name, required_params)
+          else
+            client_double.send(spec.module_namespace[0]).send(spec.method_name, required_params)
+          end
+        end
+      else
+        it "passes params to the request with the endpoint id: #{spec.path_parts.keys}" do
+          if spec.module_namespace.empty?
+            client_double.send(spec.method_name, required_params.merge(defined_path_parts))
+          else
+            client_double.send(
+              spec.module_namespace[0]).send(spec.method_name, required_params.merge(defined_path_parts)
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/spec/rest_api/rest_api_tests_helper.rb

@@ -97,4 +97,4 @@ REST_API_YAML_FILES = if ENV['RUN_SKIPPED_TESTS'] # only run the skipped tests i
                       end
 
 # The features to skip
-REST_API_YAML_SKIP_FEATURES = ['warnings', 'node_selector'].freeze
+REST_API_YAML_SKIP_FEATURES = ['warnings', 'node_selector', 'close_to'].freeze

data/spec/rest_api/rest_api_yaml_spec.rb

@@ -22,6 +22,8 @@ require_relative './run_rspec_matchers'
 LOGGER = Logger.new($stdout)
 
 describe 'Rest API YAML tests' do
+  LOGGER.info "Elastic Transport version: #{Elastic::Transport::VERSION}"
+
   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.'

data/spec/rest_api/skipped_tests_free.yml

@@ -25,7 +25,6 @@
 -
   :file:        'tsdb/80_index_resize.yml'
   :description: 'clone'
-
 -
   :file: 'cluster.desired_nodes/10_basic.yml'
   :description: 'Test update desired nodes is idempotent'
@@ -33,5 +32,8 @@
   :file: 'cluster.desired_nodes/10_basic.yml'
   :description: 'Test update desired nodes is idempotent with different order'
 -
-  :file: 'cluster.desired_balance/10_basic.yml'
-  :description: 'Test cluster_balance_stats'
+  :file: 'search.vectors/40_knn_search.yml'
+  :description: 'Direct kNN queries are disallowed'
+-
+  :file: 'search.vectors/45_knn_search_byte.yml'
+  :description: 'Direct kNN queries are disallowed'

data/spec/rest_api/skipped_tests_platinum.yml

@@ -109,3 +109,6 @@
 -
   :file: 'spatial/70_script_doc_values.yml'
   :description: '*'
+-
+  :file: 'esql/60_usage.yml'
+  :description: 'Basic ESQL usage output (telemetry)'

data/spec/spec_helper.rb

@@ -61,10 +61,6 @@ RSpec.configure do |config|
   config.add_formatter('documentation')
   config.add_formatter('RspecJunitFormatter', "tmp/elasticsearch-#{ENV['TEST_SUITE']}-#{RUBY_VERSION}-junit.xml")
   config.add_formatter('RSpec::Core::Formatters::HtmlFormatter', "tmp/elasticsearch-#{ENV['TEST_SUITE']}-#{RUBY_VERSION}.html")
-  if ENV['BUILDKITE']
-    require_relative "./rspec_formatter.rb"
-    config.add_formatter('RSpecCustomFormatter')
-  end
   config.color_mode = :on
 end
 

data/utils/endpoint_spec.rb

@@ -0,0 +1,194 @@
+# 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
+
+require_relative 'endpoint_specifics'
+
+module Elasticsearch
+  module API
+    class EndpointSpec
+      include EndpointSpecifics
+
+      def initialize(filepath)
+        @path = Pathname(filepath)
+        json = MultiJson.load(File.read(@path))
+        @spec = json.values.first
+        @endpoint_name = json.keys.first
+
+        full_namespace = parse_full_namespace
+        @namespace_depth = full_namespace.size > 0 ? full_namespace.size - 1 : 0
+        @module_namespace = full_namespace[0, namespace_depth]
+        @method_name = full_namespace.last
+
+        @path_parts = parse_endpoint_parts(@spec)
+        @params = @spec['params'] || {}
+        @paths = @spec['url']['paths'].map { |b| b['path'] } if @spec['url']
+        @path_params   = path_variables.flatten.uniq.collect(&:to_sym)
+        @http_method = parse_http_method(@spec)
+        @deprecation_note = @spec['url']['paths'].last&.[]('deprecated')
+        @http_path        = parse_http_path(@paths)
+        @required_parts   = parse_required_parts(@spec)
+      end
+
+      attr_reader :module_namespace,
+                  :method_name,
+                  :endpoint_name,
+                  :path,
+                  :path_parts,
+                  :params,
+                  :deprecation_note,
+                  :namespace_depth,
+                  :http_path,
+                  :required_parts,
+                  :http_method,
+                  :namespace_depth,
+                  :path_params,
+                  :perform_request_opts
+
+      def body
+        @spec['body']
+      end
+
+      def documentation
+        @spec['documentation']
+      end
+
+      def stability
+        @spec['stability']
+      end
+
+      # Function that adds the listified h param code
+      def specific_params
+        super(@module_namespace.first, @method_name)
+      end
+
+      private
+
+      def parse_full_namespace
+        names = @endpoint_name.split('.')
+        # Return an array to expand 'ccr', 'ilm', 'ml' and 'slm'
+        names.map do |name|
+          name
+            .gsub(/^ml$/, 'machine_learning')
+            .gsub(/^ilm$/, 'index_lifecycle_management')
+            .gsub(/^ccr/, 'cross_cluster_replication')
+            .gsub(/^slm/, 'snapshot_lifecycle_management')
+        end
+      end
+
+      def parse_endpoint_parts(spec)
+        parts = spec['url']['paths'].select do |a|
+          a.keys.include?('parts')
+        end.map do |path|
+          path&.[]('parts')
+        end
+        (parts.inject(&:merge) || [])
+      end
+
+      def parse_http_method(spec)
+        return '_id ? Elasticsearch::API::HTTP_PUT : Elasticsearch::API::HTTP_POST' if @endpoint_name == 'index'
+        return '_name ? Elasticsearch::API::HTTP_PUT : Elasticsearch::API::HTTP_POST' if @method_name == 'create_service_token'
+        return post_and_get if @endpoint_name == 'count'
+
+        default_method = spec['url']['paths'].map { |a| a['methods'] }.flatten.first
+        if spec['body'] && default_method == 'GET'
+          # When default method is GET and body is required, we should always use POST
+          if spec['body']['required']
+            'Elasticsearch::API::HTTP_POST'
+          else
+            post_and_get
+          end
+        else
+          "Elasticsearch::API::HTTP_#{default_method}"
+        end
+      end
+
+      def parse_http_path(paths)
+        return "\"#{parse_path(paths.first)}\"" if paths.size == 1
+
+        result = ''
+        anchor_string = []
+        paths.sort { |a, b| b.length <=> a.length }.each_with_index do |path, i|
+          var_string = extract_path_variables(path).map { |var| "_#{var}" }.join(' && ')
+          next if anchor_string.include? var_string
+
+          anchor_string << var_string
+          result += if i.zero?
+                      "if #{var_string}\n"
+                    elsif (i == paths.size - 1) || var_string.empty?
+                      "else\n"
+                    else
+                      "elsif #{var_string}\n"
+                    end
+          result += "\"#{parse_path(path)}\"\n"
+        end
+        result += 'end'
+        result
+      end
+
+      def parse_path(path)
+        path.gsub(/^\//, '')
+            .gsub(/\/$/, '')
+            .gsub('{', "\#{Utils.__listify(_")
+            .gsub('}', ')}')
+      end
+
+      def path_variables
+        @paths.map do |path|
+          extract_path_variables(path)
+        end
+      end
+
+      def parse_path_variables
+        @paths.map do |path|
+          extract_path_variables(path)
+        end
+      end
+
+      # extract values that are in the {var} format:
+      def extract_path_variables(path)
+        path.scan(/{(\w+)}/).flatten
+      end
+
+      # Find parts that are definitely required and should raise an error if
+      # they're not present
+      #
+      def parse_required_parts(spec)
+        required = []
+        return required if @endpoint_name == 'tasks.get'
+
+        required << 'body' if (spec['body'] && spec['body']['required'])
+        # Get required variables from paths:
+        req_variables = parse_path_variables.inject(:&) # find intersection
+        required << req_variables unless req_variables.empty?
+        required.flatten
+      end
+
+      def post_and_get
+        # the METHOD is defined after doing arguments.delete(:body), so we need to check for `body`
+        <<~SRC
+          if body
+            Elasticsearch::API::HTTP_POST
+          else
+            Elasticsearch::API::HTTP_GET
+          end
+        SRC
+      end
+    end
+  end
+end

data/utils/{thor/generator/endpoint_specifics.rb → endpoint_specifics.rb}

@@ -55,10 +55,10 @@ module Elasticsearch
                     recovery shards thread_pool].freeze
 
       # Function that adds the listified h param code
-      def specific_params(namespace)
+      def specific_params(namespace, method_name)
         params = []
-        if H_PARAMS.include?(@method_name) && namespace == 'cat'
-          if @method_name == 'nodes'
+        if H_PARAMS.include?(method_name) && namespace == 'cat'
+          if method_name == 'nodes'
             params << 'params[:h] = Utils.__listify(params[:h], escape: false) if params[:h]'
           else
             params << 'params[:h] = Utils.__listify(params[:h]) if params[:h]'
@@ -84,7 +84,7 @@ module Elasticsearch
       def ping_perform_request
         <<~SRC
           begin
-            perform_request(method, path, params, body, headers).status == 200 ? true : false
+            perform_request(method, path, params, body, headers, request_opts).status == 200 ? true : false
           rescue Exception => e
             if e.class.to_s =~ /NotFound|ConnectionFailed/ || e.message =~ /Not\s*Found|404|ConnectionFailed/i
               false

data/utils/thor/generate_source.rb

@@ -23,7 +23,7 @@ require 'multi_json'
 require 'coderay'
 require 'pry'
 require_relative 'generator/files_helper'
-require_relative 'generator/endpoint_specifics'
+require_relative '../endpoint_spec'
 
 module Elasticsearch
   module API
@@ -62,45 +62,25 @@ module Elasticsearch
       private
 
       def generate_source
-        @output = FilesHelper.output_dir
-        cleanup_directory!
+        output = FilesHelper.output_dir
+        cleanup_directory!(output)
 
         FilesHelper.files.each do |filepath|
-          @path = Pathname(filepath)
-          @json = MultiJson.load(File.read(@path))
-          @spec = @json.values.first
-          say_status 'json', @path, :yellow
-
-          @spec['url'] ||= {}
-
-          @endpoint_name    = @json.keys.first
-          @full_namespace   = __full_namespace
-          @namespace_depth  = @full_namespace.size > 0 ? @full_namespace.size - 1 : 0
-          @module_namespace = @full_namespace[0, @namespace_depth]
+          @spec = EndpointSpec.new(filepath)
+          say_status 'json', @spec.path, :yellow
 
           # Don't generate code for internal APIs:
-          next if @module_namespace.flatten.first == '_internal'
-
-          @method_name      = @full_namespace.last
-          @parts            = __endpoint_parts
-          @params           = @spec['params'] || {}
-          @specific_params  = specific_params(@module_namespace.first) # See EndpointSpecifics
-          @http_method      = __http_method
-          @paths            = @spec['url']['paths'].map { |b| b['path'] }
-          # Using Ruby's safe operator on array:
-          @deprecation_note = @spec['url']['paths'].last&.[]('deprecated')
-          @http_path        = __http_path
-          @required_parts   = __required_parts
-
-          @path_to_file = @output.join(@module_namespace.join('/')).join("#{@method_name}.rb")
-          dir = @output.join(@module_namespace.join('/'))
+          next if @spec.module_namespace.flatten.first == '_internal'
+
+          path_to_file = output.join(@spec.module_namespace.join('/')).join("#{@spec.method_name}.rb")
+          dir = output.join(@spec.module_namespace.join('/'))
 
           empty_directory(dir, verbose: false)
 
           # Write the file with the ERB template:
-          template('templates/method.erb', @path_to_file, force: true)
+          template('templates/method.erb', path_to_file, force: true)
 
-          print_source_code(@path_to_file) if options[:verbose]
+          print_source_code(path_to_file) if options[:verbose]
 
           generate_tests if options[:tests]
 
@@ -137,122 +117,15 @@ module Elasticsearch
         match[1]
       end
 
-      def __full_namespace
-        names = @endpoint_name.split('.')
-        # Return an array to expand 'ccr', 'ilm', 'ml' and 'slm'
-        names.map do |name|
-          name
-            .gsub(/^ml$/, 'machine_learning')
-            .gsub(/^ilm$/, 'index_lifecycle_management')
-            .gsub(/^ccr/, 'cross_cluster_replication')
-            .gsub(/^slm/, 'snapshot_lifecycle_management')
-        end
-      end
-
       # Create the hierarchy of directories based on API namespaces
       #
-      def __create_directories(key, value)
+      def create_directories(key, value)
         return if value['documentation']
 
         empty_directory @output.join(key)
         create_directory_hierarchy * value.to_a.first
       end
 
-      # Extract parts from each path
-      #
-      def __endpoint_parts
-        parts = @spec['url']['paths'].select do |a|
-          a.keys.include?('parts')
-        end.map do |path|
-          path&.[]('parts')
-        end
-        (parts.inject(&:merge) || [])
-      end
-
-      def __http_method
-        return '_id ? Elasticsearch::API::HTTP_PUT : Elasticsearch::API::HTTP_POST' if @endpoint_name == 'index'
-        return '_name ? Elasticsearch::API::HTTP_PUT : Elasticsearch::API::HTTP_POST' if @method_name == 'create_service_token'
-        return post_and_get if @endpoint_name == 'count'
-
-        default_method = @spec['url']['paths'].map { |a| a['methods'] }.flatten.first
-        if @spec['body'] && default_method == 'GET'
-          # When default method is GET and body is required, we should always use POST
-          if @spec['body']['required']
-            'Elasticsearch::API::HTTP_POST'
-          else
-            post_and_get
-          end
-        else
-          "Elasticsearch::API::HTTP_#{default_method}"
-        end
-      end
-
-      def post_and_get
-        # the METHOD is defined after doing arguments.delete(:body), so we need to check for `body`
-        <<~SRC
-          if body
-            Elasticsearch::API::HTTP_POST
-          else
-            Elasticsearch::API::HTTP_GET
-          end
-        SRC
-      end
-
-      def __http_path
-        return "\"#{__parse_path(@paths.first)}\"" if @paths.size == 1
-
-        result = ''
-        anchor_string = []
-        @paths.sort { |a, b| b.length <=> a.length }.each_with_index do |path, i|
-          var_string = __extract_path_variables(path).map { |var| "_#{var}" }.join(' && ')
-          next if anchor_string.include? var_string
-
-          anchor_string << var_string
-          result += if i.zero?
-                      "if #{var_string}\n"
-                    elsif (i == @paths.size - 1) || var_string.empty?
-                      "else\n"
-                    else
-                      "elsif #{var_string}\n"
-                    end
-          result += "\"#{__parse_path(path)}\"\n"
-        end
-        result += 'end'
-        result
-      end
-
-      def __parse_path(path)
-        path.gsub(/^\//, '')
-          .gsub(/\/$/, '')
-          .gsub('{', "\#{Utils.__listify(_")
-          .gsub('}', ')}')
-      end
-
-      def __path_variables
-        @paths.map do |path|
-          __extract_path_variables(path)
-        end
-      end
-
-      # extract values that are in the {var} format:
-      def __extract_path_variables(path)
-        path.scan(/{(\w+)}/).flatten
-      end
-
-      # Find parts that are definitely required and should raise an error if
-      # they're not present
-      #
-      def __required_parts
-        required = []
-        return required if @endpoint_name == 'tasks.get'
-
-        required << 'body' if (@spec['body'] && @spec['body']['required'])
-        # Get required variables from paths:
-        req_variables = __path_variables.inject(:&) # find intersection
-        required << req_variables unless req_variables.empty?
-        required.flatten
-      end
-
       def docs_helper(name, info)
         info['type'] = 'String' if info['type'] == 'enum' # Rename 'enums' to 'strings'
         info['type'] = 'Integer' if info['type'] == 'int' # Rename 'int' to 'Integer'
@@ -319,8 +192,8 @@ module Elasticsearch
         say_status('tree', lines.first + "\n" + lines[1, lines.size].map { |l| ' ' * 14 + l }.join("\n"))
       end
 
-      def cleanup_directory!
-        Dir["#{@output}/**/*.rb"].each do |file|
+      def cleanup_directory!(output)
+        Dir["#{output}/**/*.rb"].each do |file|
           # file = File.join(@output, f)
           File.delete(file) unless (['.', '..'].include? file) || Pathname(file).directory?
         end

data/utils/thor/templates/_body.erb

@@ -17,7 +17,7 @@
 # under the License.
 %>
 <%-
-case @endpoint_name
+case @spec.endpoint_name
 when 'mtermvectors'
 -%>
   body = if(ids = arguments.delete(:ids))
@@ -30,5 +30,5 @@ when 'mtermvectors'
 <%- when 'ml.find_file_structure' %>
   body = Utils.__bulkify(arguments.delete(:body))
 <%- else -%>
-  <%= '  '*(@namespace_depth+3) %>body   = <%= @spec['body'].nil? ? 'nil' : 'arguments.delete(:body)' %>
+  <%= '  '*(@spec.namespace_depth+3) %>body   = <%= @spec.body.nil? ? 'nil' : 'arguments.delete(:body)' %>
 <%- end -%>

data/utils/thor/templates/_documentation_top.erb

@@ -16,42 +16,42 @@
 # specific language governing permissions and limitations
 # under the License.
 %>
-<%- if @spec['documentation']['description'] -%>
-  <%= '  '*(@namespace_depth+3) %># <%= @spec['documentation']['description'].gsub("\n", "\n#{'  '*(@namespace_depth+3)}# ") -%>
+<%- if @spec.documentation['description'] -%>
+  <%= '  '*(@spec.namespace_depth+3) %># <%= @spec.documentation['description'] .gsub("\n", "\n#{'  '*(@spec.namespace_depth+3)}# ") -%>
 <%- else %>
-  <%= '  '*(@namespace_depth+3) %># TODO: Description
+  <%= '  '*(@spec.namespace_depth+3) %># TODO: Description
 <%- end %>
-<%= stability_doc_helper(@spec['stability']) -%>
-<%= '  '*(@namespace_depth+3) %>#
-<%- unless @parts.nil? || @parts.empty? %><%# URL parts -%>
-  <%- @parts.each do |name, info| -%>
+<%= stability_doc_helper(@spec.stability) -%>
+<%= '  '*(@spec.namespace_depth+3) %>#
+<%- unless @spec.path_parts.nil? || @spec.path_parts.empty? %><%# URL parts -%>
+  <%- @spec.path_parts.each do |name, info| -%>
     <%= docs_helper(name, info) -%>
   <%- end -%>
 <%- end -%><%# Body -%>
 <%# URL parameters -%>
-<%- @params.each do |name, info| -%>
-  <%= docs_helper(name, info) unless (!@parts.empty? && @parts.keys.include?(name)) -%>
+<%- @spec.params.each do |name, info| -%>
+  <%= docs_helper(name, info) unless (!@spec.path_parts.empty? && @spec.path_parts.keys.include?(name)) -%>
 <%- end -%>
 # @option arguments [Hash] :headers Custom HTTP headers
-<%- if @spec['body'] -%>
-  <%- if @method_name == 'bulk' -%>
-    <%= bulk_doc_helper(@spec['body']['description']) -%>
+<%- if @spec.body -%>
+  <%- if @spec.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"
+    <%= '  '*(@spec.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 -%>
+<% if @spec.deprecation_note -%>
   #
   # *Deprecation notice*:
-  # <%=  @deprecation_note['description'] %>
-  # Deprecated since version <%=  @deprecation_note['version'] %>
+  # <%=  @spec.deprecation_note['description'] %>
+  # Deprecated since version <%=  @spec.deprecation_note['version'] %>
   #
 <% end -%>
-<%= '  '*(@namespace_depth+3) -%>#
+<%= '  '*(@spec.namespace_depth+3) -%>#
 <%# Documentation link -%>
-<%=  '  '*(@namespace_depth+3) %># @see <%= @spec['documentation']['url'] ? Elasticsearch::API::FilesHelper.documentation_url(@spec['documentation']['url']) : "[TODO]" %>
-<%= '  '*(@namespace_depth+3) %>#
+<%=  '  '*(@spec.namespace_depth+3) %># @see <%= @spec.documentation['url'] ? Elasticsearch::API::FilesHelper.documentation_url(@spec.documentation['url']) : "[TODO]" %>
+<%= '  '*(@spec.namespace_depth+3) %>#