rubium 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 578d3543ceff2361188340f76906d497b68a81bd7fae58ea0a07b07b1911d376
-  data.tar.gz: 9b4f4f016e5af7a935ef52f469939ac9e4c8f7c399f8c2105fb6c2f4b3c8df4e
+  metadata.gz: fcfb93374d1a40e65007cbadd579dccb55715a7cc16298944bac5276112b7fd6
+  data.tar.gz: db26213aa97ca72da071ad52602034cd69a5a21726e4b437c1c8e87ff952a88f
 SHA512:
-  metadata.gz: e3efeeab3587f3cfdc3c578469d99f2004d59720161b492759bac5d5ade74d33147ca9ced2838e6d7c31b4a08b510d7b89358c5628fbd088eab4aa9a2f0039fd
-  data.tar.gz: 55f45b10d25cf66cd8517933bf0b44a15ebf21c98ee2831fe040d4a19188fc9f4bcc7ee1f0c8cd9fbd53b7b4f3690cd185fcfd1b3d73bd1a282bddab8d8d2a22
+  metadata.gz: acd06d872499a883b00d47246d0d66639bf54f6b93e777d87f273ef1783dd761a5a13b87be0204114b18b129169c80982248cd06ee7e6baf7913c1f0a344f44a
+  data.tar.gz: 83913f350d231770cae28c720b84655d577380f623e1955027723503b6ea86ffe7f333cde46c4bccc2a3ae176819bf116a2ce6e89a9c9bf35b98fa32275fe0b3

data/.rubocop.yml

@@ -0,0 +1,2 @@
+AllCops:
+  TargetRubyVersion: 3.1.0

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] - 2025-12-31 
+ 
+* Add ostruct to gemspec (Ruby 3.5 compatibility)
+* Rename DEFAULT_PUPPETEER_ARGS to DEFAULT_ARGS
+
+## [0.3.1] - 2025-12-16
+
+### Added
+- Use [Patchright like](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright?tab=readme-ov-file#command-flags-leaks) CLI args for better antidetect performance 
+- Add required Ruby version >= 3.1.0
+- Add Rubocop
+
 ## [0.3.0] - 2025-12-12
 
 ### Added

data/Gemfile

@@ -1,6 +1,8 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in rubium.gemspec
 gemspec

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2025 Victor Afanasev
+Copyright (c) 2026 Victor Afanasev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -2,9 +2,7 @@
 
 ## Description
 
-Rubium is a handy wrapper around [chrome_remote](https://github.com/cavalle/chrome_remote) gem. It adds browsers instances handling, and some Capybara-like methods. It is very lightweight (250 lines of code in the main `Rubium::Browser` class for now) and doens't use Selenium or Capybara. Consider Rubium as a _very simple_ and _basic_ implementation of [Puppeteer](https://github.com/GoogleChrome/puppeteer) in Ruby language.
-
-You can use Rubium as a lightweight alternative to Selenium/Capybara/Watir if you need to perform some operations (like web scraping) using Headless Chromium and Ruby. Of course, the API currently doesn't has a lot of methods to automate browser, but it has the most frequently used and basic ones.
+Rubium is a lightweight Ruby API for headless antidetect Chrome browser automation. It provides essential Capybara-like methods in just 300 lines of code — no Selenium or heavy dependencies required. Use it as a simple alternative to Puppeteer/Playwright for web scraping and basic browser automation tasks:
 
 ```ruby
 require 'rubium'
@@ -111,7 +109,7 @@ end
 
 
 ## Installation
-Rubium tested with `2.3.0` Ruby version and up.
+Rubium tested with `3.1.0` Ruby version and up.
 
 ## Contribution
 Sure, feel free to fork and add new functionality.

data/Rakefile

@@ -1,10 +1,12 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
 end
 
-task :default => :test
+task default: :test

data/bin/console

@@ -1,7 +1,8 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require "bundler/setup"
-require "rubium"
+require 'bundler/setup'
+require 'rubium'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +11,5 @@ require "rubium"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/lib/rubium/browser.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'chrome_remote'
 require 'nokogiri'
 require 'random-port'
@@ -8,7 +10,7 @@ require 'logger'
 require 'fileutils'
 
 at_exit do
-  Rubium::Browser.running_pids.each { |pid| Process.kill("HUP", pid) }
+  Rubium::Browser.running_pids.each { |pid| Process.kill('HUP', pid) }
 end
 
 module Rubium
@@ -20,7 +22,7 @@ module Rubium
 
     class << self
       def ports_pool
-        @pool ||= RandomPort::Pool.new
+        @ports_pool ||= RandomPort::Pool.new
       end
 
       def running_pids
@@ -28,13 +30,13 @@ module Rubium
       end
     end
 
-    attr_reader  :client, :devtools_url, :pid, :port, :options, :processed_requests_count, :logger
+    attr_reader :client, :devtools_url, :pid, :port, :options, :processed_requests_count, :logger
 
     def initialize(options = {})
       @options = options
 
       if @options[:enable_logger]
-        @logger = Logger.new(STDOUT)
+        @logger = Logger.new($stdout)
         @logger.progname = self.class.to_s
       end
 
@@ -42,7 +44,7 @@ module Rubium
     end
 
     def restart!
-      logger.info "Restarting..." if options[:enable_logger]
+      logger.info 'Restarting...' if options[:enable_logger]
 
       close
       create_browser
@@ -50,23 +52,21 @@ module Rubium
 
     def close
       if closed?
-        logger.info "Browser already has been closed" if options[:enable_logger]
+        logger.info 'Browser already has been closed' if options[:enable_logger]
       else
-        Process.kill("HUP", @pid)
+        Process.kill('HUP', @pid)
         self.class.running_pids.delete(@pid)
         self.class.ports_pool.release(@port)
 
         # Delete temp profile directory, if there is no custom one
-        unless options[:data_dir]
-          FileUtils.rm_rf(@data_dir) if Dir.exist?(@data_dir)
-        end
+        FileUtils.rm_rf(@data_dir) if !options[:data_dir] && Dir.exist?(@data_dir)
 
-        logger.info "Closed browser" if options[:enable_logger]
+        logger.info 'Closed browser' if options[:enable_logger]
         @closed = true
       end
     end
 
-    alias_method :destroy_driver!, :close
+    alias destroy_driver! close
 
     def closed?
       @closed
@@ -74,11 +74,9 @@ module Rubium
 
     def goto(url, wait: options[:max_timeout] || MAX_DEFAULT_TIMEOUT)
       logger.info "Started request: #{url}" if options[:enable_logger]
-      if options[:restart_after] && processed_requests_count >= options[:restart_after]
-        restart!
-      end
+      restart! if options[:restart_after] && processed_requests_count >= options[:restart_after]
 
-      response = @client.send_cmd "Page.navigate", url: url
+      response = @client.send_cmd 'Page.navigate', url: url
 
       # By default, after Page.navigate we should wait till page will load completely
       # using Page.loadEventFired. But on some websites with Ajax navigation, Page.loadEventFired
@@ -87,7 +85,7 @@ module Rubium
         # https://chromedevtools.github.io/devtools-protocol/tot/Page#event-frameStoppedLoading
         Timeout.timeout(wait) do
           @client.wait_for do |event_name, event_params|
-            event_name == "Page.frameStoppedLoading" && event_params["frameId"] == response["frameId"]
+            event_name == 'Page.frameStoppedLoading' && event_params['frameId'] == response['frameId']
           end
         end
       end
@@ -96,11 +94,11 @@ module Rubium
       logger.info "Finished request: #{url}" if options[:enable_logger]
     end
 
-    alias_method :visit, :goto
+    alias visit goto
 
     def body
-      response = @client.send_cmd "Runtime.evaluate", expression: 'document.documentElement.outerHTML'
-      response.dig("result", "value")
+      response = @client.send_cmd 'Runtime.evaluate', expression: 'document.documentElement.outerHTML'
+      response.dig('result', 'value')
     end
 
     def current_response
@@ -111,6 +109,7 @@ module Rubium
       timer = 0
       until current_response.at_xpath(path)
         return false if timer >= wait
+
         timer += 0.2 and sleep 0.2
       end
 
@@ -121,6 +120,7 @@ module Rubium
       timer = 0
       until current_response.at_css(selector)
         return false if timer >= wait
+
         timer += 0.2 and sleep 0.2
       end
 
@@ -131,6 +131,7 @@ module Rubium
       timer = 0
       until body&.include?(text)
         return false if timer >= wait
+
         timer += 0.2 and sleep 0.2
       end
 
@@ -138,52 +139,52 @@ module Rubium
     end
 
     def click(selector)
-      @client.send_cmd "Runtime.evaluate", expression: <<~js
+      @client.send_cmd 'Runtime.evaluate', expression: <<~JS
         document.querySelector(`#{selector}`).click();
-      js
+      JS
     end
 
     # https://github.com/cyrus-and/chrome-remote-interface/issues/226#issuecomment-320247756
     # https://stackoverflow.com/a/18937620
     def send_key_on(selector, key)
-      @client.send_cmd "Runtime.evaluate", expression: <<~js
+      @client.send_cmd 'Runtime.evaluate', expression: <<~JS
         document.querySelector(`#{selector}`).dispatchEvent(
           new KeyboardEvent("keydown", {
             bubbles: true, cancelable: true, keyCode: #{key}
           })
         );
-      js
+      JS
     end
 
     # https://github.com/GoogleChrome/puppeteer/blob/master/lib/Page.js#L784
     # https://stackoverflow.com/questions/46113267/how-to-use-evaluateonnewdocument-and-exposefunction
     # https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-addScriptToEvaluateOnNewDocument
     def evaluate_on_new_document(script)
-      @client.send_cmd "Page.addScriptToEvaluateOnNewDocument", source: script
+      @client.send_cmd 'Page.addScriptToEvaluateOnNewDocument', source: script
     end
 
     ###
 
     def cookies
-      response = @client.send_cmd "Network.getCookies"
-      response["cookies"]
+      response = @client.send_cmd 'Network.getCookies'
+      response['cookies']
     end
 
     # https://chromedevtools.github.io/devtools-protocol/tot/Network#method-setCookies
     def set_cookies(cookies)
-      @client.send_cmd "Network.setCookies", cookies: cookies
+      @client.send_cmd 'Network.setCookies', cookies: cookies
     end
 
     ###
 
     def fill_in(selector, text)
-      execute_script <<~js
+      execute_script <<~JS
         document.querySelector(`#{selector}`).value = "#{text}"
-      js
+      JS
     end
 
     def execute_script(script)
-      @client.send_cmd "Runtime.evaluate", expression: script
+      @client.send_cmd 'Runtime.evaluate', expression: script
     end
 
     private
@@ -198,13 +199,13 @@ module Rubium
       chrome_path = get_chrome_path
       raise ConfigurationError, "Can't find chrome executable" unless chrome_path
 
-      command = %W(
+      command = %W[
         #{chrome_path} about:blank
         --remote-debugging-port=#{@port}
         --user-data-dir=#{@data_dir}
-      ) + DEFAULT_PUPPETEER_ARGS
+      ] + DEFAULT_ARGS
 
-      command << "--headless" if ENV["HEADLESS"] != "false" && options[:headless] != false
+      command << '--headless' if ENV['HEADLESS'] != 'false' && options[:headless] != false
       command << "--window-size=#{options[:window_size].join(',')}" if options[:window_size]
 
       if options[:user_agent]
@@ -214,11 +215,11 @@ module Rubium
 
       if options[:proxy_server]
         proxy_server = options[:proxy_server].respond_to?(:call) ? options[:proxy_server].call : options[:proxy_server]
-        proxy_server = convert_proxy(proxy_server) unless proxy_server.include?("://")
+        proxy_server = convert_proxy(proxy_server) unless proxy_server.include?('://')
         command << "--proxy-server=#{proxy_server}"
       end
 
-      @pid = spawn(*command, [:out, :err] => "/dev/null")
+      @pid = spawn(*command, %i[out err] => '/dev/null')
       self.class.running_pids << @pid
       @closed = false
 
@@ -233,9 +234,9 @@ module Rubium
       @devtools_url = "http://localhost:#{@port}/"
 
       # https://github.com/GoogleChrome/puppeteer/blob/master/lib/Page.js
-      @client.send_cmd "Target.setAutoAttach", autoAttach: true, waitForDebuggerOnStart: false
-      @client.send_cmd "Network.enable"
-      @client.send_cmd "Page.enable"
+      @client.send_cmd 'Target.setAutoAttach', autoAttach: true, waitForDebuggerOnStart: false
+      @client.send_cmd 'Network.enable'
+      @client.send_cmd 'Page.enable'
 
       evaluate_on_new_document(options[:extension_code]) if options[:extension_code]
 
@@ -244,32 +245,29 @@ module Rubium
       if options[:urls_blacklist] || options[:disable_images]
         urls = []
 
-        if options[:urls_blacklist]
-          urls += options[:urls_blacklist]
-        end
+        urls += options[:urls_blacklist] if options[:urls_blacklist]
 
         if options[:disable_images]
-          urls += %w(jpg jpeg png gif swf svg tif).map { |ext| ["*.#{ext}", "*.#{ext}?*"] }.flatten
-          urls << "data:image*"
+          urls += %w[jpg jpeg png gif swf svg tif].map { |ext| ["*.#{ext}", "*.#{ext}?*"] }.flatten
+          urls << 'data:image*'
         end
 
-        @client.send_cmd "Network.setBlockedURLs", urls: urls
+        @client.send_cmd 'Network.setBlockedURLs', urls: urls
       end
 
-
-      logger.info "Opened browser" if options[:enable_logger]
+      logger.info 'Opened browser' if options[:enable_logger]
     end
 
     def get_chrome_path
-      path = Rubium.configuration.chrome_path || Cliver.detect("chromium-browser") || Cliver.detect("google-chrome")
+      path = Rubium.configuration.chrome_path || Cliver.detect('chromium-browser') || Cliver.detect('google-chrome')
       return path if path
 
-      macos_path = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+      macos_path = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'
       macos_path if File.executable?(macos_path)
     end
 
     def convert_proxy(proxy_string)
-      ip, port, type, user, password = proxy_string.split(":")
+      ip, port, type, = proxy_string.split(':')
       "#{type}://#{ip}:#{port}"
     end
   end

data/lib/rubium/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Rubium
-  VERSION = "0.3.0"
+  VERSION = '0.3.2'
 end

data/lib/rubium.rb

@@ -1,37 +1,40 @@
+# frozen_string_literal: true
+
 require 'ostruct'
 require 'rubium/version'
 require 'rubium/browser'
 
 module Rubium
-  DEFAULT_PUPPETEER_ARGS = %w(
+  DEFAULT_ARGS = %w[
+    --disable-field-trial-config
     --disable-background-networking
     --disable-background-timer-throttling
     --disable-backgrounding-occluded-windows
     --disable-breakpad
-    --disable-client-side-phishing-detection
-    --disable-default-apps
+    --no-default-browser-check
     --disable-dev-shm-usage
-    --disable-extensions
-    --disable-features=site-per-process
+    --disable-features=AcceptCHFrame,AvoidUnnecessaryBeforeUnloadCheckSync,DestroyProfileOnBrowserClose,DialMediaRouteProvider,GlobalMediaControls,HttpsUpgrades,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,Translate,AutoDeElevate,RenderDocument,OptimizationHints
+    --enable-features=CDPScreenshotNewSurface
     --disable-hang-monitor
-    --disable-ipc-flooding-protection
-    --disable-popup-blocking
     --disable-prompt-on-repost
     --disable-renderer-backgrounding
-    --disable-sync
-    --disable-translate
-    --metrics-recording-only
+    --force-color-profile=srgb
     --no-first-run
-    --safebrowsing-disable-auto-update
-    --enable-automation
     --password-store=basic
     --use-mock-keychain
-    --hide-scrollbars
-    --mute-audio
-    --no-sandbox
+    --no-service-autorun
+    --export-tagged-pdf
+    --disable-search-engine-choice-screen
+    --edge-skip-compat-layer-relaunch
     --disable-infobars
+    --disable-search-engine-choice-screen
+    --disable-sync
     --disable-blink-features=AutomationControlled
-  ).freeze
+    --enable-unsafe-swiftshader
+    --no-sandbox
+    --force-webrtc-ip-handling-policy=disable_non_proxied_udp
+    --webrtc-ip-handling-policy=disable_non_proxied_udp
+  ].freeze
 
   def self.configuration
     @configuration ||= OpenStruct.new

data/rubium.gemspec

@@ -1,32 +1,31 @@
+# frozen_string_literal: true
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "rubium/version"
+require 'rubium/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "rubium"
+  spec.name          = 'rubium'
   spec.version       = Rubium::VERSION
-  spec.authors       = ["Victor Afanasev"]
-  spec.email         = ["vicfreefly@gmail.com"]
+  spec.authors       = ['Victor Afanasev']
+  spec.email         = ['vicfreefly@gmail.com']
 
-  spec.summary       = "Headless Chromium Ruby API based on ChromeRemote gem"
+  spec.summary       = 'Antidetect Headless Chromium Ruby API based on ChromeRemote gem'
   spec.description   = spec.summary
-  spec.homepage      = "https://github.com/vifreefly/rubium"
-  spec.license       = "MIT"
+  spec.homepage      = 'https://github.com/vifreefly/rubium'
+  spec.license       = 'MIT'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 3.1.0'
 
-  spec.add_dependency "chrome_remote", "~> 0.3"
-  spec.add_dependency "cliver", "~> 0.3"
-  spec.add_dependency "random-port"
-  spec.add_dependency "nokogiri"
-
-  spec.add_development_dependency "bundler", "~> 2.4"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "minitest", "~> 5.22"
+  spec.add_dependency 'chrome_remote', '~> 0.3'
+  spec.add_dependency 'cliver', '~> 0.3'
+  spec.add_dependency 'nokogiri'
+  spec.add_dependency 'random-port'
+  spec.add_dependency 'ostruct'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubium
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Victor Afanasev
@@ -38,7 +38,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.3'
 - !ruby/object:Gem::Dependency
-  name: random-port
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,7 +52,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: nokogiri
+  name: random-port
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,48 +66,20 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.4'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: minitest
+  name: ostruct
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.22'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.22'
-description: Headless Chromium Ruby API based on ChromeRemote gem
+        version: '0'
+description: Antidetect Headless Chromium Ruby API based on ChromeRemote gem
 email:
 - vicfreefly@gmail.com
 executables: []
@@ -115,6 +87,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -137,7 +110,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -146,5 +119,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.1
 specification_version: 4
-summary: Headless Chromium Ruby API based on ChromeRemote gem
+summary: Antidetect Headless Chromium Ruby API based on ChromeRemote gem
 test_files: []