Suppress a Ruby 3.4 warning for URI parser (#980)

This PR suppresses the following Ruby 3.4's warning. e.g.;

```console
$ ruby -v
ruby 3.4.3 (2025-04-14 revision d0b7e5b6a0) +PRISM [x86_64-darwin24]
$ RUBYOPT=-w bundle exec rspec spec/langchain/loader_spec.rb
/Users/koic/src/github.com/patterns-ai-core/langchainrb/lib/langchain/loader.rb:94:
warning: URI::RFC3986_PARSER.escape is obsolete. Use URI::RFC2396_PARSER.escape explicitly.
```

Compatibility with Ruby 3.1 supported by Langchain.rb is preserved.

Co-authored-by: Andrei Bondarev <[email protected]>

Author: koic

CHANGELOG.md

@@ -9,6 +9,9 @@
 - [DOCS]: Documentation changes. No changes to the library's behavior.
 - [SECURITY]: A change which fixes a security vulnerability.
 
+## [Unreleased]
+- [COMPAT] [https://github.com/patterns-ai-core/langchainrb/pull/980] Suppress a Ruby 3.4 warning for URI parser.
+
 ## [0.19.5]
 - [BREAKING] [https://github.com/patterns-ai-core/langchainrb/pull/859] Add metadata support to PgVector storage
 - [BUGFIX] [https://github.com/patterns-ai-core/langchainrb/pull/939] Fix Langchain::Vectorsearch::Milvus initializer by passing :api_key

lib/langchain/assistant/messages/ollama_message.rb

@@ -24,7 +24,10 @@ class OllamaMessage < Base
         def initialize(role:, content: nil, image_url: nil, tool_calls: [], tool_call_id: nil)
           raise ArgumentError, "Role must be one of #{ROLES.join(", ")}" unless ROLES.include?(role)
           raise ArgumentError, "Tool calls must be an array of hashes" unless tool_calls.is_a?(Array) && tool_calls.all? { |tool_call| tool_call.is_a?(Hash) }
-          raise ArgumentError, "image_url must be a valid url" if image_url && !URI::DEFAULT_PARSER.make_regexp.match?(image_url)
+
+          # Ensure compatibility with `URI::RFC2396_PARSER` (Ruby 3.4+) and `URI::DEFAULT_PARSER` (<= 3.3).
+          uri_parser = defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER
+          raise ArgumentError, "image_url must be a valid url" if image_url && !uri_parser.make_regexp.match?(image_url)
 
           @role = role
           # Some Tools return content as a JSON hence `.to_s`

lib/langchain/loader.rb

@@ -91,7 +91,11 @@ def load(&block)
 
     def load_from_url
       unescaped_url = URI.decode_www_form_component(@path)
-      escaped_url = URI::DEFAULT_PARSER.escape(unescaped_url)
+
+      # Ensure compatibility with `URI::RFC2396_PARSER` (Ruby 3.4+) and `URI::DEFAULT_PARSER` (<= 3.3).
+      uri_parser = defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER
+      escaped_url = uri_parser.escape(unescaped_url)
+
       URI.parse(escaped_url).open
     end
 

lib/langchain/processors/eml.rb

@@ -52,9 +52,12 @@ def extract_text_content(mail)
 
       # Clean and format the extracted content
       def clean_content(content)
+        # Ensure compatibility with `URI::RFC2396_PARSER` (Ruby 3.4+) and `URI::DEFAULT_PARSER` (<= 3.3).
+        uri_parser = defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER
+
         content
           .gsub(/\[cid:[^\]]+\]/, "") # Remove embedded image references
-          .gsub(URI::DEFAULT_PARSER.make_regexp(%w[http https])) { |match| "<#{match}>" } # Format URLs
+          .gsub(uri_parser.make_regexp(%w[http https])) { |match| "<#{match}>" } # Format URLs
           .gsub(/\r\n?/, "\n") # Normalize line endings to Unix style
           .gsub(/[\u200B-\u200D\uFEFF]/, "") # Remove zero width spaces and similar characters
           .gsub(/<\/?[^>]+>/, "") # Remove any HTML tags that might have sneaked in