async-webdriver 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da08a7e4f4e91c945652030f4616b76e9b087cc84efb98f6ee48c99504407abc
-  data.tar.gz: bf78251edf46c21d60b73adfa60b3105a9c114a9c0de26454ca59ed1cba85198
+  metadata.gz: bf43f03c5d84881a589b4b8ada0b4b610bd81d7434b42387986c2e62be565748
+  data.tar.gz: eeeda998354a547586c84f796a74062304510e3778011d18e60bead39ffb9d63
 SHA512:
-  metadata.gz: 79921aa72ebc306b70a5615de0aec9b2ffa5e6c56186f08ce781b69837f71911334512148678320da898dcf546f310de9157e554ee65a00bd37b05f6584f6303
-  data.tar.gz: 7f193306b1552c179a96b8d2ca832b979d6118bea9c8c9a22da5550e454de1b3282605486191727ed5af7cd3eb674c0b231bb8aad82b84f7ad353c08f5c23adf
+  metadata.gz: 061ec510b866722f3893e549153532e8053a8aa4301316b338fec0bdd0785d00e7b84257969bfd2622581aecedaf59dd08f375577f051fc64c51ab4411b9fbe0
+  data.tar.gz: 73ef488209fcdff4efb657b3c47b61459de197e9303790ed59356e05c6f7553155971b225d2271987da64e7336d5343aa5de4882bf0610c6d435cad369860c86

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

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023-2024, by Samuel Williams.
+
+require_relative 'generic'
+require_relative 'process_group'
+
+module Async
+	module WebDriver
+		module Bridge
+			# A bridge to the Safari browser using `safaridriver`.
+			#
+			# ``` ruby
+			# begin
+			# 	bridge = Async::WebDriver::Bridge::Safari.start
+			# 	client = Async::WebDriver::Client.open(bridge.endpoint)
+			# ensure
+			# 	bridge&.close
+			# end
+			# ```
+			class Safari < Generic
+				def path
+					@options.fetch(:path, "safaridriver")
+				end
+				
+				# @returns [String] The version of the `safaridriver` executable.
+				def version
+					::IO.popen([self.path, "--version"]) do |io|
+						return io.read
+					end
+				rescue Errno::ENOENT
+					return nil
+				end
+				
+				class Driver < Bridge::Driver
+					def initialize(**options)
+						super(**options)
+						@process_group = nil
+					end
+					
+					# @returns [Array(String)] The arguments to pass to the `safaridriver` executable.
+					def arguments(**options)
+						[
+							options.fetch(:path, "safaridriver"),
+							"--port=#{self.port}",
+						].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 Safari 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 Safari browser.
+				def default_capabilities(headless: self.headless?)
+					{
+						alwaysMatch: {
+							browserName: "safari",
+						},
+					}
+				end
+			end
+		end
+	end
+end

data/lib/async/webdriver/bridge.rb

@@ -5,6 +5,7 @@
 
 require_relative 'bridge/chrome'
 require_relative 'bridge/firefox'
+require_relative 'bridge/safari'
 
 require_relative 'error'
 
@@ -17,6 +18,7 @@ module Async
 			ALL = [
 				Bridge::Chrome,
 				Bridge::Firefox,
+				Bridge::Safari,
 			]
 			
 			def self.each(&block)

data/lib/async/webdriver/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-webdriver
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -123,6 +123,7 @@ files:
 - lib/async/webdriver/bridge/generic.rb
 - lib/async/webdriver/bridge/pool.rb
 - lib/async/webdriver/bridge/process_group.rb
+- lib/async/webdriver/bridge/safari.rb
 - lib/async/webdriver/client.rb
 - lib/async/webdriver/element.rb
 - lib/async/webdriver/error.rb