elasticsearch-api 6.8.0 → 7.10.0

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

@@ -1,130 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Return documents similar to the specified one.
-      #
-      # Performs a `more_like_this` query with the specified document as the input.
-      #
-      # @example Search for similar documents using the `title` property of document `myindex/mytype/1`
-      #
-      #     # First, let's setup a synonym-aware analyzer ("quick" <=> "fast")
-      #     client.indices.create index: 'myindex', body: {
-      #       settings: {
-      #         analysis: {
-      #           filter: {
-      #             synonyms: {
-      #               type: 'synonym',
-      #               synonyms: [ "quick,fast" ]
-      #             }
-      #           },
-      #           analyzer: {
-      #             title_synonym: {
-      #               type: 'custom',
-      #               tokenizer: 'whitespace',
-      #               filter: ['lowercase', 'stop', 'snowball', 'synonyms']
-      #             }
-      #           }
-      #         }
-      #       },
-      #       mappings: {
-      #         mytype: {
-      #           properties: {
-      #             title: {
-      #               type: 'string',
-      #               analyzer: 'title_synonym'
-      #             }
-      #           }
-      #         }
-      #       }
-      #     }
-      #
-      #     # Index three documents
-      #     client.index index: 'myindex', type: 'mytype', id: 1, body: { title: 'Quick Brown Fox'   }
-      #     client.index index: 'myindex', type: 'mytype', id: 2, body: { title: 'Slow Black Dog'    }
-      #     client.index index: 'myindex', type: 'mytype', id: 3, body: { title: 'Fast White Rabbit' }
-      #     client.indices.refresh index: 'myindex'
-      #
-      #     client.mlt index: 'myindex', type: 'mytype', id: 1, mlt_fields: 'title', min_doc_freq: 1, min_term_freq: 1
-      #     # => { ... {"title"=>"Fast White Rabbit"}}]}}
-      #
-      # @option arguments [String] :id The document ID (*Required*)
-      # @option arguments [String] :index The name of the index (*Required*)
-      # @option arguments [String] :type The type of the document (use `_all` to fetch
-      #                                  the first document matching the ID across all types) (*Required*)
-      # @option arguments [Hash] :body A specific search request definition
-      # @option arguments [Number] :boost_terms The boost factor
-      # @option arguments [Number] :max_doc_freq The word occurrence frequency as count: words with higher occurrence
-      #                                          in the corpus will be ignored
-      # @option arguments [Number] :max_query_terms The maximum query terms to be included in the generated query
-      # @option arguments [Number] :max_word_len The minimum length of the word: longer words will be ignored
-      # @option arguments [Number] :min_doc_freq The word occurrence frequency as count: words with lower occurrence
-      #                                          in the corpus will be ignored
-      # @option arguments [Number] :min_term_freq The term frequency as percent: terms with lower occurence
-      #                                           in the source document will be ignored
-      # @option arguments [Number] :min_word_len The minimum length of the word: shorter words will be ignored
-      # @option arguments [List] :mlt_fields Specific fields to perform the query against
-      # @option arguments [Number] :percent_terms_to_match How many terms have to match in order to consider
-      #                                                    the document a match (default: 0.3)
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [Number] :search_from The offset from which to return results
-      # @option arguments [List] :search_indices A comma-separated list of indices to perform the query against
-      #                                          (default: the index containing the document)
-      # @option arguments [String] :search_query_hint The search query hint
-      # @option arguments [String] :search_scroll A scroll search request definition
-      # @option arguments [Number] :search_size The number of documents to return (default: 10)
-      # @option arguments [String] :search_source A specific search request definition (instead of using the request body)
-      # @option arguments [String] :search_type Specific search type (eg. `dfs_then_fetch`, `count`, etc)
-      # @option arguments [List] :search_types A comma-separated list of types to perform the query against
-      #                                        (default: the same type as the document)
-      # @option arguments [List] :stop_words A list of stop words to be ignored
-      #
-      # @see http://elasticsearch.org/guide/reference/api/more-like-this/
-      #
-      def mlt(arguments={})
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
-        raise ArgumentError, "Required argument 'type' missing"  unless arguments[:type]
-        raise ArgumentError, "Required argument 'id' missing"    unless arguments[:id]
-        method = HTTP_GET
-        path   = Utils.__pathify Utils.__escape(arguments[:index]),
-                                 Utils.__escape(arguments[:type]),
-                                 Utils.__escape(arguments[:id]),
-                                 '_mlt'
-
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-
-        [:mlt_fields, :search_indices, :search_types, :stop_words].each do |name|
-          params[name] = Utils.__listify(params[name]) if params[name]
-        end
-
-        body   = arguments[:body]
-
-        perform_request(method, path, params, body).body
-      end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:mlt, [
-          :boost_terms,
-          :max_doc_freq,
-          :max_query_terms,
-          :max_word_len,
-          :min_doc_freq,
-          :min_term_freq,
-          :min_word_len,
-          :mlt_fields,
-          :percent_terms_to_match,
-          :routing,
-          :search_from,
-          :search_indices,
-          :search_query_hint,
-          :search_scroll,
-          :search_size,
-          :search_source,
-          :search_type,
-          :search_types,
-          :stop_words ].freeze)
-    end
-  end
-end

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

@@ -1,62 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Perform multiple percolate operations in a single request, similar to the {#msearch} API
-      #
-      # Pass the percolate definitions as header-body pairs in the `:body` argument, as an Array of Hashes.
-      #
-      # @example Perform two different percolations in a single request
-      #
-      #     client.mpercolate \
-      #         body: [
-      #           { percolate: { index: "my-index", type: "my-type" } },
-      #           { doc: { message: "foo bar" } },
-      #           { percolate: { index: "my-other-index", type: "my-other-type", id: "1" } },
-      #           { }
-      #         ]
-      #
-      # @option arguments [String] :index The index of the document being count percolated to use as default
-      # @option arguments [String] :type The type of the document being percolated to use as default.
-      # @option arguments [Array<Hash>]  The percolate request definitions (header & body pairs) (*Required*)
-      # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
-      #                                                 unavailable (missing or closed)
-      # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into
-      #                                               no concrete indices. (This includes `_all` string or when no
-      #                                               indices have been specified)
-      # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that are
-      #                                              open, closed or both. (options: open, closed)
-      #
-      # @see http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-percolate.html
-      #
-      def mpercolate(arguments={})
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        method = HTTP_GET
-        path   = "_mpercolate"
-
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
-
-        case
-        when body.is_a?(Array)
-          payload = body.map { |d| d.is_a?(String) ? d : Elasticsearch::API.serializer.dump(d) }
-          payload << "" unless payload.empty?
-          payload = payload.join("\n")
-        else
-          payload = body
-        end
-
-        perform_request(method, path, params, payload).body
-      end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:mpercolate, [
-          :ignore_unavailable,
-          :allow_no_indices,
-          :expand_wildcards,
-          :percolate_format ].freeze)
-    end
-  end
-end

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

@@ -1,73 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Return names of queries matching a document.
-      #
-      # Percolator allows you to register queries and then evaluate a document against them:
-      # the IDs of matching queries are returned in the response.
-      #
-      # @deprecated The `_percolate` API has been deprecated in favour of a special field mapping and the
-      #             `percolate` query;
-      #             see https://www.elastic.co/guide/en/elasticsearch/reference/5.5/breaking_50_percolator.html
-      #
-      # See full example for Elasticsearch 5.x and higher in <https://github.com/elastic/elasticsearch-ruby/blob/master/examples/percolator/percolator_alerts.rb>
-      #
-      # @option arguments [String] :index The index of the document being percolated. (*Required*)
-      # @option arguments [String] :type The type of the document being percolated. (*Required*)
-      # @option arguments [String] :id Fetch the document specified by index/type/id and
-      #                                use it instead of the passed `doc`
-      # @option arguments [Hash] :body The percolator request definition using the percolate DSL
-      # @option arguments [List] :routing A comma-separated list of specific routing values
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on
-      #                                        (default: random)
-      # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
-      #                                                 unavailable (missing or closed)
-      # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves into
-      #                                               no concrete indices. (This includes `_all` string or when no
-      #                                               indices have been specified)
-      # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices that are
-      #                                              open, closed or both. (options: open, closed)
-      # @option arguments [String] :percolate_index The index to percolate the document into. Defaults to passed `index`.
-      # @option arguments [String] :percolate_format Return an array of matching query IDs instead of objects.
-      #                                              (options: ids)
-      # @option arguments [String] :percolate_type The type to percolate document into. Defaults to passed `type`.
-      # @option arguments [Number] :version Explicit version number for concurrency control
-      # @option arguments [String] :version_type Specific version type (options: internal, external, external_gte, force)
-      #
-      # @see http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-percolate.html
-      #
-      def percolate(arguments={})
-        Utils.__report_unsupported_method :percolate
-
-        raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
-        raise ArgumentError, "Required argument 'type' missing"  unless arguments[:type]
-        method = HTTP_GET
-        path   = Utils.__pathify Utils.__escape(arguments[:index]),
-                                 Utils.__escape(arguments[:type]),
-                                 Utils.__escape(arguments[:id]),
-                                 '_percolate'
-
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
-
-        perform_request(method, path, params, body).body
-      end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:percolate, [
-          :routing,
-          :preference,
-          :ignore_unavailable,
-          :allow_no_indices,
-          :expand_wildcards,
-          :percolate_index,
-          :percolate_type,
-          :percolate_format,
-          :version,
-          :version_type ].freeze)
-    end
-  end
-end

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

@@ -1,25 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Store a template for the search definition in Elasticsearch,
-      # to be later used with the `search_template` method
-      #
-      # @option arguments [String] :id Template ID (*Required*)
-      # @option arguments [Hash] :body The document (*Required*)
-      #
-      # @see http://www.elasticsearch.org/guide/en/elasticsearch/reference/master/search-template.html
-      #
-      def put_template(arguments={})
-        raise ArgumentError, "Required argument 'id' missing"   unless arguments[:id]
-        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        method = HTTP_POST
-        path   = "_scripts/#{arguments[:id]}"
-        params = {}
-        body   = arguments[:body]
-
-        perform_request(method, path, params, body).body
-      end
-    end
-  end
-end

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

@@ -1,63 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Return whether documents exists for a particular query
-      #
-      # @option arguments [List] :index A comma-separated list of indices to restrict the results
-      # @option arguments [List] :type A comma-separated list of types to restrict the results
-      # @option arguments [Hash] :body A query to restrict the results specified with the Query DSL (optional)
-      # @option arguments [Boolean] :ignore_unavailable Whether specified concrete indices should be ignored when
-      #                                                 unavailable (missing or closed)
-      # @option arguments [Boolean] :allow_no_indices Whether to ignore if a wildcard indices expression resolves
-      #                                               into no concrete indices.
-      # @option arguments [String] :expand_wildcards Whether to expand wildcard expression to concrete indices
-      #                                              that are open, closed or both.
-      #                                              (options: open, closed, none, all)
-      # @option arguments [Number] :min_score Include only documents with a specific `_score` value in the result
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on
-      #                                        (default: random)
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [String] :q Query in the Lucene query string syntax
-      # @option arguments [String] :analyzer The analyzer to use for the query string
-      # @option arguments [Boolean] :analyze_wildcard Specify whether wildcard and prefix queries should be
-      #                                               analyzed (default: false)
-      # @option arguments [String] :default_operator The default operator for query string query (AND or OR)
-      #                                              (options: AND, OR)
-      # @option arguments [String] :df The field to use as default where no field prefix is given
-      #                                in the query string
-      # @option arguments [Boolean] :lenient Specify whether format-based query failures
-      #                                      (such as providing text to a numeric field) should be ignored
-      # @option arguments [Boolean] :lowercase_expanded_terms Specify whether query terms should be lowercased
-      #
-      # @see http://www.elastic.co/guide/en/elasticsearch/reference/master/search-exists.html
-      #
-      def search_exists(arguments={})
-        method = 'POST'
-        path   = "_search/exists"
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
-
-        perform_request(method, path, params, body).body
-      end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:search_exists, [
-          :ignore_unavailable,
-          :allow_no_indices,
-          :expand_wildcards,
-          :min_score,
-          :preference,
-          :routing,
-          :q,
-          :analyzer,
-          :analyze_wildcard,
-          :default_operator,
-          :df,
-          :lenient,
-          :lowercase_expanded_terms ].freeze)
-    end
-  end
-end

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

@@ -1,49 +0,0 @@
-module Elasticsearch
-  module API
-    module Actions
-
-      # Return query terms suggestions based on provided text and configuration.
-      #
-      # Pass the request definition in the `:body` argument.
-      #
-      # @example Return query terms suggestions ("auto-correction")
-      #
-      #     client.suggest index: 'myindex',
-      #                    body: { my_suggest: { text: 'tset', term: { field: 'title' } } }
-      #     # => { ... "my_suggest"=>[ {"text"=>"tset", ... "options"=>[{"text"=>"test", "score"=>0.75, "freq"=>5}] }]}
-      #
-      # @option arguments [List] :index A comma-separated list of index names to restrict the operation;
-      #                                 use `_all` or empty string to perform the operation on all indices
-      # @option arguments [Hash] :body The request definition
-      # @option arguments [String] :ignore_indices When performed on multiple indices, allows to ignore `missing` ones
-      #                                            (options: none, missing)
-      # @option arguments [String] :preference Specify the node or shard the operation should be performed on
-      #                                        (default: random)
-      # @option arguments [String] :routing Specific routing value
-      # @option arguments [String] :source The URL-encoded request definition (instead of using request body)
-      #
-      # @since 0.90
-      #
-      # @see http://elasticsearch.org/guide/reference/api/search/suggest/
-      #
-      def suggest(arguments={})
-        method = HTTP_POST
-        path   = Utils.__pathify( Utils.__listify(arguments[:index]), '_suggest' )
-
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
-
-        perform_request(method, path, params, body).body
-      end
-
-      # Register this action with its valid params when the module is loaded.
-      #
-      # @since 6.2.0
-      ParamsRegistry.register(:suggest, [
-          :ignore_indices,
-          :preference,
-          :routing,
-          :source ].freeze)
-    end
-  end
-end

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

@@ -1,17 +0,0 @@
-require 'spec_helper'
-
-describe 'client#count_percolate' do
-
-  let(:expected_args) do
-    [
-      'GET',
-      'foo/bar/_percolate/count',
-      {},
-      { doc: { foo: 'bar' } }
-    ]
-  end
-
-  it 'performs the request' do
-    expect(client_double.count_percolate(index: 'foo', type: 'bar', body: { doc: { foo: 'bar' } })).to eq({})
-  end
-end

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

@@ -1,17 +0,0 @@
-require 'spec_helper'
-
-describe 'client#delete_template' do
-
-  let(:expected_args) do
-    [
-        'DELETE',
-        '_search/template/foo',
-        {},
-        nil
-    ]
-  end
-
-  it 'performs the request' do
-    expect(client_double.delete_template(id: 'foo')).to eq({})
-  end
-end

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

@@ -1,17 +0,0 @@
-require 'spec_helper'
-
-describe 'client#field_stats' do
-
-  let(:expected_args) do
-    [
-        'GET',
-        '_field_stats',
-        { },
-        nil
-    ]
-  end
-
-  it 'performs the request' do
-    expect(client_double.field_stats).to eq({})
-  end
-end

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

@@ -1,52 +0,0 @@
-require 'spec_helper'
-
-describe 'client#get_template' do
-
-  let(:expected_args) do
-    [
-        'GET',
-        url,
-        params,
-        nil
-    ]
-  end
-
-  let(:params) do
-    { }
-  end
-
-  let(:client) do
-    Class.new { include Elasticsearch::API }.new
-  end
-
-  context 'when the `lang` parameter is specified' do
-
-    let(:url) do
-      '_scripts/foo'
-    end
-
-    it 'performs the request' do
-      expect(client_double.get_template(id: 'foo')).to eq({})
-    end
-  end
-
-  context 'when the request raises a NotFound exception' do
-
-    before do
-      expect(client).to receive(:perform_request).and_raise(NotFound)
-    end
-
-    it 'raises the exception' do
-      expect {
-        client.get_template(id: 'foo')
-      }.to raise_exception(NotFound)
-    end
-
-    context 'when the ignore parameter is specified' do
-
-      it 'returns false' do
-        expect(client.get_template(id: 'foo', ignore: 404)).to eq(false)
-      end
-    end
-  end
-end

data/spec/elasticsearch/api/actions/indices/delete_mapping_spec.rb

@@ -1,77 +0,0 @@
-require 'spec_helper'
-
-describe 'client.indices#delete_mapping' do
-
-  let(:expected_args) do
-    [
-        'DELETE',
-        url,
-        params,
-        nil,
-        nil
-    ]
-  end
-
-  let(:params) do
-    {}
-  end
-
-  context 'when there is no index specified' do
-
-    let(:client) do
-      Class.new { include Elasticsearch::API }.new
-    end
-
-    it 'raises an exception' do
-      expect {
-        client.indices.delete_mapping(type: 'foo')
-      }.to raise_exception(ArgumentError)
-    end
-  end
-
-  context 'when there is no type specified' do
-
-    let(:client) do
-      Class.new { include Elasticsearch::API }.new
-    end
-
-    it 'raises an exception' do
-      expect {
-        client.indices.delete_mapping(index: 'foo')
-      }.to raise_exception(ArgumentError)
-    end
-  end
-
-  context 'when an index and type are specified' do
-
-    let(:url) do
-      'foo/bar'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_mapping(index: 'foo', type: 'bar')).to eq({})
-    end
-  end
-
-  context 'when multiple indices are specified' do
-
-    let(:url) do
-      'foo,bar/baz'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_mapping(index: ['foo','bar'], type: 'baz')).to eq({})
-    end
-  end
-
-  context 'when the path must be URL-escaped' do
-
-    let(:url) do
-      'foo%5Ebar/bar%2Fbam'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_mapping(index: 'foo^bar', type: 'bar/bam')).to eq({})
-    end
-  end
-end

data/spec/elasticsearch/api/actions/indices/delete_warmer_spec.rb

@@ -1,86 +0,0 @@
-require 'spec_helper'
-
-describe 'client.indices#delete_warmer' do
-
-  let(:expected_args) do
-    [
-        'DELETE',
-        url,
-        params,
-        nil,
-        nil
-    ]
-  end
-
-  let(:params) do
-    {}
-  end
-
-  context 'when an index is not specified' do
-
-    let(:client) do
-      Class.new { include Elasticsearch::API }.new
-    end
-
-    it 'raises an exception' do
-      expect {
-        client.indices.delete_warmer
-      }.to raise_exception(ArgumentError)
-    end
-  end
-
-  context 'when an index is specified' do
-
-    let(:url) do
-      'foo/_warmer'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_warmer(index: 'foo')).to eq({})
-    end
-  end
-
-  context 'when multiple indices are specified' do
-
-    let(:url) do
-      'foo,bar/_warmer'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_warmer(index: ['foo', 'bar'])).to eq({})
-    end
-  end
-
-  context 'when a single warmer is specified' do
-
-    let(:url) do
-      'foo/_warmer/bar'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_warmer(index: 'foo', name: 'bar')).to eq({})
-    end
-  end
-
-  context 'when a multiple warmers are specified' do
-
-    let(:url) do
-      'foo/_warmer/bar,baz'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_warmer(index: 'foo', name: ['bar', 'baz'])).to eq({})
-    end
-  end
-
-  context 'when the path needs to be URL-escaped' do
-
-    let(:url) do
-      'foo%5Ebar/_warmer/bar%2Fbam'
-    end
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_warmer(index: 'foo^bar', name: 'bar/bam')).to eq({})
-    end
-  end
-end