elasticsearch-api 6.8.3 → 7.0.0.pre

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

@@ -1,77 +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 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,29 +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 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,67 +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 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,53 +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 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,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#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,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#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,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#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,56 +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#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,81 +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.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,90 +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.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