sus-fixtures-async-webdriver 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d117bc1968ff83bc9c09fc192f096939e6359d446bd4528c027f65f8f3cffa4
-  data.tar.gz: 31bf4661190b95dc50faa87e7680adbd5ed6f9d8b9163a4bef72b516b2e598d4
+  metadata.gz: 5b2db086816dba9ccdeda6e616fa7061c1bdfc566c1a93f44171a27d3025d469
+  data.tar.gz: 683370ebe7cdedb936d9afca32c14a6bdc8ec8258457b9cc0b141fc040010fca
 SHA512:
-  metadata.gz: bc36d496b42921bf10368ea166cc69edfa42e1e607c7810bff0bb4e9521feaa87aa092baf7e7698d859028940b42962eca8fd85a4178d6949c2eb98764d41d39
-  data.tar.gz: 50734787e437a593fda343969b47b10bf480a38de0ce3f9a72495131c65583f43a58a7ebd6ba3a9abff7c4094655309b46185028b131249b46d1c8ebf1c554ac
+  metadata.gz: adb1ad8e5ad03fbc42cce1a599a6f7057034e343d901bd296e615b3cce3536785bc990378b2fbe01de43ec5853a9408c894942c07e4d0a99e855e8499940e9fb
+  data.tar.gz: 00b007a710ebbfdeda0ef446717485b17ff83dfd3ee3c45902711de70f3d2c2f08a0fa913ca53beb78240a32787cf66f9d0a143dcbacf8f93cd657e28b9e57c7

data/lib/sus/fixtures/async/webdriver/session_context.rb

@@ -10,6 +10,7 @@ module Sus
 	module Fixtures
 		module Async
 			module WebDriver
+				# The session context provides a way to manage the lifecycle of a WebDriver session.
 				module SessionContext
 					GUARD = Thread::Mutex.new
 					
@@ -25,8 +26,16 @@ module Sus
 						end
 					end
 					
+					def make_session
+						SessionContext.pool.session.tap do |session|
+							# 1 second timeout for implicit waits.
+							session.implicit_wait_timeout = 1000
+						end
+					end
+					
+					# The current session, that represents the browser window.
 					def session
-						@session ||= SessionContext.pool.session
+						@session ||= make_session
 					end
 					
 					def before
@@ -44,14 +53,20 @@ module Sus
 						super
 					end
 					
+					# Navigate to a specific path within the website.
+					# @parameter path [String] The path to navigate to.
 					def navigate_to(path)
 						session.navigate_to(URI.join(bound_url, path))
 					end
 					
+					# Find an element within the current session.
+					# @parameter locator [Hash] The locator to use to find the element.
 					def find_element(...)
 						session.find_element(::Async::WebDriver::Locator.wrap(...))
 					end
 					
+					# Find all elements matching the given locator.
+					# @parameter locator [Hash] The locator to use to find the elements.
 					def find_elements(...)
 						session.find_elements(::Async::WebDriver::Locator.wrap(...))
 					end
@@ -87,6 +102,7 @@ module Sus
 						end
 					end
 					
+					# Check if the current session has an element matching the given locator.
 					def have_element(...)
 						HaveElement.new(::Async::WebDriver::Locator.wrap(...))
 					end
@@ -106,6 +122,7 @@ module Sus
 						end
 					end
 					
+					# Check if an element has properties matching the given key-value pairs.
 					def have_properties(**properties)
 						predicates = properties.map do |key, value|
 							HaveProperty.new(key, value)

data/lib/sus/fixtures/async/webdriver/version.rb

@@ -7,7 +7,7 @@ module Sus
 	module Fixtures
 		module Async
 			module WebDriver
-				VERSION = "0.1.0"
+				VERSION = "0.1.2"
 			end
 		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

@@ -6,7 +6,13 @@ Provides test fixtures for [async-webdriver](https://github.com/socketry/async-w
 
 ## Usage
 
-See `examples/rack` for a full example.
+Please see the [project documentation](https://socketry.github.io/sus-fixtures-async-webdriver/) for more details.
+
+  - [Getting Started](https://socketry.github.io/sus-fixtures-async-webdriver/guides/getting-started/index) - This guide is designed to help you get started with the `sus-fixtures-async-webdriver` gem.
+
+## See Also
+
+  - [async-webdriver](https://github.com/socketry/async-webdriver) - Asynchronous WebDriver client used by this fixture.
 
 ## Contributing
 
@@ -24,4 +30,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: sus-fixtures-async-webdriver
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2023-12-08 00:00:00.000000000 Z
+date: 2024-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-webdriver
@@ -63,12 +63,13 @@ files:
 - lib/sus/fixtures/async/webdriver/version.rb
 - license.md
 - readme.md
-homepage: https://github.com/socketry/sus-fixtures-async-webdriver/
+homepage: https://github.com/socketry/sus-fixtures-async-webdriver
 licenses:
 - MIT
 metadata:
   documentation_uri: https://socketry.github.io/sus-fixtures-async-webdriver/
   funding_uri: https://github.com/sponsors/ioquatix
+  source_code_uri: https://github.com/socketry/sus-fixtures-async-webdriver.git
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -77,14 +78,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.10
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A set of sus fixtures for writing integration tests.