osn-selenium 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

osn_selenium/webdrivers/trio_bidi/chrome/__init__.py

@@ -0,0 +1,114 @@
+import trio
+from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.chrome import ChromeFlagsManager
+from osn_selenium.flags.models.chrome import ChromeFlags
+from osn_selenium.dev_tools.settings import DevToolsSettings
+from osn_selenium.webdrivers.trio_bidi.blink import BlinkWebDriver
+from osn_selenium.webdrivers.trio_bidi.chrome.base import ChromeBaseMixin
+from osn_selenium.abstract.webdriver.chrome import (
+	AbstractChromeWebDriver
+)
+from osn_selenium.webdrivers.trio_bidi.chrome.settings import ChromeSettingsMixin
+from osn_selenium.webdrivers.trio_bidi.chrome.lifecycle import ChromeLifecycleMixin
+
+
+__all__ = ["ChromeWebDriver"]
+
+
+class ChromeWebDriver(
+		ChromeBaseMixin,
+		ChromeLifecycleMixin,
+		ChromeSettingsMixin,
+		BlinkWebDriver,
+		AbstractChromeWebDriver,
+):
+	"""
+	Concrete Chrome WebDriver implementation combining all functional mixins.
+
+	This class aggregates lifecycle management, element interaction, navigation,
+	and browser-specific features into a single usable driver instance.
+	"""
+	
+	def __init__(
+			self,
+			webdriver_path: str,
+			flags_manager_type: Type[ChromeFlagsManager] = ChromeFlagsManager,
+			use_browser_exe: bool = True,
+			browser_name_in_system: str = "Google Chrome",
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			flags: Optional[ChromeFlags] = None,
+			start_page_url: str = "about:blank",
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			devtools_settings: Optional[DevToolsSettings] = None,
+			capacity_limiter: Optional[trio.CapacityLimiter] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+	):
+		"""
+		Initializes the Trio-based Chrome WebDriver with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the ChromeDriver executable.
+			flags_manager_type (Type[ChromeFlagsManager]): The class type used for managing Chrome flags.
+				Defaults to ChromeFlagsManager.
+			use_browser_exe (bool): Whether to use a specific browser executable path or auto-detect.
+				Defaults to True.
+			browser_name_in_system (str): The name of the browser in the system registry or path.
+				Defaults to "Google Chrome".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Chrome browser executable.
+			flags (Optional[ChromeFlags]): Initial set of flags.
+			start_page_url (str): The initial URL. Defaults to "about:blank".
+			implicitly_wait (int): Default implicit wait time.
+			page_load_timeout (int): Default page load timeout.
+			script_timeout (int): Default script timeout.
+			window_rect (Optional[WindowRect]): Initial window dimensions.
+			capacity_limiter (Optional[trio.CapacityLimiter]): Trio capacity limiter.
+			cdp_versioned_packages_paths (Optional[Mapping[int, PATH_TYPEHINT]]): Custom local paths for specific CDP versions packages.
+			ignore_cdp_version_package_missing (bool): Whether to ignore missing CDP package errors.
+		"""
+		
+		BlinkWebDriver.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				webdriver_path=webdriver_path,
+				use_browser_exe=use_browser_exe,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				devtools_settings=devtools_settings,
+				capacity_limiter=capacity_limiter,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+		
+		ChromeBaseMixin.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				webdriver_path=webdriver_path,
+				architecture="trio_bidi",
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				capacity_limiter=capacity_limiter,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)

osn_selenium/webdrivers/trio_bidi/chrome/base.py

@@ -0,0 +1,127 @@
+import math
+import trio
+from osn_selenium.models import WindowRect
+from osn_selenium.flags.chrome import ChromeFlagsManager
+from osn_selenium.flags.models.chrome import ChromeFlags
+from typing import (
+	Mapping,
+	Optional,
+	Type,
+	Union
+)
+from selenium.webdriver import (
+	Chrome as legacyChrome
+)
+from osn_selenium.webdrivers.trio_bidi.blink.base import BlinkBaseMixin
+from osn_selenium._typehints import (
+	ARCHITECTURES_TYPEHINT,
+	PATH_TYPEHINT
+)
+from osn_selenium.webdrivers.unified.chrome.base import (
+	UnifiedChromeBaseMixin
+)
+from osn_selenium.abstract.webdriver.chrome.base import (
+	AbstractChromeBaseMixin
+)
+
+
+__all__ = ["ChromeBaseMixin"]
+
+
+class ChromeBaseMixin(UnifiedChromeBaseMixin, BlinkBaseMixin, AbstractChromeBaseMixin):
+	"""
+	Base mixin for Chrome WebDrivers handling core initialization and state management.
+
+	This class serves as the foundation for browser-specific implementations, managing
+	the WebDriver executable path, configuration flags, timeouts, and the active
+	driver instance.
+	"""
+	
+	def __init__(
+			self,
+			webdriver_path: str,
+			architecture: ARCHITECTURES_TYPEHINT,
+			flags_manager_type: Type[ChromeFlagsManager] = ChromeFlagsManager,
+			use_browser_exe: bool = True,
+			browser_name_in_system: str = "Google Chrome",
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			flags: Optional[ChromeFlags] = None,
+			start_page_url: str = "about:blank",
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			capacity_limiter: Optional[trio.CapacityLimiter] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+			trio_token: Optional[trio.lowlevel.TrioToken] = None,
+			bidi_buffer_size: Union[int, float] = math.inf,
+	):
+		"""
+		Initializes the Trio-based Chrome WebDriver mixin with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the ChromeDriver executable.
+			architecture (ARCHITECTURE_TYPEHINT): System architecture.
+			flags_manager_type (Type[ChromeFlagsManager]): The class type used for managing Chrome flags.
+				Defaults to ChromeFlagsManager.
+			use_browser_exe (bool): Whether to use a specific browser executable path or auto-detect.
+				Defaults to True.
+			browser_name_in_system (str): The name of the browser in the system registry or path.
+				Defaults to "Google Chrome".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Chrome browser executable.
+			flags (Optional[ChromeFlags]): Initial set of flags.
+			start_page_url (str): The initial URL. Defaults to "about:blank".
+			implicitly_wait (int): Default implicit wait time.
+			page_load_timeout (int): Default page load timeout.
+			script_timeout (int): Default script timeout.
+			window_rect (Optional[WindowRect]): Initial window dimensions.
+			capacity_limiter (Optional[trio.CapacityLimiter]): Trio capacity limiter.
+			cdp_versioned_packages_paths (Optional[Mapping[int, PATH_TYPEHINT]]): Custom local paths for specific CDP versions packages.
+			ignore_cdp_version_package_missing (bool): Whether to ignore missing CDP package errors.
+			trio_token (Optional[trio.lowlevel.TrioToken]): The Trio token for the current event loop.
+			bidi_buffer_size (Union[int, float]): Buffer size for the BiDi task channel.
+		"""
+		
+		BlinkBaseMixin.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				webdriver_path=webdriver_path,
+				architecture=architecture,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				capacity_limiter=capacity_limiter,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+				trio_token=trio_token,
+				bidi_buffer_size=bidi_buffer_size,
+		)
+		
+		UnifiedChromeBaseMixin.__init__(
+				self,
+				webdriver_path=webdriver_path,
+				architecture=architecture,
+				flags_manager_type=flags_manager_type,
+				use_browser_exe=use_browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				browser_exe=browser_exe,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+	
+	@property
+	def driver(self) -> Optional[legacyChrome]:
+		return self._driver_impl

osn_selenium/webdrivers/trio_bidi/chrome/lifecycle.py

@@ -0,0 +1,85 @@
+from typing import Optional
+from osn_selenium.models import WindowRect
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.models.chrome import ChromeFlags
+from osn_selenium.webdrivers.trio_bidi.blink.lifecycle import BlinkLifecycleMixin
+from osn_selenium.webdrivers.unified.chrome.lifecycle import (
+	UnifiedChromeLifecycleMixin
+)
+from osn_selenium.abstract.webdriver.chrome.lifecycle import (
+	AbstractChromeLifecycleMixin
+)
+
+
+__all__ = ["ChromeLifecycleMixin"]
+
+
+class ChromeLifecycleMixin(
+		UnifiedChromeLifecycleMixin,
+		BlinkLifecycleMixin,
+		AbstractChromeLifecycleMixin
+):
+	"""
+	Mixin for managing the lifecycle of the Chrome WebDriver.
+
+	Handles the creation, startup, shutdown, and restarting processes of the
+	underlying browser instance, ensuring clean session management.
+	"""
+	
+	async def start_webdriver(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		await self.sync_to_trio(sync_function=self._start_webdriver_impl)(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+		await self._start_bidi_bridge()
+	
+	async def __aenter__(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		await self.start_webdriver(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+	
+	async def restart_webdriver(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		await self.sync_to_trio(sync_function=self._restart_webdriver_impl)(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+		
+		await self._stop_bidi_bridge()
+		await self._start_bidi_bridge()

osn_selenium/webdrivers/trio_bidi/chrome/settings.py

@@ -0,0 +1,63 @@
+from typing import Optional
+from osn_selenium.models import WindowRect
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.models.chrome import ChromeFlags
+from osn_selenium.webdrivers.trio_bidi.blink.settings import BlinkSettingsMixin
+from osn_selenium.webdrivers.unified.chrome.settings import (
+	UnifiedChromeSettingsMixin
+)
+from osn_selenium.abstract.webdriver.chrome.settings import (
+	AbstractChromeSettingsMixin
+)
+
+
+__all__ = ["ChromeSettingsMixin"]
+
+
+class ChromeSettingsMixin(
+		UnifiedChromeSettingsMixin,
+		BlinkSettingsMixin,
+		AbstractChromeSettingsMixin
+):
+	"""
+	Mixin for configuring and updating settings of the Chrome WebDriver.
+
+	Provides methods to modify browser flags, window rectangles, and other
+	configuration parameters either before startup or during a reset.
+	"""
+	
+	async def reset_settings(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: str = "",
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		await self.sync_to_trio(sync_function=self._reset_settings_impl)(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+	
+	async def update_settings(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		await self.sync_to_trio(sync_function=self._update_settings_impl)(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)

osn_selenium/webdrivers/trio_bidi/core/__init__.py

@@ -0,0 +1,95 @@
+import trio
+from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.base import BrowserFlagsManager
+from osn_selenium.flags.models.base import BrowserFlags
+from osn_selenium.webdrivers.trio_bidi.core.base import CoreBaseMixin
+from osn_selenium.webdrivers.trio_bidi.core.script import CoreScriptMixin
+from osn_selenium.webdrivers.trio_bidi.core.window import CoreWindowMixin
+from osn_selenium.abstract.webdriver.core import (
+	AbstractCoreWebDriver
+)
+from osn_selenium.webdrivers.trio_bidi.core.actions import CoreActionsMixin
+from osn_selenium.webdrivers.trio_bidi.core.capture import CoreCaptureMixin
+from osn_selenium.webdrivers.trio_bidi.core.element import CoreElementMixin
+from osn_selenium.webdrivers.trio_bidi.core.devtools import CoreDevToolsMixin
+from osn_selenium.webdrivers.trio_bidi.core.settings import CoreSettingsMixin
+from osn_selenium.webdrivers.trio_bidi.core.lifecycle import CoreLifecycleMixin
+from osn_selenium.webdrivers.trio_bidi.core.navigation import CoreNavigationMixin
+
+
+__all__ = ["CoreWebDriver"]
+
+
+class CoreWebDriver(
+		CoreActionsMixin,
+		CoreBaseMixin,
+		CoreCaptureMixin,
+		CoreDevToolsMixin,
+		CoreElementMixin,
+		CoreLifecycleMixin,
+		CoreNavigationMixin,
+		CoreScriptMixin,
+		CoreSettingsMixin,
+		CoreWindowMixin,
+		AbstractCoreWebDriver,
+):
+	"""
+	Concrete Core WebDriver implementation combining all functional mixins.
+
+	This class aggregates lifecycle management, element interaction, navigation,
+	and browser-specific features into a single usable driver instance.
+	"""
+	
+	def __init__(
+			self,
+			webdriver_path: str,
+			flags_manager_type: Type[BrowserFlagsManager] = BrowserFlagsManager,
+			flags: Optional[BrowserFlags] = None,
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			capacity_limiter: Optional[trio.CapacityLimiter] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+	) -> None:
+		"""
+		Initializes the main WebDriver instance with Trio thread support.
+
+		Args:
+			webdriver_path (str): The file path to the WebDriver executable.
+			flags_manager_type (Type[BrowserFlagsManager]): The class type used to manage
+				browser-specific configuration flags. Defaults to BrowserFlagsManager.
+			flags (Optional[BrowserFlags]): Initial set of browser flags or options
+				to apply upon startup. Defaults to None.
+			implicitly_wait (int): The amount of time (in seconds) that the driver should
+				wait when searching for elements. Defaults to 5.
+			page_load_timeout (int): The amount of time (in seconds) to wait for a page
+				load to complete. Defaults to 5.
+			script_timeout (int): The amount of time (in seconds) to wait for an
+				asynchronous script to finish execution. Defaults to 5.
+			window_rect (Optional[WindowRect]): The initial size and position of the
+				browser window. Defaults to None.
+			capacity_limiter (Optional[trio.CapacityLimiter]): A Trio capacity limiter used to
+				throttle concurrent thread-based operations. Defaults to None.
+		"""
+		
+		CoreBaseMixin.__init__(
+				self,
+				webdriver_path=webdriver_path,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				capacity_limiter=capacity_limiter,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)

osn_selenium/webdrivers/trio_bidi/core/actions.py

@@ -0,0 +1,70 @@
+from typing_extensions import deprecated
+from typing import (
+	Iterable,
+	List,
+	Optional
+)
+from osn_selenium._typehints import DEVICES_TYPEHINT
+from osn_selenium.trio_bidi.mixin import TrioBiDiMixin
+from osn_selenium.webdrivers.trio_bidi.core.script import CoreScriptMixin
+from osn_selenium.instances.trio_bidi.web_driver_wait import WebDriverWait
+from osn_selenium.instances.convert import (
+	get_trio_bidi_instance_wrapper
+)
+from osn_selenium.webdrivers.unified.core.actions import (
+	UnifiedCoreActionsMixin
+)
+from osn_selenium.abstract.webdriver.core.actions import (
+	AbstractCoreActionsMixin
+)
+from osn_selenium.exceptions.experimental import (
+	NotImplementedExperimentalFeatureError
+)
+
+
+__all__ = ["CoreActionsMixin"]
+
+
+class CoreActionsMixin(
+		UnifiedCoreActionsMixin,
+		CoreScriptMixin,
+		TrioBiDiMixin,
+		AbstractCoreActionsMixin
+):
+	"""
+	Mixin providing high-level interaction capabilities for Core WebDrivers.
+
+	Includes factories for standard and human-like ActionChains, as well as
+	custom WebDriverWait implementations.
+	"""
+	
+	@deprecated(
+			"This method is currently not supported. It will raise 'NotImplementedExperimentalFeatureError' on call."
+	)
+	def action_chains(
+			self,
+			duration: int = 250,
+			devices: Optional[List[DEVICES_TYPEHINT]] = None,
+	):
+		raise NotImplementedExperimentalFeatureError(name="CoreActionsMixin.action_chains")
+	
+	def web_driver_wait(
+			self,
+			timeout: float,
+			poll_frequency: float = 0.5,
+			ignored_exceptions: Optional[Iterable[BaseException]] = None,
+	) -> WebDriverWait:
+		legacy = self._web_driver_wait_impl(
+				timeout=timeout,
+				poll_frequency=poll_frequency,
+				ignored_exceptions=ignored_exceptions
+		)
+		
+		return get_trio_bidi_instance_wrapper(
+				wrapper_class=WebDriverWait,
+				legacy_object=legacy,
+				lock=self._lock,
+				limiter=self._capacity_limiter,
+				trio_token=self._trio_token,
+				bidi_buffer_size=self._trio_bidi_buffer_size,
+		)