add advanced parallel requests example and dependency to leverate Faraday implementation

Author: jvmvik

Gemfile

@@ -20,6 +20,9 @@ group :test, :development do
   # code coverage to monitor rspec tests
   gem 'simplecov'
 
+  # for client_async_spec.rb
+  gem 'async-http-faraday'
+  
   # platforms :mri do
   #   gem "byebug"
   #   gem "pry"

README.md

@@ -12,8 +12,9 @@ SerpApi supports Google, Google Maps, Google Shopping, Baidu, Yandex, Yahoo, eBa
 
 ## Installation
 
-Ruby 3+ must be installed for best performance the latest version 3.4 is recommended.
- For older version of Ruby 1.9 and 2.x or JRuby, our older library is still functional.
+To achieve optimal performance, it is essential to have Ruby 3.x (preferably version 3.4) installed. 
+
+| Older versions such as Ruby 1.9, 2.x, and JRuby are compatible with [serpapi older library](https://github.com/serpapi/google-search-results-ruby), which continues to function effectively.
 
 ### Bundler
 ```ruby
@@ -176,6 +177,30 @@ data = client.search(q: 'Coffee', location: 'Austin, TX')
 pp data
 ```
 
+or a more [advanced parallel requests example](https://lostisland.github.io/faraday/#/advanced/parallel-requests)
+
+```ruby
+# install and load
+require 'async/http/faraday'
+
+# initialize the client
+client = SerpApi::Client.new(adapter: :async_http, api_key: ENV['API_KEY'], timeout: 10)
+
+# run same query in parallel
+Async do
+  Async do
+    data = client.search(engine: 'google', q: 'Coffee', location: 'Austin, TX')
+    expect(data.keys.size).to be > 5
+    expect(data.dig(:search_metadata,:id)).not_to be_nil
+  end
+  Async do
+    data = client.search(engine: 'youtube', search_query: 'Coffee', location: 'Austin, TX')
+    expect(data.keys.size).to be > 5
+    expect(data.dig(:search_metadata,:id)).not_to be_nil
+  end
+end
+```
+
 ## Basic example per search engine
 
 Here is how to calls the APIs.

README.md.erb

@@ -31,8 +31,9 @@ SerpApi supports Google, Google Maps, Google Shopping, Baidu, Yandex, Yahoo, eBa
 
 ## Installation
 
-Ruby 3+ must be installed for best performance the latest version 3.4 is recommended.
- For older version of Ruby 1.9 and 2.x or JRuby, our older library is still functional.
+To achieve optimal performance, it is essential to have Ruby 3.x (preferably version 3.4) installed. 
+
+| Older versions such as Ruby 1.9, 2.x, and JRuby are compatible with [serpapi older library](https://github.com/serpapi/google-search-results-ruby), which continues to function effectively.
 
 ### Bundler
 ```ruby
@@ -195,6 +196,30 @@ data = client.search(q: 'Coffee', location: 'Austin, TX')
 pp data
 ```
 
+or a more [advanced parallel requests example](https://lostisland.github.io/faraday/#/advanced/parallel-requests)
+
+```ruby
+# install and load
+require 'async/http/faraday'
+
+# initialize the client
+client = SerpApi::Client.new(adapter: :async_http, api_key: ENV['API_KEY'], timeout: 10)
+
+# run same query in parallel
+Async do
+  Async do
+    data = client.search(engine: 'google', q: 'Coffee', location: 'Austin, TX')
+    expect(data.keys.size).to be > 5
+    expect(data.dig(:search_metadata,:id)).not_to be_nil
+  end
+  Async do
+    data = client.search(engine: 'youtube', search_query: 'Coffee', location: 'Austin, TX')
+    expect(data.keys.size).to be > 5
+    expect(data.dig(:search_metadata,:id)).not_to be_nil
+  end
+end
+```
+
 ## Basic example per search engine
 
 Here is how to calls the APIs.

spec/serpapi/client/client_async_spec.rb

@@ -0,0 +1,30 @@
+# Run search in parallel using Async 
+#   and Gem async/http/faraday
+#
+# https://lostisland.github.io/faraday/#/advanced/parallel-requests
+#
+
+require 'spec_helper'
+require 'async/http/faraday'
+
+describe 'client adapter with async/http/faraday' do
+
+  it 'test httpclient (requires faraday/httpclient)' do
+    adapter = :async_http
+    client = SerpApi::Client.new(api_key: ENV['API_KEY'], timeout: 10, adapter: adapter)
+
+    # run same query in parallel
+    Async do
+      Async do
+        data = client.search(engine: 'google', q: 'Coffee', location: 'Austin, TX')
+        expect(data.keys.size).to be > 5
+        expect(data.dig(:search_metadata,:id)).not_to be_nil
+      end
+      Async do
+        data = client.search(engine: 'youtube', search_query: 'Coffee', location: 'Austin, TX')
+        expect(data.keys.size).to be > 5
+        expect(data.dig(:search_metadata,:id)).not_to be_nil
+      end
+    end
+  end
+end

spec/serpapi/client/client_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 require 'faraday/httpclient'
 
-describe 'client full coverage' do
+describe 'client full code coverage' do
   before(:all) do
     @client = SerpApi::Client.new(engine: 'google', api_key: ENV['API_KEY'], timeout: 30)
   end
@@ -66,7 +66,7 @@
   end
 end
 
-describe 'client adapter' do
+describe 'client adapter with httpclient' do
 
   it 'test httpclient (requires faraday/httpclient)' do
     client = SerpApi::Client.new(engine: 'google', api_key: ENV['API_KEY'], timeout: 10, adapter: :httpclient)
@@ -76,4 +76,5 @@
     expect(data.keys.size).to be > 5
     expect(data[:search_metadata][:id]).not_to be_nil
   end
+
 end

spec/spec_helper.rb

@@ -1,8 +1,8 @@
 # code coverage
-# require 'simplecov'
-# SimpleCov.start 'rails'
+require 'simplecov'
+SimpleCov.start
 
-# # load libary
+# load libary
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 require 'serpapi'