async-webdriver 0.3.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: feeb6491f2ca71f3545e538223b1913f582f361e3f60904121be38a0c3336472
-  data.tar.gz: 13738ddaaa84a0f1a1bab59194f31445035c3e12939ee815e7a28947f22bc093
+  metadata.gz: da08a7e4f4e91c945652030f4616b76e9b087cc84efb98f6ee48c99504407abc
+  data.tar.gz: bf78251edf46c21d60b73adfa60b3105a9c114a9c0de26454ca59ed1cba85198
 SHA512:
-  metadata.gz: 2b995fa91a0df9b3ee5b921b3230ba216a671133b0832494d7696e3ad70df59dc297fedbb7fdd2f8f82ab70b1b9eb8aeab5c5464370828817c6e14db3bf8e364
-  data.tar.gz: 0b631916ad896c782e6f1268d93b11c9d2ef741b49aaf7b487c3bdbf2aed5d9b2e094dcd3a581e18d761bf366895ce48c4c8dfb304a2eb0d9f500d0cd274e7ed
+  metadata.gz: 79921aa72ebc306b70a5615de0aec9b2ffa5e6c56186f08ce781b69837f71911334512148678320da898dcf546f310de9157e554ee65a00bd37b05f6584f6303
+  data.tar.gz: 7f193306b1552c179a96b8d2ca832b979d6118bea9c8c9a22da5550e454de1b3282605486191727ed5af7cd3eb674c0b231bb8aad82b84f7ad353c08f5c23adf

checksums.yaml.gz.sig

@@ -1,3 +1,3 @@
-rX<)`��5]����)'pޢ���@�7��V)ԀR]Q� %PM
-����,�O���&n h���Y�
-��l�k%�b�cUcKL�&rv]��
m�;b�x��/5XT7u�|F���,��ֽ;	��L��qH�#-Q�i�<� ��\N퉞� '	�vH�
���*n{��V?]b*��Ce�u��$�D@".�$��lm�{��-FP<�xH5GOo��ilGp��;X�����/V�-ы��3#��^-���M�
.'��Ry��UO�#v�D�{ҡH��\����7��)�s�p� w��3��]�&�T�p�,r�\58�vZ��
+-1
+�}@���������)�r���	5�B�j_|]W��@@:�*��o�Os�$��SuP��c
k���������V��O�,�ć�h�hJH�N}��]�#�>�
+f�wW��9c0f?�M��f������,pZѢ!��t���CXN��\P$�K�`੓���J�i.#���o=�h{���6{k�g2d��G��Oڹ�):�!skHL�*d#«�Jf����?��U�h��R���J$��$�����3|	w
ҡ���"姴��{�C��e�[~8��s��x��e@�r�b���.sW�Ɠ�q�}���gw� ��=7�Ҟ��V	nm��h

data/lib/async/webdriver/bridge/chrome.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2024, by Samuel Williams.
 
 require_relative 'generic'
 require_relative 'process_group'
@@ -20,58 +20,65 @@ module Async
 			# end
 			# ```
 			class Chrome < Generic
-				# Create a new bridge to Chrome.
-				# @parameter path [String] The path to the `chromedriver` executable.
-				def initialize(path: "chromedriver")
-					super()
-					
-					@path = path
-					@process = nil
+				def path
+					@options.fetch(:path, "chromedriver")
 				end
 				
 				# @returns [String] The version of the `chromedriver` executable.
 				def version
-					::IO.popen([@path, "--version"]) do |io|
+					::IO.popen([self.path, "--version"]) do |io|
 						return io.read
 					end
 				rescue Errno::ENOENT
 					return nil
 				end
 				
-				# @returns [Array(String)] The arguments to pass to the `chromedriver` executable.
-				def arguments
-					[
-						"--port=#{self.port}",
-					].compact
-				end
-				
-				# Start the driver.
-				def start
-					@process ||= ProcessGroup.spawn(@path, *arguments)
+				class Driver < Bridge::Driver
+					def initialize(**options)
+						super(**options)
+						@process_group = nil
+					end
 					
-					super
-				end
-				
-				# Close the driver.
-				def close
-					super
+					# @returns [Array(String)] The arguments to pass to the `chromedriver` executable.
+					def arguments(**options)
+						[
+							options.fetch(:path, "chromedriver"),
+							"--port=#{self.port}",
+						].compact
+					end
+					
+					def start
+						@process_group = ProcessGroup.spawn(*arguments(**@options))
+						
+						super
+					end
 					
-					if @process
-						@process.close
-						@process = nil
+					def close
+						if @process_group
+							@process_group.close
+							@process_group = nil
+						end
+						
+						super
 					end
 				end
 				
+				# Start the driver.
+				def start(**options)
+					Driver.new(**options).tap(&:start)
+				end
+				
 				# The default capabilities for the Chrome browser which need to be provided when requesting a new session.
 				# @parameter headless [Boolean] Whether to run the browser in headless mode.
 				# @returns [Hash] The default capabilities for the Chrome browser.
-				def default_capabilities(headless: true)
+				def default_capabilities(headless: self.headless?)
 					{
 						alwaysMatch: {
 							browserName: "chrome",
 							"goog:chromeOptions": {
 								args: [headless ? "--headless" : nil].compact,
-							}
+							},
+							webSocketUrl: true,
 						},
 					}
 				end

data/lib/async/webdriver/bridge/driver.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023, by Samuel Williams.
+
+module Async
+	module WebDriver
+		module Bridge
+			# Represents an instance of a locally running driver (usually with a process group).
+			class Driver
+				def initialize(**options)
+					@options = options
+					@count = 0
+					@closed = false
+				end
+				
+				def concurrency
+					@options.fetch(:concurrency, 128)
+				end
+				
+				attr :count
+				
+				# @attribute [Hash] The status of the driver after a connection has been established.
+				attr :status
+				
+				def viable?
+					!@closed
+				end
+				
+				def closed?
+					@closed
+				end
+				
+				def close
+					@closed = true
+				end
+				
+				def reusable?
+					@options.fetch(:reusable, !@closed)
+				end
+				
+				# Generate a port number for the driver to listen on if it was not specified.
+				# @returns [Integer] An ephemeral port number.
+				def ephemeral_port
+					address = ::Addrinfo.tcp("localhost", 0)
+					
+					address.bind do |socket|
+						# We assume that it's unlikely the port will be reused any time soon...
+						return socket.local_address.ip_port
+					end
+				end
+				
+				def port
+					@port ||= @options.fetch(:port, self.ephemeral_port)
+				end
+				
+				def endpoint
+					Async::HTTP::Endpoint.parse("http://localhost", port: self.port)
+				end
+				
+				def client
+					Client.open(self.endpoint)
+				end
+				
+				# Start the driver.
+				# @parameter retries [Integer] The number of times to retry before giving up.
+				def start(retries: 100)
+					endpoint = self.endpoint
+					
+					Console.debug(self, "Waiting for driver to start...", endpoint: endpoint)
+					count = 0
+					
+					Async::HTTP::Client.open(endpoint) do |client|
+						begin
+							response = client.get("/status")
+							@status = JSON.parse(response.read)["value"]
+							Console.debug(self, "Successfully connected to driver.", status: @status)
+						rescue Errno::ECONNREFUSED
+							if count < retries
+								count += 1
+								sleep(0.01 * count)
+								Console.debug(self, "Driver not ready, retrying...")
+								retry
+							else
+								raise
+							end
+						end
+					end
+				end
+			end
+		end
+	end
+end

data/lib/async/webdriver/bridge/firefox.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2024, by Samuel Williams.
 
 require_relative 'generic'
 require_relative 'process_group'
@@ -19,57 +19,67 @@ module Async
 			# 	bridge&.close
 			# end
 			class Firefox < Generic
-				# Create a new bridge to Firefox.
-				# @parameter path [String] The path to the `geckodriver` executable.
-				def initialize(path: "geckodriver")
-					super()
-					
-					@path = path
-					@process = nil
+				def path
+					@options.fetch(:path, "geckodriver")
 				end
 				
 				# @returns [String] The version of the `geckodriver` executable.
 				def version
-					::IO.popen([@path, "--version"]) do |io|
+					::IO.popen([self.path, "--version"]) do |io|
 						return io.read
 					end
 				rescue Errno::ENOENT
 					return nil
 				end
 				
-				# @returns [Array(String)] The arguments to pass to the `geckodriver` executable.
-				def arguments
-					[
-						"--port", self.port.to_s,
-					].compact
-				end
-				
-				# Start the driver.
-				def start
-					@process ||= ProcessGroup.spawn(@path, *arguments)
+				class Driver < Bridge::Driver
+					def initialize(**options)
+						super(**options)
+						@process_group = nil
+					end
 					
-					super
-				end
-				
-				# Close the driver.
-				def close
-					super
+					def concurrency
+						1
+					end
 					
-					if @process
-						@process.close
-						@process = nil
+					# @returns [Array(String)] The arguments to pass to the `chromedriver` executable.
+					def arguments(**options)
+						[
+							options.fetch(:path, "geckodriver"),
+							"--port", self.port.to_s,
+						].compact
 					end
+					
+					def start
+						@process_group = ProcessGroup.spawn(*arguments(**@options))
+						
+						super
+					end
+					
+					def close
+						if @process_group
+							@process_group.close
+							@process_group = nil
+						end
+						
+						super
+					end
+				end
+				
+				# Start the driver.
+				def start(**options)
+					Driver.new(**options).tap(&:start)
 				end
 				
 				# The default capabilities for the Firefox browser which need to be provided when requesting a new session.
 				# @parameter headless [Boolean] Whether to run the browser in headless mode.
 				# @returns [Hash] The default capabilities for the Firefox browser.
-				def default_capabilities(headless: true)
+				def default_capabilities(headless: self.headless?)
 					{
 						alwaysMatch: {
 							browserName: "firefox",
 							"moz:firefoxOptions": {
-								"args": [headless ? "-headless" : nil].compact,
+								args: [headless ? "-headless" : nil].compact,
 							}
 						}
 					}

data/lib/async/webdriver/bridge/generic.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2024, by Samuel Williams.
 
 require 'socket'
 require 'async/http/endpoint'
@@ -12,23 +12,14 @@ module Async
 		module Bridge
 			# Generic W3C WebDriver implementation.
 			class Generic
-				# Start the driver and return a new instance.
 				def self.start(**options)
-					self.new(**options).tap do |bridge|
-						bridge.start
-					end
+					self.new(**options).start
 				end
 				
-				# Initialize the driver.
-				# @parameter port [Integer] The port to listen on.
-				def initialize(port: nil)
-					@port = port
-					@status = nil
+				def initialize(**options)
+					@options = options
 				end
 				
-				# @attribute [String] The status of the driver after a connection has been established.
-				attr :status
-				
 				# @returns [String | Nil] The version of the driver.
 				def version
 					nil
@@ -39,51 +30,8 @@ module Async
 					version != nil
 				end
 				
-				# Start the driver.
-				# @parameter retries [Integer] The number of times to retry before giving up.
-				def start(retries: 100)
-					Console.debug(self, "Waiting for driver to start...")
-					count = 0
-					
-					Async::HTTP::Client.open(endpoint) do |client|
-						begin
-							response = client.get("/status")
-							@status = JSON.parse(response.read)["value"]
-							Console.debug(self, "Successfully connected to driver.", status: @status)
-						rescue Errno::ECONNREFUSED
-							if count < retries
-								count += 1
-								sleep(0.001 * count)
-								Console.debug(self, "Driver not ready, retrying...")
-								retry
-							else
-								raise
-							end
-						end
-					end
-				end
-				
-				# Close the driver and any associated resources.
-				def close
-				end
-				
-				# Generate a port number for the driver to listen on if it was not specified.
-				# @returns [Integer] The port the driver is listening on.
-				def port
-					unless @port
-						address = ::Addrinfo.tcp("localhost", 0)
-						address.bind do |socket|
-							# We assume that it's unlikely the port will be reused any time soon...
-							@port = socket.local_address.ip_port
-						end
-					end
-					
-					return @port
-				end
-				
-				# @returns [Async::HTTP::Endpoint] The endpoint the driver is listening on.
-				def endpoint
-					Async::HTTP::Endpoint.parse("http://localhost:#{port}")
+				def headless?
+					@options.fetch(:headless, true)
 				end
 			end
 		end

data/lib/async/webdriver/bridge/pool.rb

@@ -3,10 +3,15 @@
 # Released under the MIT License.
 # Copyright, 2023, by Samuel Williams.
 
+require 'async/actor'
+require 'async/pool'
+
+require_relative '../session'
+
 module Async
 	module WebDriver
 		module Bridge
-			# A pool of sessions.
+			# A pool of sessions, constructed from a bridge, which instantiates drivers as needed. Drivers are capable of supporting 1 ore more sessions.
 			#
 			# ``` ruby
 			# begin
@@ -17,90 +22,139 @@ module Async
 			# end
 			# ```
 			class Pool
-				# Create a new session pool and start it.
-				# @parameter bridge [Bridge] The bridge to use to create sessions.
-				# @parameter capabilities [Hash] The capabilities to use when creating sessions.
-				# @returns [Pool] The pool.
-				def self.start(bridge, **options)
-					self.new(bridge, **options).tap do |pool|
-						pool.start
+				class BridgeController
+					def initialize(bridge, capabilities: bridge.default_capabilities)
+						@bridge = bridge
+						@capabilities = capabilities
+						@pool = Async::Pool::Controller.new(self)
+					end
+					
+					class SessionCache
+						def initialize(driver, capabilities)
+							@driver = driver
+							@capabilities = capabilities
+							
+							@client = driver.client
+							@sessions = []
+						end
+						
+						def viable?
+							@driver&.viable?
+						end
+						
+						def reusable?
+							@driver&.reusable?
+						end
+						
+						def close
+							if @driver
+								@driver.close
+								@driver = nil
+							end
+							
+							if @client
+								@client.close
+								@client = nil
+							end
+							
+							if @sessions
+								@sessions = nil
+							end
+						end
+						
+						def concurrency
+							@driver.concurrency
+						end
+						
+						def acquire
+							if @sessions.empty?
+								session = @client.post("session", {capabilities: @capabilities})
+								session[:cache] = self
+								session[:endpoint] = @driver.endpoint
+								
+								return session
+							else
+								return @sessions.pop
+							end
+						end
+						
+						def release(session)
+							@sessions.push(session)
+						end
+					end
+					
+					# Constructor for the pool.
+					def call
+						SessionCache.new(@bridge.start, @capabilities)
+					end
+					
+					def acquire
+						session_cache = @pool.acquire
+						
+						return session_cache.acquire
+					end
+					
+					def release(session)
+						session_cache = session[:cache]
+						
+						session_cache.release(session)
+						
+						@pool.release(session_cache)
+					end
+					
+					def retire(session)
+						session_cache = session[:cache]
+						
+						session_cache.release(session)
+						
+						@pool.retire(session_cache)
+					end
+					
+					def close
+						if @pool
+							@pool.close
+							@pool = nil
+						end
 					end
 				end
 				
 				# Initialize the session pool.
 				# @parameter bridge [Bridge] The bridge to use to create sessions.
-				# @parameter capabilities [Hash] The capabilities to use when creating sessions.
-				# @parameter minimum [Integer] The minimum number of sessions to keep open.
-				def initialize(bridge, capabilities: bridge.default_capabilities, minimum: 2)
-					@bridge = bridge
-					@capabilities = capabilities
-					@minimum = minimum
-					
-					@thread = nil
-					
-					@waiting = Thread::Queue.new
-					@sessions = Thread::Queue.new
+				def initialize(...)
+					@controller = Async::Actor.new(BridgeController.new(...))
 				end
 				
 				# Close the session pool.
 				def close
-					if @waiting
-						@waiting.close
+					@controller.close
+				end
+				
+				class CachedWrapper < Session
+					def pool
+						@options[:pool]
 					end
 					
-					if @thread
-						@thread.join
-						@thread = nil
+					def payload
+						@options[:payload]
 					end
 					
-					if @sessions
-						@sessions.close
-					end
-				end
-				
-				private def prepare_session(client)
-					client.post("session", {capabilities: @capabilities})
-				end
-				
-				# Start the session pool.
-				def start
-					@thread ||= Thread.new do
-						Sync do
-							@bridge.start
-							
-							client = Client.open(@bridge.endpoint)
-							
-							@minimum.times do
-								@waiting << true
-							end
-							
-							while @waiting.pop
-								session = prepare_session(client)
-								@sessions << session
-							end
-						ensure
-							client&.close
-							@bridge.close
+					def close
+						unless self.pool.reuse(self)
+							super
 						end
 					end
 				end
 				
 				# Open a session.
 				def session(&block)
-					@waiting << true
+					payload = @controller.acquire
 					
-					reply = @sessions.pop
-					
-					session = Session.open(@bridge.endpoint, reply["sessionId"], reply["capabilities"])
+					session = CachedWrapper.open(payload[:endpoint], payload["sessionId"], payload["capabilities"], pool: self, payload: payload)
 					
 					return session unless block_given?
 					
 					begin
 						yield session
-						
-						# Try to reuse the session for extreme performance:
-						reuse(session)
-						session = nil
 					ensure
 						session&.close
 					end
@@ -109,7 +163,9 @@ module Async
 				def reuse(session)
 					session.reset!
 					
-					@sessions << {"sessionId" => session.id, "capabilities" => session.capabilities}
+					@controller.release(session.payload)
+					
+					return true
 				end
 			end
 		end

data/lib/async/webdriver/bridge/process_group.rb

@@ -3,6 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2023, by Samuel Williams.
 
+require_relative 'driver'
+
 module Async
 	module WebDriver
 		module Bridge
@@ -72,6 +74,23 @@ module Async
 					# Done.
 				end
 			end
+			
+			class ProcessDriver < Driver
+				def initialize(endpoint, process)
+					super(endpoint)
+					
+					@process = process
+				end
+				
+				def close
+					super
+					
+					if @process
+						@process.close
+						@process = nil
+					end
+				end
+			end
 		end
 	end
 end

data/lib/async/webdriver/bridge.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2024, by Samuel Williams.
 
 require_relative 'bridge/chrome'
 require_relative 'bridge/firefox'
 
+require_relative 'error'
+
 module Async
 	module WebDriver
 		# A bridge is a process that can be used to communicate with a browser.
@@ -25,6 +27,42 @@ module Async
 					yield klass
 				end
 			end
+			
+			# The environment variable used to select a bridge.
+			#
+			# ```
+			# ASYNC_WEBDRIVER_BRIDGE=Chrome
+			# ASYNC_WEBDRIVER_BRIDGE=Firefox
+			# ```
+			ASYNC_WEBDRIVER_BRIDGE = 'ASYNC_WEBDRIVER_BRIDGE'
+			
+			# The environment variable used to disable headless mode.
+			#
+			# ```
+			# ASYNC_WEBDRIVER_BRIDGE_HEADLESS=false
+			# ```
+			ASYNC_WEBDRIVER_BRIDGE_HEADLESS = 'ASYNC_WEBDRIVER_BRIDGE_HEADLESS'
+			
+			class UnsupportedError < Error
+			end
+			
+			# @returns [Bridge] The default bridge to use.
+			def self.default(env = ENV, **options)
+				if env[ASYNC_WEBDRIVER_BRIDGE_HEADLESS] == "false"
+					options[:headless] = false
+				end
+				
+				if name = env[ASYNC_WEBDRIVER_BRIDGE]
+					self.const_get(name).mew(**options)
+				else
+					ALL.each do |klass|
+						instance = klass.new(**options)
+						return instance if instance.supported?
+					end
+					
+					raise UnsupportedError, "No supported bridge found!"
+				end
+			end
 		end
 	end
 end

data/lib/async/webdriver/client.rb

@@ -60,7 +60,7 @@ module Async
 			def session(capabilities, &block)
 				reply = post("session", {capabilities: capabilities})
 				
-				session = Session.new(@delegate, reply["sessionId"], reply["value"])
+				session = Session.new(@delegate, reply["sessionId"], reply["capabilities"])
 				
 				return session unless block_given?
 				

data/lib/async/webdriver/error.rb

@@ -7,36 +7,6 @@ require_relative 'version'
 
 module Async
 	module WebDriver
-		# Error Code	HTTP Status	JSON Error Code	Description
-		# element click intercepted	400	element click intercepted	The Element Click command could not be completed because the element receiving the events is obscuring the element that was requested clicked.
-		# element not interactable	400	element not interactable	A command could not be completed because the element is not pointer- or keyboard interactable.
-		# insecure certificate	400	insecure certificate	Navigation caused the user agent to hit a certificate warning, which is usually the result of an expired or invalid TLS certificate.
-		# invalid argument	400	invalid argument	The arguments passed to a command are either invalid or malformed.
-		# invalid cookie domain	400	invalid cookie domain	An illegal attempt was made to set a cookie under a different domain than the current page.
-		# invalid element state	400	invalid element state	A command could not be completed because the element is in an invalid state, e.g. attempting to clear an element that isn’t both editable and resettable.
-		# invalid selector	400	invalid selector	Argument was an invalid selector.
-		# invalid session id	404	invalid session id	Occurs if the given session id is not in the list of active sessions, meaning the session either does not exist or that it’s not active.
-		# javascript error	500	javascript error	An error occurred while executing JavaScript supplied by the user.
-		# move target out of bounds	500	move target out of bounds	The target for mouse interaction is not in the browser’s viewport and cannot be brought into that viewport.
-		# no such alert	404	no such alert	An attempt was made to operate on a modal dialog when one was not open.
-		# no such cookie	404	no such cookie	No cookie matching the given path name was found amongst the associated cookies of the current browsing context’s active document.
-		# no such element	404	no such element	An element could not be located on the page using the given search parameters.
-		# no such frame	404	no such frame	A command to switch to a frame could not be satisfied because the frame could not be found.
-		# no such window	404	no such window	A command to switch to a window could not be satisfied because the window could not be found.
-		# no such shadow root	404	no such shadow root	The element does not have a shadow root.
-		# script timeout error	500	script timeout	A script did not complete before its timeout expired.
-		# session not created	500	session not created	A new session could not be created.
-		# stale element reference	404	stale element reference	A command failed because the referenced element is no longer attached to the DOM.
-		# detached shadow root	404	detached shadow root	A command failed because the referenced shadow root is no longer attached to the DOM.
-		# timeout	500	timeout	An operation did not complete before its timeout expired.
-		# unable to set cookie	500	unable to set cookie	A command to set a cookie’s value could not be satisfied.
-		# unable to capture screen	500	unable to capture screen	A screen capture was made impossible.
-		# unexpected alert open	500	unexpected alert open	A modal dialog was open, blocking this operation.
-		# unknown command	404	unknown command	A command could not be executed because the remote end is not aware of it.
-		# unknown error	500	unknown error	An unknown error occurred in the remote end while processing the command.
-		# unknown method	405	unknown method	The requested command matched a known URL but did not match any method for that URL.
-		# unsupported operation	500	unsupported operation	Indicates that a command that should have executed properly cannot be supported for some reason.
-
 		class Error < StandardError
 		end
 

data/lib/async/webdriver/locator.rb

@@ -3,8 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2023, by Samuel Williams.
 
-require 'base64'
-
 module Async
 	module WebDriver
 		# A locator is used to find elements in the DOM.

data/lib/async/webdriver/scope/elements.rb

@@ -3,8 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2023, by Samuel Williams.
 
-require 'base64'
-
 module Async
 	module WebDriver
 		module Scope

data/lib/async/webdriver/scope/fields.rb

@@ -3,8 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2023, by Samuel Williams.
 
-require 'base64'
-
 require_relative '../xpath'
 
 module Async

data/lib/async/webdriver/session.rb

@@ -30,8 +30,9 @@ module Async
 			# @returns [Session] The session if no block is given.
 			def self.open(endpoint, *arguments, **options)
 				client = self.new(
-					Async::HTTP::Client.open(endpoint, **options),
-					*arguments
+					Async::HTTP::Client.open(endpoint),
+					*arguments,
+					**options
 				)
 				
 				return client unless block_given?
@@ -47,10 +48,12 @@ module Async
 			# @parameter delegate [Protocol::HTTP::Middleware] The underlying HTTP client (or wrapper).
 			# @parameter id [String] The session identifier.
 			# @parameter capabilities [Hash] The capabilities of the session.
-			def initialize(delegate, id, capabilities)
+			def initialize(delegate, id, capabilities, **options)
 				@delegate = delegate
 				@id = id
 				@capabilities = capabilities
+				
+				@options = options
 			end
 			
 			def inspect

data/lib/async/webdriver/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module WebDriver
-		VERSION = "0.3.1"
+		VERSION = "0.5.0"
 	end
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2023, by Samuel Williams.  
+Copyright, 2023-2024, by Samuel Williams.  
 
 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

@@ -18,6 +18,10 @@ Please see the [project documentation](https://socketry.github.io/async-webdrive
 
   - [GitHub Actions Integrations](https://socketry.github.io/async-webdriver/guides/github-actions-integration/index) - This guide explains how to use `async-webdriver` with GitHub Actions.
 
+## See Also
+
+  - [sus-fixtures-async-webdriver](https://github.com/socketry/sus-fixtures-async-webdriver) - STandard fixtures for testing web applications with `async-webdriver`.
+
 ## Contributing
 
 We welcome contributions to this project.
@@ -34,4 +38,4 @@ This project uses the [Developer Certificate of Origin](https://developercertifi
 
 ### Contributor Covenant
 
-This project is governed by [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-webdriver
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,22 +37,78 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2023-12-04 00:00:00.000000000 Z
+date: 2024-05-04 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: async-actor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.42'
+        version: '0.61'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.61'
+- !ruby/object:Gem::Dependency
+  name: async-pool
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: async-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.42'
+        version: '0.2'
 description:
 email:
 executables: []
@@ -62,6 +118,7 @@ files:
 - lib/async/webdriver.rb
 - lib/async/webdriver/bridge.rb
 - lib/async/webdriver/bridge/chrome.rb
+- lib/async/webdriver/bridge/driver.rb
 - lib/async/webdriver/bridge/firefox.rb
 - lib/async/webdriver/bridge/generic.rb
 - lib/async/webdriver/bridge/pool.rb
@@ -87,12 +144,13 @@ files:
 - lib/async/webdriver/xpath.rb
 - license.md
 - readme.md
-homepage: https://github.com/socketry/async-webdriver/
+homepage: https://github.com/socketry/async-webdriver
 licenses:
 - MIT
 metadata:
   documentation_uri: https://socketry.github.io/async-webdriver/
   funding_uri: https://github.com/sponsors/ioquatix
+  source_code_uri: https://github.com/socketry/async-webdriver.git
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -101,14 +159,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A native library implementing the W3C WebDriver client specification.