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

osn_selenium/webdrivers/trio_threads/core/base.py

@@ -1,24 +1,26 @@
 import trio
 from osn_selenium.models import WindowRect
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
+from osn_selenium.flags.base import BrowserFlagsManager
+from osn_selenium.flags.models.base import BrowserFlags
+from selenium.webdriver.common.bidi.session import Session
 from typing import (
 	Any,
 	Dict,
+	Mapping,
 	Optional,
 	Type
 )
-from osn_selenium.flags.base import BrowserFlagsManager
-from osn_selenium.flags.models.base import BrowserFlags
-from selenium.webdriver.common.bidi.session import Session
-from osn_selenium._typehints import (
-	ARCHITECTURES_TYPEHINT
-)
 from selenium.webdriver.remote.errorhandler import ErrorHandler
 from osn_selenium.executors.trio_threads.cdp import CDPExecutor
 from osn_selenium.executors.trio_threads.javascript import JSExecutor
 from selenium.webdriver.remote.locator_converter import LocatorConverter
 from selenium.webdriver.remote.remote_connection import RemoteConnection
 from osn_selenium.webdrivers.unified.core.base import UnifiedCoreBaseMixin
+from osn_selenium._typehints import (
+	ARCHITECTURES_TYPEHINT,
+	PATH_TYPEHINT
+)
 from osn_selenium.abstract.webdriver.core.base import (
 	AbstractCoreBaseMixin
 )
@@ -51,6 +53,8 @@ class CoreBaseMixin(UnifiedCoreBaseMixin, TrioThreadMixin, AbstractCoreBaseMixin
 			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 base mixin for Trio-based WebDrivers.
@@ -74,6 +78,8 @@ class CoreBaseMixin(UnifiedCoreBaseMixin, TrioThreadMixin, AbstractCoreBaseMixin
 				browser window. Defaults to None.
 			capacity_limiter (Optional[trio.CapacityLimiter]): A Trio capacity limiter used to
 				throttle concurrent thread-based operations. Defaults to None.
+			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.
 		"""
 		
 		UnifiedCoreBaseMixin.__init__(
@@ -86,6 +92,8 @@ class CoreBaseMixin(UnifiedCoreBaseMixin, TrioThreadMixin, AbstractCoreBaseMixin
 				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,
 		)
 		
 		TrioThreadMixin.__init__(

osn_selenium/webdrivers/trio_threads/core/capture.py

@@ -1,5 +1,5 @@
 from typing import Any, Optional
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.webdrivers.unified.core.capture import (
 	UnifiedCoreCaptureMixin
 )

osn_selenium/webdrivers/trio_threads/core/comonents.py

@@ -1,4 +1,4 @@
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.instances.trio_threads.dialog import Dialog
 from osn_selenium.instances.trio_threads.mobile import Mobile
 from osn_selenium.instances.trio_threads.browser import Browser

osn_selenium/webdrivers/trio_threads/core/devtools.py

@@ -1,5 +1,5 @@
 from contextlib import asynccontextmanager
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from typing import (
 	Any,
 	AsyncGenerator,

osn_selenium/webdrivers/trio_threads/core/element.py

@@ -1,6 +1,6 @@
 from typing import List, Optional
 from selenium.webdriver.common.by import By
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.instances.trio_threads.web_element import WebElement
 from osn_selenium.instances.convert import (
 	get_trio_thread_instance_wrapper

osn_selenium/webdrivers/trio_threads/core/file.py

@@ -4,7 +4,7 @@ from typing import (
 	AsyncGenerator,
 	List
 )
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.webdrivers.unified.core.file import UnifiedCoreFileMixin
 from osn_selenium.abstract.webdriver.core.file import (
 	AbstractCoreFileMixin
@@ -38,7 +38,7 @@ class CoreFileMixin(UnifiedCoreFileMixin, TrioThreadMixin, AbstractCoreFileMixin
 	
 	@asynccontextmanager
 	async def file_detector_context(self, file_detector_class: Any, *args: Any, **kwargs: Any) -> AsyncGenerator[Any, Any]:
-		async with self.sync_to_trio_context(context_manager_factory=self.driver.file_detector_context)(file_detector_class, *args, **kwargs) as file_detector:
+		async with self.sync_to_trio_context(context_manager_factory=self._file_detector_context_impl)(file_detector_class, *args, **kwargs) as file_detector:
 			yield file_detector
 	
 	async def get_downloadable_files(self) -> List[str]:

osn_selenium/webdrivers/trio_threads/core/lifecycle.py

@@ -1,5 +1,5 @@
 from osn_selenium.models import WindowRect
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from typing import (
 	Any,
 	Dict,

osn_selenium/webdrivers/trio_threads/core/navigation.py

@@ -1,4 +1,4 @@
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.webdrivers.unified.core.navigation import (
 	UnifiedCoreNavigationMixin
 )

osn_selenium/webdrivers/trio_threads/core/script.py

@@ -1,5 +1,5 @@
 from typing import Any, List, Optional
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.instances.trio_threads.script import Script
 from osn_selenium.instances.convert import (
 	get_trio_thread_instance_wrapper

osn_selenium/webdrivers/trio_threads/core/settings.py

@@ -1,6 +1,6 @@
 from typing import Optional
 from osn_selenium.models import WindowRect
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.flags.models.base import BrowserFlags
 from osn_selenium.webdrivers.unified.core.settings import (
 	UnifiedCoreSettingsMixin

osn_selenium/webdrivers/trio_threads/core/storage.py

@@ -1,4 +1,4 @@
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from typing import (
 	Any,
 	Dict,

osn_selenium/webdrivers/trio_threads/core/timeouts.py

@@ -1,5 +1,5 @@
 from typing import Optional
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from selenium.webdriver.common.timeouts import Timeouts
 from osn_selenium.webdrivers.unified.core.timeouts import (
 	UnifiedCoreTimeoutsMixin

osn_selenium/webdrivers/trio_threads/core/window.py

@@ -1,4 +1,4 @@
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from typing import (
 	List,
 	Literal,
@@ -92,8 +92,8 @@ class CoreWindowMixin(UnifiedCoreWindowMixin, TrioThreadMixin, AbstractCoreWindo
 	async def set_window_size(self, width: int, height: int, windowHandle: str = "current") -> None:
 		await self.sync_to_trio(sync_function=self._set_window_size_impl)(width=width, height=height, windowHandle=windowHandle)
 	
-	async def switch_to(self) -> SwitchTo:
-		legacy = await self.sync_to_trio(sync_function=self._switch_to_impl)()
+	def switch_to(self) -> SwitchTo:
+		legacy = self._switch_to_impl()
 		return get_trio_thread_instance_wrapper(
 				wrapper_class=SwitchTo,
 				legacy_object=legacy,

osn_selenium/webdrivers/trio_threads/edge/__init__.py

@@ -1,6 +1,10 @@
 import trio
-from typing import Optional, Type
 from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
 from osn_selenium._typehints import PATH_TYPEHINT
 from osn_selenium.flags.edge import EdgeFlagsManager
 from osn_selenium.flags.models.edge import EdgeFlags
@@ -46,7 +50,32 @@ class EdgeWebDriver(
 			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 Edge WebDriver with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the EdgeDriver executable.
+			flags_manager_type (Type[EdgeFlagsManager]): The class type used for managing Edge flags.
+				Defaults to EdgeFlagsManager.
+			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 "Microsoft Edge".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Edge browser executable.
+			flags (Optional[EdgeFlags]): 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,
@@ -61,6 +90,8 @@ class EdgeWebDriver(
 				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,
 		)
 		
 		EdgeBaseMixin.__init__(
@@ -78,4 +109,6 @@ class EdgeWebDriver(
 				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_threads/edge/base.py

@@ -1,6 +1,10 @@
 import trio
-from typing import Optional, Type
 from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
 from selenium.webdriver import Edge as legacyEdge
 from osn_selenium.flags.edge import EdgeFlagsManager
 from osn_selenium.flags.models.edge import EdgeFlags
@@ -42,9 +46,11 @@ class EdgeBaseMixin(UnifiedEdgeBaseMixin, BlinkBaseMixin, AbstractEdgeBaseMixin)
 			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,
 	):
 		"""
-		Initializes the Trio-based Edge WebDriver mixin.
+		Initializes the Trio-based Edge WebDriver mixin with specified configuration.
 
 		Args:
 			webdriver_path (str): Path to the EdgeDriver executable.
@@ -63,6 +69,8 @@ class EdgeBaseMixin(UnifiedEdgeBaseMixin, BlinkBaseMixin, AbstractEdgeBaseMixin)
 			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.
 		"""
 		
 		BlinkBaseMixin.__init__(
@@ -80,6 +88,8 @@ class EdgeBaseMixin(UnifiedEdgeBaseMixin, BlinkBaseMixin, AbstractEdgeBaseMixin)
 				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,
 		)
 		
 		UnifiedEdgeBaseMixin.__init__(
@@ -96,6 +106,8 @@ class EdgeBaseMixin(UnifiedEdgeBaseMixin, BlinkBaseMixin, AbstractEdgeBaseMixin)
 				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

osn_selenium/webdrivers/trio_threads/yandex/__init__.py

@@ -1,6 +1,10 @@
 import trio
-from typing import Optional, Type
 from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
 from osn_selenium._typehints import PATH_TYPEHINT
 from osn_selenium.flags.models.yandex import YandexFlags
 from osn_selenium.flags.yandex import YandexFlagsManager
@@ -46,7 +50,32 @@ class YandexWebDriver(
 			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 Yandex WebDriver with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the YandexDriver executable.
+			flags_manager_type (Type[YandexFlagsManager]): The class type used for managing Yandex flags.
+				Defaults to YandexFlagsManager.
+			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 "Yandex".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Yandex browser executable.
+			flags (Optional[YandexFlags]): 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.
+		"""
+		
 		ChromeWebDriver.__init__(
 				self,
 				browser_exe=browser_exe,
@@ -61,6 +90,8 @@ class YandexWebDriver(
 				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,
 		)
 		
 		YandexBaseMixin.__init__(
@@ -78,4 +109,6 @@ class YandexWebDriver(
 				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_threads/yandex/base.py

@@ -1,6 +1,10 @@
 import trio
-from typing import Optional, Type
 from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
 from osn_selenium.flags.models.yandex import YandexFlags
 from osn_selenium.flags.yandex import YandexFlagsManager
 from osn_selenium.webdrivers.trio_threads.chrome.base import ChromeBaseMixin
@@ -43,9 +47,11 @@ class YandexBaseMixin(UnifiedYandexBaseMixin, ChromeBaseMixin, AbstractYandexBas
 			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,
 	):
 		"""
-		Initializes the Trio-based Yandex WebDriver mixin.
+		Initializes the Trio-based Yandex WebDriver mixin with specified configuration.
 
 		Args:
 			webdriver_path (str): Path to the YandexDriver executable.
@@ -64,6 +70,8 @@ class YandexBaseMixin(UnifiedYandexBaseMixin, ChromeBaseMixin, AbstractYandexBas
 			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.
 		"""
 		
 		ChromeBaseMixin.__init__(
@@ -81,6 +89,8 @@ class YandexBaseMixin(UnifiedYandexBaseMixin, ChromeBaseMixin, AbstractYandexBas
 				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,
 		)
 		
 		UnifiedYandexBaseMixin.__init__(
@@ -97,4 +107,6 @@ class YandexBaseMixin(UnifiedYandexBaseMixin, ChromeBaseMixin, AbstractYandexBas
 				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,
 		)

osn_selenium/webdrivers/unified/blink/base.py

@@ -1,5 +1,5 @@
 import pathlib
-from typing import Optional, Type
+from typing import Mapping, Optional, Type
 from osn_selenium.models import WindowRect
 from osn_selenium.flags.blink import BlinkFlagsManager
 from osn_selenium.flags.models.values import ArgumentValue
@@ -44,6 +44,8 @@ class UnifiedBlinkBaseMixin(UnifiedCoreBaseMixin):
 			page_load_timeout: int = 5,
 			script_timeout: int = 5,
 			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
 	):
 		UnifiedCoreBaseMixin.__init__(
 				self,
@@ -55,6 +57,8 @@ class UnifiedBlinkBaseMixin(UnifiedCoreBaseMixin):
 				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,
 		)
 		
 		if browser_exe is not None:

osn_selenium/webdrivers/unified/chrome/base.py

@@ -1,4 +1,4 @@
-from typing import Optional, Type
+from typing import Mapping, Optional, Type
 from osn_selenium.models import WindowRect
 from osn_selenium.flags.chrome import ChromeFlagsManager
 from osn_selenium.flags.models.chrome import ChromeFlags
@@ -32,6 +32,8 @@ class UnifiedChromeBaseMixin(UnifiedBlinkBaseMixin):
 			page_load_timeout: int = 5,
 			script_timeout: int = 5,
 			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
 	):
 		UnifiedBlinkBaseMixin.__init__(
 				self,
@@ -47,6 +49,8 @@ class UnifiedChromeBaseMixin(UnifiedBlinkBaseMixin):
 				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

osn_selenium/webdrivers/unified/core/base.py

@@ -1,15 +1,16 @@
+from osn_selenium._cdp_import import install_cdp_hook
 from osn_selenium.models import WindowRect
 from typing import (
 	Any,
 	Dict,
-	Optional,
+	Mapping, Optional,
 	Type
 )
 from osn_selenium.flags.base import BrowserFlagsManager
 from osn_selenium.flags.models.base import BrowserFlags
 from selenium.webdriver.common.bidi.session import Session
 from osn_selenium._typehints import (
-	ARCHITECTURES_TYPEHINT
+	ARCHITECTURES_TYPEHINT, PATH_TYPEHINT
 )
 from selenium.webdriver.remote.errorhandler import ErrorHandler
 from osn_selenium.webdrivers._decorators import requires_driver
@@ -37,6 +38,8 @@ class UnifiedCoreBaseMixin:
 			page_load_timeout: int = 5,
 			script_timeout: int = 5,
 			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
 	) -> None:
 		self._window_rect = window_rect
 		self._webdriver_path = webdriver_path
@@ -50,6 +53,10 @@ class UnifiedCoreBaseMixin:
 		
 		if flags is not None:
 			self._webdriver_flags_manager.update_flags(flags)
+
+		if not getattr(self, "cdp_hook_installed", False):
+			install_cdp_hook(cdp_paths=cdp_versioned_packages_paths, ignore_package_missing=ignore_cdp_version_package_missing)
+			setattr(self, "cdp_hook_installed", True)
 	
 	@property
 	def _architecture_impl(self) -> ARCHITECTURES_TYPEHINT:

osn_selenium/webdrivers/unified/edge/base.py

@@ -1,4 +1,4 @@
-from typing import Optional, Type
+from typing import Mapping, Optional, Type
 from osn_selenium.models import WindowRect
 from selenium.webdriver import Edge as legacyEdge
 from osn_selenium.flags.models.edge import EdgeFlags
@@ -30,6 +30,8 @@ class UnifiedEdgeBaseMixin(UnifiedBlinkBaseMixin):
 			page_load_timeout: int = 5,
 			script_timeout: int = 5,
 			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
 	):
 		UnifiedBlinkBaseMixin.__init__(
 				self,
@@ -45,6 +47,8 @@ class UnifiedEdgeBaseMixin(UnifiedBlinkBaseMixin):
 				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

osn_selenium/webdrivers/unified/yandex/base.py

@@ -1,4 +1,4 @@
-from typing import Optional, Type
+from typing import Mapping, Optional, Type
 from osn_selenium.models import WindowRect
 from osn_selenium.flags.models.yandex import YandexFlags
 from osn_selenium.flags.yandex import YandexFlagsManager
@@ -32,6 +32,8 @@ class UnifiedYandexBaseMixin(UnifiedChromeBaseMixin):
 			page_load_timeout: int = 5,
 			script_timeout: int = 5,
 			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
 	):
 		UnifiedChromeBaseMixin.__init__(
 				self,
@@ -47,6 +49,8 @@ class UnifiedYandexBaseMixin(UnifiedChromeBaseMixin):
 				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

{osn_selenium-1.0.0.dist-info → osn_selenium-1.1.0.dist-info}/METADATA

@@ -1,9 +1,11 @@
 Metadata-Version: 2.4
 Name: osn-selenium
-Version: 1.0.0
+Version: 1.1.0
 Summary: An advanced, asynchronous wrapper for Selenium designed for fine-grained browser control. It leverages `trio` for async operations, provides human-like action chains for more natural automation, and offers deep integration with the Chrome DevTools Protocol (CDP) for advanced features like network interception. The library is structured to be extensible, with built-in support for Blink-based browsers like Chrome, Edge, and Yandex.
-Author: oddshellnick
-Author-email: oddshellnick.programming@gmail.com
+Author-email: oddshellnick <oddshellnick.programming@gmail.com>
+Project-URL: Homepage, https://github.com/oddshellnick/osn-selenium
+Project-URL: Issues, https://github.com/oddshellnick/osn-selenium/issues
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: trio<1.0.0,>=0.32.0
 Requires-Dist: selenium<5.0.0,>=4.40.0
@@ -11,17 +13,13 @@ Requires-Dist: pydantic<3.0.0,>=2.0.0
 Requires-Dist: trio-websocket<1.0.0,>=0.12.0
 Requires-Dist: pywin32>=310; sys_platform == "win32"
 Requires-Dist: osn-system-utils<0.1.0,>=0.0.4
-Dynamic: author
-Dynamic: author-email
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: requires-dist
-Dynamic: summary
 
 # osn-selenium: Advanced Selenium Wrapper with Async Support and Fingerprinting Protection
 
 osn-selenium is a robust wrapper around Selenium WebDriver designed for automation of Blink-based browsers (Chrome, Edge, Yandex). It extends standard Selenium capabilities by providing native asynchronous support via Trio, deep integration with the Chrome DevTools Protocol (CDP), sophisticated browser fingerprint spoofing, and human-like user interaction simulation.
 
+For more detailed information, please visit the [wiki page](https://github.com/oddshellnick/osn-selenium/wiki).
+
 ## Technologies
 
 | Name       | Badge                                                                                                                                               | Description                                                                                                                                            |
@@ -67,12 +65,23 @@ osn-selenium is a robust wrapper around Selenium WebDriver designed for automati
         pip install osn-selenium
         ```
 
+        **With pip (beta versions):**
+        ```bash
+        pip install -i https://test.pypi.org/simple/ osn_system_utils
+        ```
+
     *   **With git:**
         ```bash
         pip install git+https://github.com/oddshellnick/osn-selenium.git
         ```
         *(Ensure you have git installed)*
 
+    *   **With git (beta versions):**
+        ```bash
+        pip install git+https://github.com/oddshellnick/osn-selenium.git@dev
+        ```
+        *(Ensure you have git installed)*
+
 2.  **Install the required Python packages using pip:**
 
     ```bash
@@ -224,6 +233,10 @@ Utilities for executing JS and managing browser fingerprints.
 
 ## Notes
 
+*   **CDP Versioning and External Packages:** 
+    This library supports a modular CDP (Chrome DevTools Protocol) architecture. Since standard Selenium distributions often deprecate or remove older protocol versions, we maintain a dedicated repository for all versions at [osn-selenium-cdp](https://github.com/oddshellnick/osn-selenium-cdp).
+    *   **Manual Installation:** You can install specific CDP support by targeting the corresponding branch (e.g., `pip install git+https://github.com/oddshellnick/osn-selenium-cdp.git@v131`).
+    *   **Structure Requirement:** If you choose to add or create CDP version packages manually, they **must strictly follow the directory structure** used in the `osn-selenium-cdp` repository. This ensures that the internal `MetaPathFinder` hook can correctly intercept and redirect imports from `selenium.webdriver.common.devtools`. Deviating from this structure will result in `CDPPackageError` or `ImportError`.
 *   **Concurrency Constraints in `trio_threads`:** 
     The `trio_threads` implementation is built using a unified `trio.Lock`. This means that every driver function and every associated instance (including `ActionChains`, `WebElement`, `Alert`, etc.) can execute only one operation at a time. Do not attempt to parallelize multiple operations (coroutines) within a single browser instance, as they will be queued sequentially. The primary purpose of this asynchronous implementation is to enable the simultaneous management of **multiple browser instances** within a single event loop, rather than concurrent interactions with one browser.
 *   **CDP Domains and Background Tasks:**