gemini-ai 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80621f6cd2de526141e994a339d645b53492f6ece960955bc56f2e7430be1d0c
-  data.tar.gz: b627386a0dacc899112e0b08806f63b571dd980f2fb749df7681d7c70656d707
+  metadata.gz: 36be77448ab7ba00008ac7548c25fdca45b92980762303631de5d6bdbcd2d01a
+  data.tar.gz: e0772790afa6019424282e8ac665fb0049da13a76ecc43909b147655f6f95a3a
 SHA512:
-  metadata.gz: f5425c3239dac6eca23cccdb2483f90bea23500b0830b865e8acc0fe235cf2ad3cb001d110e7a6ec0cbb59ed5c2f65e74f883edef961cb675b76e7d6117d88fc
-  data.tar.gz: 041122dc5a6d1d596411ea697503aa8d7846b4d2bc6c493b8b7d9102033c9ef3226957340d8caeb443751f9f4f465624a80ef1749e0f5893833e4c72d43ba907
+  metadata.gz: e4d6c7391dff2ce75a46e3ceb5c7ef9c07c6cdcfc55477df68be1df2e06f77ff77d795ee6e70abc9ad73001e8dd583d39949a394140b129d08c2db94c2b8f7c4
+  data.tar.gz: 2acedebdfe562b7b68d19046a2f2b06bec6fbe75768cc7066b7c1e31cb72bc4caa551a8d656ffc6537c714f0d11965f3cc9f74542e7bc9315f0998f35390d5f4

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    gemini-ai (3.0.0)
+    gemini-ai (3.1.0)
       event_stream_parser (~> 1.0)
-      faraday (~> 2.7, >= 2.7.12)
+      faraday (~> 2.8, >= 2.8.1)
       googleauth (~> 1.9, >= 1.9.1)
 
 GEM
@@ -16,7 +16,7 @@ GEM
     byebug (11.1.3)
     coderay (1.1.3)
     event_stream_parser (1.0.0)
-    faraday (2.7.12)
+    faraday (2.8.1)
       base64
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)

data/README.md

@@ -9,7 +9,7 @@ A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/ge
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 3.0.0'
+gem 'gemini-ai', '~> 3.1.0'
 ```
 
 ```ruby
@@ -96,6 +96,8 @@ Result:
     - [Back-and-Forth Conversations](#back-and-forth-conversations)
     - [Tools (Functions) Calling](#tools-functions-calling)
     - [New Functionalities and APIs](#new-functionalities-and-apis)
+    - [Request Options](#request-options)
+        - [Timeout](#timeout)
     - [Error Handling](#error-handling)
         - [Rescuing](#rescuing)
         - [For Short](#for-short)
@@ -112,11 +114,11 @@ Result:
 ### Installing
 
 ```sh
-gem install gemini-ai -v 3.0.0
+gem install gemini-ai -v 3.1.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 3.0.0'
+gem 'gemini-ai', '~> 3.1.0'
 ```
 
 ### Credentials
@@ -872,6 +874,42 @@ result = client.request(
 )
 ```
 
+### Request Options
+
+#### Timeout
+
+You can set the maximum number of seconds to wait for the request to complete with the `timeout` option:
+
+```ruby
+client = Gemini.new(
+  credentials: { service: 'vertex-ai-api', region: 'us-east4' },
+  options: {
+    model: 'gemini-pro',
+    connection: { request: { timeout: 5 } }
+  }
+)
+```
+
+You can also have more fine-grained control over [Faraday's Request Options](https://lostisland.github.io/faraday/#/customization/request-options?id=request-options) if you prefer:
+
+```ruby
+client = Gemini.new(
+  credentials: { service: 'vertex-ai-api', region: 'us-east4' },
+  options: {
+    model: 'gemini-pro',
+    connection: {
+      request: {
+        timeout: 5,
+        open_timeout: 5,
+        read_timeout: 5,
+        write_timeout: 5
+      }
+    }
+  }
+)
+```
+
+
 ### Error Handling
 
 #### Rescuing
@@ -942,7 +980,7 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-3.0.0.gem
+gem push gemini-ai-3.1.0.gem
 ```
 
 ### Updating the README

data/controllers/client.rb

@@ -10,6 +10,8 @@ require_relative '../ports/dsl/gemini-ai/errors'
 module Gemini
   module Controllers
     class Client
+      ALLOWED_REQUEST_OPTIONS = %i[timeout open_timeout read_timeout write_timeout].freeze
+
       def initialize(config)
         if config[:credentials][:api_key]
           @authentication = :api_key
@@ -43,6 +45,16 @@ module Gemini
                    end
 
         @server_sent_events = config[:options][:server_sent_events]
+
+        @request_options = config.dig(:options, :connection, :request)
+
+        @request_options = if @request_options.is_a?(Hash)
+                             @request_options.select do |key, _|
+                               ALLOWED_REQUEST_OPTIONS.include?(key)
+                             end
+                           else
+                             {}
+                           end
       end
 
       def stream_generate_content(payload, server_sent_events: nil, &callback)
@@ -74,8 +86,9 @@ module Gemini
 
         results = []
 
-        response = Faraday.new do |faraday|
+        response = Faraday.new(request: @request_options) do |faraday|
           faraday.response :raise_error
+          faraday.options.timeout = @timeout if @timeout
         end.post do |request|
           request.url url
           request.headers['Content-Type'] = 'application/json'

data/gemini-ai.gemspec

@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['ports/dsl']
 
   spec.add_dependency 'event_stream_parser', '~> 1.0'
-  spec.add_dependency 'faraday', '~> 2.7', '>= 2.7.12'
+  spec.add_dependency 'faraday', '~> 2.8', '>= 2.8.1'
   spec.add_dependency 'googleauth', '~> 1.9', '>= 1.9.1'
 
   spec.metadata['rubygems_mfa_required'] = 'true'

data/static/gem.rb

@@ -3,7 +3,7 @@
 module Gemini
   GEM = {
     name: 'gemini-ai',
-    version: '3.0.0',
+    version: '3.1.0',
     author: 'gbaptista',
     summary: "Interact with Google's Gemini AI.",
     description: "A Ruby Gem for interacting with Gemini through Vertex AI, Generative Language API, or AI Studio, Google's generative AI services.",

data/template.md

@@ -9,7 +9,7 @@ A Ruby Gem for interacting with [Gemini](https://deepmind.google/technologies/ge
 ## TL;DR and Quick Start
 
 ```ruby
-gem 'gemini-ai', '~> 3.0.0'
+gem 'gemini-ai', '~> 3.1.0'
 ```
 
 ```ruby
@@ -77,11 +77,11 @@ Result:
 ### Installing
 
 ```sh
-gem install gemini-ai -v 3.0.0
+gem install gemini-ai -v 3.1.0
 ```
 
 ```sh
-gem 'gemini-ai', '~> 3.0.0'
+gem 'gemini-ai', '~> 3.1.0'
 ```
 
 ### Credentials
@@ -837,6 +837,42 @@ result = client.request(
 )
 ```
 
+### Request Options
+
+#### Timeout
+
+You can set the maximum number of seconds to wait for the request to complete with the `timeout` option:
+
+```ruby
+client = Gemini.new(
+  credentials: { service: 'vertex-ai-api', region: 'us-east4' },
+  options: {
+    model: 'gemini-pro',
+    connection: { request: { timeout: 5 } }
+  }
+)
+```
+
+You can also have more fine-grained control over [Faraday's Request Options](https://lostisland.github.io/faraday/#/customization/request-options?id=request-options) if you prefer:
+
+```ruby
+client = Gemini.new(
+  credentials: { service: 'vertex-ai-api', region: 'us-east4' },
+  options: {
+    model: 'gemini-pro',
+    connection: {
+      request: {
+        timeout: 5,
+        open_timeout: 5,
+        read_timeout: 5,
+        write_timeout: 5
+      }
+    }
+  }
+)
+```
+
+
 ### Error Handling
 
 #### Rescuing
@@ -907,7 +943,7 @@ gem build gemini-ai.gemspec
 
 gem signin
 
-gem push gemini-ai-3.0.0.gem
+gem push gemini-ai-3.1.0.gem
 ```
 
 ### Updating the README

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gemini-ai
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - gbaptista
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-17 00:00:00.000000000 Z
+date: 2023-12-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: event_stream_parser
@@ -30,20 +30,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.12
+        version: 2.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.12
+        version: 2.8.1
 - !ruby/object:Gem::Dependency
   name: googleauth
   requirement: !ruby/object:Gem::Requirement
@@ -109,7 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.3.3
 signing_key: 
 specification_version: 4
 summary: Interact with Google's Gemini AI.