ruby-gemini-api 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd1be2a2b81543d21686e9d4ade4de2e6aa42ea8b26abc4bb0929e9aa77fada0
-  data.tar.gz: 9b96121c0a8a68220e4e368057424211e29e0652f28f1812b56049842d31c5c9
+  metadata.gz: 325e8812a1eb58643280cdfba86f4a8a9a8e3659d882d8fb5fc5e4ac2025a35c
+  data.tar.gz: 1bcf959e036341fe71a41a693accc9f0d85a0fe790f43811a2af7ae3b455e10b
 SHA512:
-  metadata.gz: be505ec75d011d31cd3c741924b2e845024d4bccdc36b3fbdfa63e0468771a45f7dd4abbc31ec6ade82ff4e992b46bd9e3aa65a06bd874a73a799f1cdb246bed
-  data.tar.gz: edcc02ff33b17e56a004836b2c55c7a133d883bc38c9f67893f3d3a59afb239bf7329454ef8278cf618e2d393867e445dc88bf539350999258c856f02c775b69
+  metadata.gz: 243dd3d0f56a645305e1345de08ca7512088e0d7ae2dfd45f2b5747614c469ed35523991da8cb7d4bef08f060b0cbfb666903e0b5c262e18cebece66405753b9
+  data.tar.gz: fa2234b64394200ab6039010f88d5b9ac97c70e4e4266943b0ee57848e7f0141bebe3a50929d315bb54b4ddd88c990c07d3a26cf54f904b1e89727a53a4c8a12

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+### Added
+- Code Execution shortcut support via `code_execution: true` on `generate_content` / `generate_content_stream`
+- `Response` helpers for Code Execution results: `#code_execution?`, `#executable_code`, `#executable_codes`, `#code_execution_output`, `#code_execution_outcome`, `#code_execution_success?`, `#code_execution_results`
+
 ## [1.2.0] - 2026-05-14
 
 ### Added

data/README.md

@@ -34,6 +34,7 @@ This project is inspired by and pays homage to [ruby-openai](https://github.com/
 - Token counting (`countTokens`) for prompts, chat history, and full requests with system instruction / tools / cached content
 - Speech generation (TTS) with 30 prebuilt voices, single-speaker and multi-speaker modes, and one-line WAV file output
 - Live API: real-time bidirectional conversations with text/audio/video and function calling (sync and async)
+- Code Execution: let the model generate and run Python code, then inspect generated code and execution results
 
 ### Function Calling
 
@@ -110,11 +111,65 @@ puts "After deleting a function: #{all_tools.list_functions}"
 # => After deleting a function: [:get_current_weather, :send_email]
 ```
 
+### Code Execution
+
+Pass `code_execution: true` to let Gemini generate and run Python code when it helps answer calculation or data-processing tasks.
+
+```ruby
+require 'gemini'
+
+client = Gemini::Client.new(ENV['GEMINI_API_KEY'])
+
+response = client.generate_content(
+  "Calculate the sum of the first 50 prime numbers and show the code you used",
+  model: "gemini-3.5-flash",
+  code_execution: true
+)
+
+puts response.text
+
+if response.code_execution?
+  puts response.executable_code
+  puts response.code_execution_outcome
+  puts response.code_execution_output
+end
+```
+
+You can also inspect all generated code and execution results:
+
+```ruby
+response.executable_codes          # => [{"language"=>"PYTHON", "code"=>"..."}]
+response.code_execution_results    # => [{"outcome"=>"OUTCOME_OK", "output"=>"..."}]
+response.code_execution_success?   # => true
+```
+
+Code Execution also works with image inputs. For Gemini 3 models, combine it with `thinking_level` when you want the model to inspect an image with code.
+
+```ruby
+response = client.generate_content(
+  [
+    { type: "text", text: "Read the small numbers in this image" },
+    { type: "image_file", image_file: { file_path: "meter.jpg" } }
+  ],
+  model: "gemini-3.5-flash",
+  code_execution: true,
+  thinking_level: :medium
+)
+```
+
+A complete example is available in `demo/code_execution_demo.rb`.
+
 ### Thinking Feature
 
 Gemini 2.5 and later models support the Thinking feature, which enables the model to perform internal reasoning processes for complex problems to generate higher-quality answers.
 
-#### Using with Gemini 2.5: `thinking_budget`
+#### Deprecation notice: thinking and sampling controls
+
+For Gemini 3 and later models, prefer `thinking_level` (`:minimal`, `:low`, `:medium`, `:high`) instead of `thinking_budget`. The `thinking_budget` option remains available for Gemini 2.5 compatibility, but it should be treated as a legacy control when targeting newer models.
+
+Sampling parameters such as `temperature`, `top_p`, and `top_k` are also considered legacy tuning knobs for newer Gemini models. Existing code can continue to pass them through for backward compatibility, but new integrations should rely on model defaults and Thinking controls first.
+
+#### Legacy Gemini 2.5 usage: `thinking_budget`
 
 ```ruby
 require 'gemini'
@@ -145,7 +200,7 @@ response = client.generate_content(
 )
 ```
 
-#### Using with Gemini 3: `thinking_level`
+#### Recommended Gemini 3 usage: `thinking_level`
 
 ```ruby
 # Specify thinking level (:minimal, :low, :medium, :high)
@@ -1675,6 +1730,7 @@ The gem includes several demo applications that showcase its functionality:
 - `demo/file_audio_demo.rb` - Audio transcription with large audio files
 - `demo/structured_output_demo.rb` - Structured JSON output with schema
 - `demo/enum_response_demo.rb` - Enum-constrained responses
+- `demo/code_execution_demo.rb` - Code Execution with generated Python code and execution output
 - `demo/thinking_demo.rb` - Thinking feature (Gemini 2.5)
 - `demo/thinking_gemini3_demo.rb` - Thinking feature (Gemini 3)
 - `demo/document_chat_demo.rb` - Document processing
@@ -1724,6 +1780,12 @@ ruby demo/structured_output_demo.rb
 # Enum-constrained responses
 ruby demo/enum_response_demo.rb
 
+# Code Execution
+ruby demo/code_execution_demo.rb
+
+# Code Execution with a different model
+GEMINI_MODEL=gemini-3.5-pro ruby demo/code_execution_demo.rb
+
 # Thinking feature (Gemini 2.5)
 ruby demo/thinking_demo.rb
 
@@ -1745,11 +1807,16 @@ ruby demo/embeddings_demo.rb
 
 ## Models
 
-The library supports various Gemini models:
+Model names can be passed as strings. Common examples:
 
+- `gemini-3.5-flash`
+- `gemini-3.5-pro`
+- `gemini-3-flash-preview`
 - `gemini-2.5-flash`
 - `gemini-2.5-pro`
 
+Use `client.models.list` to check models available to your API key.
+
 ## Requirements
 
 - Ruby 3.0 or higher
@@ -1766,4 +1833,4 @@ The library supports various Gemini models:
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/gemini/client.rb

@@ -202,6 +202,7 @@ module Gemini
     def generate_content(prompt, model: "gemini-2.5-flash", system_instruction: nil,
                         response_mime_type: nil, response_schema: nil, temperature: 0.5, tools: nil,
                         url_context: false, google_search: false,
+                        code_execution: false,
                         thinking_budget: nil, thinking_level: nil,
                         **parameters, &stream_callback)
       content = format_content(prompt)
@@ -230,7 +231,12 @@ module Gemini
       end
 
       # Handle tool shortcuts
-      tools = build_tools_array(tools, url_context: url_context, google_search: google_search)
+      tools = build_tools_array(
+        tools,
+        url_context: url_context,
+        google_search: google_search,
+        code_execution: code_execution
+      )
       params[:tools] = tools if tools && !tools.empty?
 
       params.merge!(parameters)
@@ -245,7 +251,8 @@ module Gemini
     # Streaming text generation
     def generate_content_stream(prompt, model: "gemini-2.5-flash", system_instruction: nil,
                               response_mime_type: nil, response_schema: nil, temperature: 0.5,
-                              url_context: false, google_search: false, **parameters, &block)
+                              url_context: false, google_search: false, code_execution: false,
+                              **parameters, &block)
       raise ArgumentError, "Block is required for streaming" unless block_given?
 
       content = format_content(prompt)
@@ -270,7 +277,12 @@ module Gemini
       params[:generation_config]["temperature"] = temperature
 
       # Handle tool shortcuts
-      tools = build_tools_array(nil, url_context: url_context, google_search: google_search)
+      tools = build_tools_array(
+        nil,
+        url_context: url_context,
+        google_search: google_search,
+        code_execution: code_execution
+      )
       params[:tools] = tools if tools && !tools.empty?
 
       # Merge other parameters
@@ -535,7 +547,7 @@ module Gemini
     end
 
     # Build tools array from explicit tools parameter and shortcuts
-    def build_tools_array(tools, url_context: false, google_search: false)
+    def build_tools_array(tools, url_context: false, google_search: false, code_execution: false)
       result_tools = []
 
       # Add existing tools if provided
@@ -551,6 +563,9 @@ module Gemini
       # Add google_search tool if requested
       result_tools << { google_search: {} } if google_search
 
+      # Add code_execution tool if requested
+      result_tools << { code_execution: {} } if code_execution
+
       # Remove duplicates based on tool keys and return
       return nil if result_tools.empty?
       result_tools.uniq { |tool| tool.keys.first }
@@ -685,4 +700,4 @@ module Gemini
       end
     end
   end
-end
+end

data/lib/gemini/response.rb

@@ -37,6 +37,54 @@ module Gemini
       
       parts.select { |part| part.key?("text") }.map { |part| part["text"] }
     end
+
+    # Get all executableCode parts returned by the Code Execution tool.
+    def executable_codes
+      return [] unless valid?
+
+      parts.map { |part| part["executableCode"] || part["executable_code"] }.compact
+    end
+
+    # Get the first generated code string from a Code Execution response.
+    def executable_code
+      code_part = executable_codes.first
+      return nil unless code_part
+
+      code_part["code"] || code_part[:code]
+    end
+
+    # Get all codeExecutionResult parts returned by the Code Execution tool.
+    def code_execution_results
+      return [] unless valid?
+
+      parts.map { |part| part["codeExecutionResult"] || part["code_execution_result"] }.compact
+    end
+
+    # Get the first execution output string from a Code Execution response.
+    def code_execution_output
+      result_part = code_execution_results.first
+      return nil unless result_part
+
+      result_part["output"] || result_part[:output]
+    end
+
+    # Get the first execution outcome (for example "OUTCOME_OK").
+    def code_execution_outcome
+      result_part = code_execution_results.first
+      return nil unless result_part
+
+      result_part["outcome"] || result_part[:outcome]
+    end
+
+    # True when the first Code Execution result completed successfully.
+    def code_execution_success?
+      code_execution_outcome == "OUTCOME_OK"
+    end
+
+    # True if the response contains generated code or execution results.
+    def code_execution?
+      !executable_codes.empty? || !code_execution_results.empty?
+    end
     
     # Get image parts (if any)
     def image_parts
@@ -650,4 +698,4 @@ module Gemini
       end
     end
   end
-end
+end

data/lib/gemini/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gemini
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-gemini-api
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - rira100000000
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -194,6 +195,7 @@ metadata:
   source_code_uri: https://github.com/rira100000000/ruby-gemini-api
   changelog_uri: https://github.com/rira100000000/ruby-gemini-api/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -208,7 +210,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.3.26
+signing_key:
 specification_version: 4
 summary: Ruby client for Google's Gemini API
 test_files: []