elastic-app-search 7.4.1 → 7.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ad2aa4de4232586f616793b6f55332dde5d122fbe79ac5f80c62c42fa93bb07
-  data.tar.gz: 5413783fa304ac1c71b317f982a20d4d2d35b2eb6782721df285dd9ce58eadb0
+  metadata.gz: efad053bb4bb7a4d9c0728b30859859d7c05dec002ca2be7db6b14fc9bf6d266
+  data.tar.gz: efed177fb0ac62bc23183b950bebf16236a7222ef933a698c1b66677ebc1d8c3
 SHA512:
-  metadata.gz: 4896a9fb557f51ad81e44af96114d38463743781c777e93ff4b07d770b8cd941f48cb3cb5e7005a4282ea92d7859e8286bd1572152a10539bd50e63b07593b94
-  data.tar.gz: b235d0390fcb69242ad2dc23e400d042ea33278cdcb8038b06b4c9f32b8aec7cc9ccbd6117aaa06301f7858a88696c020aa8fc1710f2237da493f64de1768f33
+  metadata.gz: e1bdab12e9e55db046f03b55ad263f56b59d70a48b959768c418961247bf7d91187531e74a007ec99ed0329c9d11574e6af21fa4426a8c5fb3f25282de008be4
+  data.tar.gz: a90180b52b7ad3a615fbb2d6bc9f89729893343b3a9a671067c8c02323b2e3959dcd081d03064db129927f550f16142424ec9b16e3198e01fe3898b35d3d4635

data/README.md

@@ -2,7 +2,7 @@
 
 <p align="center"><a href="https://circleci.com/gh/elastic/app-search-ruby"><img src="https://circleci.com/gh/elastic/app-search-ruby.svg?style=svg" alt="CircleCI build"></a></p>
 
-> A first-party Ruby client for building excellent, relevant search experiences with Elastic App Search.
+> A first-party Ruby client for building excellent, relevant search experiences with [Elastic App Search](https://www.elastic.co/products/app-search).
 
 ## Contents
 
@@ -25,7 +25,7 @@ To install the gem, execute:
 gem install elastic-app-search
 ```
 
-Or place `gem 'elastic-app-search', '~> 7.4.1'` in your `Gemfile` and run `bundle install`.
+Or place `gem 'elastic-app-search', '~> 7.9.0'` in your `Gemfile` and run `bundle install`.
 
 ## Versioning
 
@@ -35,34 +35,37 @@ To guarantee compatibility, use the most recent version of this library within t
 
 For example, for App Search `7.3`, use `7.3` of this library or above, but not `8.0`.
 
-If you are a [SaaS](https://app.swiftype.com/as) user, simply use the most recent version of this library.
+If you are using the [SaaS version available on swiftype.com](https://app.swiftype.com/as) of App Search, you should use the version 7.5.x of the client.
 
 ## Usage
 
-### Setup: Configuring the client and authentication
+#### Setup: Configuring the client and authentication
 
-Create a new instance of the Elastic App Search Client. This requires your `[HOST_IDENTIFIER]`, which
-identifies the unique hostname of the App Search API that is associated with your App Search account.
-It also requires a valid `[API_KEY]`, which authenticates requests to the API. You can use any key type with the client, however each has a different scope. For more information on keys, check out the [documentation](https://swiftype.com/documentation/app-search/credentials).
+Using this client assumes that you have already an instance of [Elastic App Search](https://www.elastic.co/products/app-search) up and running.
 
-You can find your `[API_KEY]` and your `[HOST_IDENTIFIER]` within the [Credentials](https://app.swiftype.com/as/credentials) menu:
+Once done, a client can be instantiated using the `[API_KEY]` and the `[API_ENDPOINT]` URL of your App Search setup:
 
 ```ruby
 require 'elastic-app-search'
 
-client = Elastic::AppSearch::Client.new(:host_identifier => 'host-c5s2mj', :api_key => 'private-mu75psc5egt9ppzuycnc2mc3')
+client = Elastic::AppSearch::Client.new(:api_key => 'private-xxxxxxxxxxxxxxxxxxx', :api_endpoint => 'http://localhost:3002/api/as/v1/')
 ```
 
-### Using with App Search Managed Deploys
+Note:
 
-The client can be configured to use a managed deploy by using the
-`api_endpoint` parameter. Since managed deploys do not rely on a `[HOST_IDENTIFIER]`
-, it can be omitted.
+The `[API_KEY]` authenticates requests to the API.
+You can use any key type with the client, however each has a different scope.
+For more information on keys, check out the [documentation](https://swiftype.com/documentation/app-search/api/credentials).
+
+##### Swiftype.com App Search users:
+
+When using the [SaaS version available on swiftype.com](https://app.swiftype.com/as) of App Search, you can configure the client using your `[HOST_IDENTIFIER]` instead of the `[API_ENDPOINT]`.
+The `[HOST_IDENTIFIER]` can be found within the [Credentials](https://app.swiftype.com/as#/credentials) menu.
 
 ```ruby
 require 'elastic-app-search'
 
-client = Elastic::AppSearch::Client.new(:api_key => 'private-mu75psc5egt9ppzuycnc2mc3', :api_endpoint => 'http://localhost:3002/api/as/v1/')
+client = Elastic::AppSearch::Client.new(:host_identifier => 'host-c5s2mj', :api_key => 'private-xxxxxxxxxxxxxxxxxxx')
 ```
 
 ### API Methods
@@ -176,6 +179,33 @@ engine_name = 'favorite-videos'
 client.destroy_engine(engine_name)
 ```
 
+#### Creating Meta Engines
+
+```ruby
+engine_name = 'videos-engine'
+sources_engines = ['favorite-videos', 'all-videos']
+
+client.create_meta_engine(engine_name, source_engines)
+```
+
+#### Adding Meta Engines Source
+
+```ruby
+engine_name = 'videos-engine'
+sources_engines = ['fun-videos', 'cat-videos']
+
+client.add_meta_engine_sources(engine_name, source_engines)
+```
+
+#### Adding Meta Engines Source
+
+```ruby
+engine_name = 'videos-engine'
+sources_engines = ['nsfw-videos']
+
+client.delete_meta_engine_sources(engine_name, source_engines)
+```
+
 #### Searching
 
 ```ruby
@@ -277,6 +307,7 @@ Creating a search key that will only return the title field.
 
 ```ruby
 public_search_key = 'search-xxxxxxxxxxxxxxxxxxxxxxxx'
+# This name must match the name of the key above from your App Search dashboard
 public_search_key_name = 'search-key'
 enforced_options = {
   result_fields: { title: { raw: {} } },
@@ -285,7 +316,8 @@ enforced_options = {
 
 signed_search_key = Elastic::AppSearch::Client.create_signed_search_key(public_search_key, public_search_key_name, enforced_options)
 
-client = Elastic::AppSearch::Client.new(host_identifier: 'host-c5s2mj', api_key: signed_search_key)
+client = Elastic::AppSearch::Client.new(:api_key => signed_search_key, :api_endpoint => 'http://localhost:3002/api/as/v1/')
+
 client.search('national-parks-demo', 'everglade')
 ```
 

data/lib/elastic/app-search/client.rb

@@ -13,6 +13,7 @@ module Elastic
       autoload :Curations, 'elastic/app-search/client/curations'
       autoload :Documents, 'elastic/app-search/client/documents'
       autoload :Engines, 'elastic/app-search/client/engines'
+      autoload :MetaEngines, 'elastic/app-search/client/meta_engines'
       autoload :Logs, 'elastic/app-search/client/logs'
       autoload :Schema, 'elastic/app-search/client/schema'
       autoload :Search, 'elastic/app-search/client/search'
@@ -69,6 +70,7 @@ module Elastic
       include Elastic::AppSearch::Client::Curations
       include Elastic::AppSearch::Client::Documents
       include Elastic::AppSearch::Client::Engines
+      include Elastic::AppSearch::Client::MetaEngines
       include Elastic::AppSearch::Client::Logs
       include Elastic::AppSearch::Client::Schema
       include Elastic::AppSearch::Client::Search

data/lib/elastic/app-search/client/meta_engines.rb

@@ -0,0 +1,23 @@
+module Elastic
+  module AppSearch
+    class Client
+      module MetaEngines
+
+        ENGINE_TYPE_META = 'meta'.freeze()
+
+        def create_meta_engine(engine_name, source_engines)
+          post('engines', :name => engine_name, :type => ENGINE_TYPE_META, :source_engines => source_engines)
+        end
+
+        def add_meta_engine_sources(engine_name, source_engines)
+          post("engines/#{engine_name}/source_engines", source_engines)
+        end
+
+        def delete_meta_engine_sources(engine_name, source_engines)
+          delete("engines/#{engine_name}/source_engines", source_engines)
+        end
+
+      end
+    end
+  end
+end

data/lib/elastic/app-search/version.rb

@@ -1,5 +1,5 @@
 module Elastic
   module AppSearch
-    VERSION = '7.4.1'
+    VERSION = '7.9.0'
   end
 end

data/spec/client_spec.rb

@@ -27,17 +27,33 @@ describe Elastic::AppSearch::Client do
 
   describe 'Requests' do
     it 'should include client name and version in headers' do
-      stub_request(:any, "#{client_options[:host_identifier]}.api.swiftype.com/api/as/v1/engines")
-      client.list_engines
-      expect(WebMock).to(
-        have_requested(:get, "https://#{client_options[:host_identifier]}.api.swiftype.com/api/as/v1/engines")
-        .with(
-          :headers => {
-            'X-Swiftype-Client' => 'elastic-app-search-ruby',
-            'X-Swiftype-Client-Version' => Elastic::AppSearch::VERSION
-          }
+      if (client_options[:api_endpoint])
+        stub_request(:any, "#{client_options[:api_endpoint]}engines")
+        client.list_engines
+        expect(WebMock).to(
+          have_requested(:get, "#{client_options[:api_endpoint]}engines")
+          .with(
+            :headers => {
+              'X-Swiftype-Client' => 'elastic-app-search-ruby',
+              'X-Swiftype-Client-Version' => Elastic::AppSearch::VERSION
+            }
+          )
         )
-      )
+      else
+        # CI runs against saas, so we keep this around for now. CI should be updated
+        # to use slef-managed and we should drop support "host_identifier" this.
+        stub_request(:any, "#{client_options[:host_identifier]}.api.swiftype.com/api/as/v1/engines")
+        client.list_engines
+        expect(WebMock).to(
+          have_requested(:get, "https://#{client_options[:host_identifier]}.api.swiftype.com/api/as/v1/engines")
+          .with(
+            :headers => {
+              'X-Swiftype-Client' => 'elastic-app-search-ruby',
+              'X-Swiftype-Client-Version' => Elastic::AppSearch::VERSION
+            }
+          )
+        )
+      end
     end
   end
 

data/spec/documents_spec.rb

@@ -126,34 +126,5 @@ describe Elastic::AppSearch::Client::Documents do
         expect(response[1]['id']).to(eq(second_document_id))
       end
     end
-
-    describe '#list_documents' do
-      let(:documents) { [first_document, second_document] }
-      let(:first_document_id) { 'id' }
-      let(:first_document) { { 'id' => first_document_id, 'url' => 'https://www.youtube.com/watch?v=v1uyQZNg2vE' } }
-      let(:second_document_id) { 'another_id' }
-      let(:second_document) { { 'id' => second_document_id, 'url' => 'https://www.youtube.com/watch?v=9T1vfsHYiKY' } }
-
-      before do
-        client.index_documents(engine_name, documents)
-      end
-
-      context 'when no options are specified' do
-        it 'will return all documents' do
-          response = client.list_documents(engine_name)
-          expect(response['results'].size).to(eq(2))
-          expect(response['results'][0]['id']).to(eq(first_document_id))
-          expect(response['results'][1]['id']).to(eq(second_document_id))
-        end
-      end
-
-      context 'when options are specified' do
-        it 'will return all documents' do
-          response = client.list_documents(engine_name, :page => { :size => 1, :current => 2 })
-          expect(response['results'].size).to(eq(1))
-          expect(response['results'][0]['id']).to(eq(second_document_id))
-        end
-      end
-    end
   end
 end

data/spec/list_documents_spec.rb

@@ -0,0 +1,25 @@
+describe Elastic::AppSearch::Client::Documents do
+  include_context 'App Search Credentials'
+  include_context 'Static Test Engine'
+
+  let(:client) { Elastic::AppSearch::Client.new(client_options) }
+
+  context 'Documents' do
+    describe '#list_documents' do
+      context 'when no options are specified' do
+        it 'will return all documents' do
+          response = client.list_documents(engine_name)
+          expect(response['results'].size).to(eq(2))
+          expect(response['results'].map { |d| d['id'] }).to(include(document1['id'], document2['id']))
+        end
+      end
+
+      context 'when options are specified' do
+        it 'will return all documents' do
+          response = client.list_documents(engine_name, :page => { :size => 1, :current => 2 })
+          expect(response['results'].size).to(eq(1))
+        end
+      end
+    end
+  end
+end

data/spec/meta_engines_spec.rb

@@ -0,0 +1,73 @@
+describe Elastic::AppSearch::Client::MetaEngines do
+  include_context 'App Search Credentials'
+  include_context 'Engine Name'
+  include_context 'Meta Engine Name'
+  include_context 'Test Engine'
+
+  let(:client) { Elastic::AppSearch::Client.new(client_options) }
+  let(:source_engines) { [engine_name] }
+
+  # CI currently runs against SaaS. This feature is a Self-Managed only feature.
+  context 'Meta Engines', :skip => "Unable to test Self-Managed features in CI." do
+
+    after do
+      client.destroy_engine(meta_engine_name) rescue Elastic::AppSearch::NonExistentRecord
+    end
+
+    context '#create_meta_engine' do
+      it 'should create a meta engine when given a right set of parameters' do
+        expect { client.get_engine(meta_engine_name) }.to raise_error(Elastic::AppSearch::NonExistentRecord)
+        client.create_meta_engine(meta_engine_name, source_engines)
+        expect { client.get_engine(meta_engine_name) }.to_not raise_error
+      end
+
+      it 'should return a meta engine object' do
+        engine = client.create_meta_engine(meta_engine_name, source_engines)
+        expect(engine).to be_kind_of(Hash)
+        expect(engine['name']).to eq(meta_engine_name)
+        expect(engine['type']).to eq('meta')
+        expect(engine['source_engines']).to eq(source_engines)
+      end
+
+      it 'should return an error when the engine source engine is empty' do
+        expect { client.create_meta_engine(engine_name, []) }.to(raise_error) do |e|
+          expect(e).to be_a(Elastic::AppSearch::BadRequest)
+          expect(e.errors).to eq(['Source engines are required for meta engines'])
+        end
+      end
+    end
+
+    context '#add_meta_engine_sources' do
+      before do
+        client.create_meta_engine(meta_engine_name, source_engines)
+        client.delete_meta_engine_sources(meta_engine_name, source_engines)
+      end
+
+      it 'should add the source engine' do
+        expect { client.add_meta_engine_sources(meta_engine_name, source_engines) }.to_not raise_error do |engine|
+          expect(engine).to be_kind_of(Hash)
+          expect(engine['name']).to eq(meta_engine_name)
+          expect(engine['type']).to eq('meta')
+          expect(engine['source_engines']).to be_kind_of(Array)
+          expect(engine['source_engines']).to eq(source_engines)
+        end
+      end
+    end
+
+    context '#delete_meta_engine_sources' do
+      before do
+        client.create_meta_engine(meta_engine_name, source_engines)
+      end
+
+      it 'should remove the source engine' do
+        expect { client.delete_meta_engine_sources(meta_engine_name, source_engines) }.to_not raise_error do |engine|
+          expect(engine).to be_kind_of(Hash)
+          expect(engine['name']).to eq(meta_engine_name)
+          expect(engine['type']).to eq('meta')
+          expect(engine['source_engines']).to be_kind_of(Array)
+          expect(engine['source_engines']).to be_empty
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -54,6 +54,10 @@ RSpec.shared_context 'Engine Name' do
   let(:engine_name) { "ruby-client-test-#{SecureRandom.hex}" }
 end
 
+RSpec.shared_context 'Meta Engine Name' do
+  let(:meta_engine_name) { "ruby-client-test-#{SecureRandom.hex}" }
+end
+
 RSpec.shared_context 'Test Engine' do
   let(:engine_name) { "ruby-client-test-#{SecureRandom.hex}" }
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elastic-app-search
 version: !ruby/object:Gem::Version
-  version: 7.4.1
+  version: 7.9.0
 platform: ruby
 authors:
 - Quin Hoxie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-09 00:00:00.000000000 Z
+date: 2020-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -114,6 +114,7 @@ files:
 - lib/elastic/app-search/client/documents.rb
 - lib/elastic/app-search/client/engines.rb
 - lib/elastic/app-search/client/logs.rb
+- lib/elastic/app-search/client/meta_engines.rb
 - lib/elastic/app-search/client/query_suggestion.rb
 - lib/elastic/app-search/client/schema.rb
 - lib/elastic/app-search/client/search.rb
@@ -134,7 +135,9 @@ files:
 - spec/documents_spec.rb
 - spec/engines_spec.rb
 - spec/exceptions_spec.rb
+- spec/list_documents_spec.rb
 - spec/logs_spec.rb
+- spec/meta_engines_spec.rb
 - spec/query_suggestion_spec.rb
 - spec/schema_spec.rb
 - spec/search_settings_spec.rb
@@ -160,8 +163,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Official gem for accessing the Elastic App Search API
@@ -175,7 +177,9 @@ test_files:
 - spec/documents_spec.rb
 - spec/engines_spec.rb
 - spec/exceptions_spec.rb
+- spec/list_documents_spec.rb
 - spec/logs_spec.rb
+- spec/meta_engines_spec.rb
 - spec/query_suggestion_spec.rb
 - spec/schema_spec.rb
 - spec/search_settings_spec.rb