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

osn_selenium/executors/sync/cdp.py

@@ -0,0 +1,95 @@
+import importlib
+from typing import TYPE_CHECKING, Any, Dict, Callable
+
+from osn_selenium.abstract.executors.cdp import AbstractCDPExecutor
+from osn_selenium.exceptions.dependencies import CDPPackageError
+
+
+__all__ = ["CDPExecutor"]
+
+if TYPE_CHECKING:
+	from osn_selenium_cdp_v140.executors.sync import CDP140Executor
+	from osn_selenium_cdp_v141.executors.sync import CDP141Executor
+	from osn_selenium_cdp_v142.executors.sync import CDP142Executor
+	from osn_selenium_cdp_v143.executors.sync import CDP143Executor
+	from osn_selenium_cdp_v144.executors.sync import CDP144Executor
+
+
+class CDPExecutor(AbstractCDPExecutor):
+	"""
+	Global CDP executor router. 
+	Handles lazy loading and version-specific package validation.
+	"""
+
+	def __init__(self, execute_function: Callable[[str, Dict[str, Any]], Any]):
+		self._execute_function = execute_function
+
+	def get(self, version: int) -> Any:
+		"""
+		Dynamically loads and returns the CDP executor for a specific version.
+
+		Args:
+			version (int): The CDP version number.
+
+		Returns:
+			Any: The version-specific executor instance.
+
+		Raises:
+			CDPPackageError: If the version-specific package is not installed.
+		"""
+	
+		try:
+			if getattr(self, f"_v{version}", None) is None:
+				module = importlib.import_module(f"osn_selenium_cdp_v{version}.executors.sync")
+				executor_type = getattr(module, f"CDP{version}Executor")
+
+				setattr(self, f"_v{version}", executor_type(execute_function=self._execute_function))
+
+			return getattr(self, f"_v{version}", None)
+		except ImportError:
+			raise CDPPackageError(version=version)
+
+	@property
+	def v140(self) -> "CDP140Executor":
+		"""
+		Get or initialize the executor for CDP version 140.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=140)
+
+	@property
+	def v141(self) -> "CDP141Executor":
+		"""
+		Get or initialize the executor for CDP version 141.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=141)
+
+	@property
+	def v142(self) -> "CDP142Executor":
+		"""
+		Get or initialize the executor for CDP version 142.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=142)
+
+	@property
+	def v143(self) -> "CDP143Executor":
+		"""
+		Get or initialize the executor for CDP version 143.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=143)
+
+	@property
+	def v144(self) -> "CDP144Executor":
+		"""
+		Get or initialize the executor for CDP version 144.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=144)

osn_selenium/executors/trio_bidi/cdp.py

@@ -0,0 +1,101 @@
+import importlib
+from typing import TYPE_CHECKING, Any, Dict, Callable, Union
+
+import trio
+
+from osn_selenium.abstract.executors.cdp import AbstractCDPExecutor
+from osn_selenium.exceptions.dependencies import CDPPackageError
+
+
+__all__ = ["CDPExecutor"]
+
+if TYPE_CHECKING:
+	from osn_selenium_cdp_v140.executors.trio_bidi import CDP140Executor
+	from osn_selenium_cdp_v141.executors.trio_bidi import CDP141Executor
+	from osn_selenium_cdp_v142.executors.trio_bidi import CDP142Executor
+	from osn_selenium_cdp_v143.executors.trio_bidi import CDP143Executor
+	from osn_selenium_cdp_v144.executors.trio_bidi import CDP144Executor
+
+
+class CDPExecutor(AbstractCDPExecutor):
+	"""
+	Global CDP executor router. 
+	Handles lazy loading and version-specific package validation.
+	"""
+
+	def __init__(self, execute_function: Callable[[str, Dict[str, Any]], Any], lock: trio.Lock, limiter: trio.CapacityLimiter, token: trio.lowlevel.TrioToken, buffer_size: Union[int, float]):
+		self._execute_function = execute_function
+		self._lock = lock
+		self._limiter = limiter
+		self._trio_token = token
+		self._bidi_buffer_size = buffer_size
+
+	def get(self, version: int) -> Any:
+		"""
+		Dynamically loads and returns the CDP executor for a specific version.
+
+		Args:
+			version (int): The CDP version number.
+
+		Returns:
+			Any: The version-specific executor instance.
+
+		Raises:
+			CDPPackageError: If the version-specific package is not installed.
+		"""
+	
+		try:
+			if getattr(self, f"_v{version}", None) is None:
+				module = importlib.import_module(f"osn_selenium_cdp_v{version}.executors.trio_bidi")
+				executor_type = getattr(module, f"CDP{version}Executor")
+
+				setattr(self, f"_v{version}", executor_type(execute_function=self._execute_function, lock=self._lock, limiter=self._limiter, token=self._trio_token, buffer_size=self._bidi_buffer_size))
+
+			return getattr(self, f"_v{version}", None)
+		except ImportError:
+			raise CDPPackageError(version=version)
+
+	@property
+	def v140(self) -> "CDP140Executor":
+		"""
+		Get or initialize the executor for CDP version 140.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=140)
+
+	@property
+	def v141(self) -> "CDP141Executor":
+		"""
+		Get or initialize the executor for CDP version 141.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=141)
+
+	@property
+	def v142(self) -> "CDP142Executor":
+		"""
+		Get or initialize the executor for CDP version 142.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=142)
+
+	@property
+	def v143(self) -> "CDP143Executor":
+		"""
+		Get or initialize the executor for CDP version 143.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=143)
+
+	@property
+	def v144(self) -> "CDP144Executor":
+		"""
+		Get or initialize the executor for CDP version 144.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=144)

osn_selenium/executors/trio_bidi/javascript.py

@@ -0,0 +1,101 @@
+import trio
+from osn_selenium.javascript.models import JS_Scripts
+from osn_selenium.trio_bidi.mixin import TrioBiDiMixin
+from typing import (
+	Any,
+	Callable,
+	Dict,
+	Optional,
+	Union
+)
+from osn_selenium.javascript.fingerprint import FingerprintSettings
+from osn_selenium.instances.trio_threads.web_element import WebElement
+from osn_selenium.executors.unified.javascript import UnifiedJSExecutor
+from osn_selenium.models import (
+	Point,
+	Position,
+	Rectangle,
+	Size
+)
+from osn_selenium.abstract.executors.javascript import AbstractJSExecutor
+
+
+__all__ = ["JSExecutor"]
+
+
+class JSExecutor(UnifiedJSExecutor, TrioBiDiMixin, AbstractJSExecutor):
+	"""
+	An asynchronous JavaScript executor that integrates Trio's BiDi mixin.
+	"""
+	
+	def __init__(
+			self,
+			execute_function: Callable[[str, Any], Any],
+			lock: trio.Lock,
+			limiter: trio.CapacityLimiter,
+			trio_token: Optional[trio.lowlevel.TrioToken],
+			bidi_buffer_size: Union[int, float],
+	):
+		"""
+		Initialize the JSExecutor with Trio synchronization primitives and execution logic.
+
+		Args:
+			execute_function (Callable[[str, Any], Any]): The function used to run JavaScript code.
+			lock (trio.Lock): Trio lock for synchronizing access.
+			limiter (trio.CapacityLimiter): Trio limiter for controlling concurrency.
+			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.
+		"""
+		
+		UnifiedJSExecutor.__init__(self, execute_function=execute_function)
+		
+		TrioBiDiMixin.__init__(
+				self,
+				lock=lock,
+				limiter=limiter,
+				token=trio_token,
+				buffer_size=bidi_buffer_size
+		)
+	
+	async def check_element_in_viewport(self, element: WebElement) -> bool:
+		return await self.sync_to_trio(sync_function=self._check_element_in_viewport_impl)(element=element)
+	
+	async def execute(self, script: str, *args: Any) -> Any:
+		return await self.sync_to_trio(sync_function=self._execute_impl)(script, *args)
+	
+	async def get_document_scroll_size(self) -> Size:
+		return await self.sync_to_trio(sync_function=self._get_document_scroll_size_impl)()
+	
+	async def get_element_css_style(self, element: WebElement) -> Dict[str, str]:
+		return await self.sync_to_trio(sync_function=self._get_element_css_style_impl)(element=element)
+	
+	async def get_element_rect_in_viewport(self, element: WebElement) -> Optional[Rectangle]:
+		return await self.sync_to_trio(sync_function=self._get_element_rect_in_viewport_impl)(element=element)
+	
+	async def get_random_element_point(self, element: WebElement) -> Optional[Point]:
+		return await self.sync_to_trio(sync_function=self._get_random_element_point_impl)(element=element)
+	
+	async def get_random_element_point_in_viewport(self, element: WebElement, step: int = 1) -> Optional[Position]:
+		return await self.sync_to_trio(sync_function=self._get_random_element_point_in_viewport_impl)(element=element, step=step)
+	
+	async def get_viewport_position(self) -> Position:
+		return await self.sync_to_trio(sync_function=self._get_viewport_position_impl)()
+	
+	async def get_viewport_rect(self) -> Rectangle:
+		return await self.sync_to_trio(sync_function=self._get_viewport_rect_impl)()
+	
+	async def get_viewport_size(self) -> Size:
+		return await self.sync_to_trio(sync_function=self._get_viewport_size_impl)()
+	
+	async def open_new_tab(self, link: str = "") -> None:
+		await self.sync_to_trio(sync_function=self._open_new_tab_impl)(link=link)
+	
+	@property
+	def scripts(self) -> JS_Scripts:
+		return self._scripts_impl
+	
+	async def start_fingerprint_detection(self, fingerprint_settings: FingerprintSettings) -> None:
+		await self.sync_to_trio(sync_function=self._start_fingerprint_detection_impl)(fingerprint_settings=fingerprint_settings)
+	
+	async def stop_window_loading(self) -> None:
+		await self.sync_to_trio(sync_function=self._stop_window_loading_impl)()

osn_selenium/executors/trio_threads/cdp.py

@@ -0,0 +1,99 @@
+import importlib
+from typing import TYPE_CHECKING, Any, Dict, Callable
+
+import trio
+
+from osn_selenium.abstract.executors.cdp import AbstractCDPExecutor
+from osn_selenium.exceptions.dependencies import CDPPackageError
+
+
+__all__ = ["CDPExecutor"]
+
+if TYPE_CHECKING:
+	from osn_selenium_cdp_v140.executors.trio_threads import CDP140Executor
+	from osn_selenium_cdp_v141.executors.trio_threads import CDP141Executor
+	from osn_selenium_cdp_v142.executors.trio_threads import CDP142Executor
+	from osn_selenium_cdp_v143.executors.trio_threads import CDP143Executor
+	from osn_selenium_cdp_v144.executors.trio_threads import CDP144Executor
+
+
+class CDPExecutor(AbstractCDPExecutor):
+	"""
+	Global CDP executor router. 
+	Handles lazy loading and version-specific package validation.
+	"""
+
+	def __init__(self, execute_function: Callable[[str, Dict[str, Any]], Any], lock: trio.Lock, limiter: trio.CapacityLimiter):
+		self._execute_function = execute_function
+		self._lock = lock
+		self._limiter = limiter
+
+	def get(self, version: int) -> Any:
+		"""
+		Dynamically loads and returns the CDP executor for a specific version.
+
+		Args:
+			version (int): The CDP version number.
+
+		Returns:
+			Any: The version-specific executor instance.
+
+		Raises:
+			CDPPackageError: If the version-specific package is not installed.
+		"""
+	
+		try:
+			if getattr(self, f"_v{version}", None) is None:
+				module = importlib.import_module(f"osn_selenium_cdp_v{version}.executors.trio_threads")
+				executor_type = getattr(module, f"CDP{version}Executor")
+
+				setattr(self, f"_v{version}", executor_type(execute_function=self._execute_function, lock=self._lock, limiter=self._limiter))
+
+			return getattr(self, f"_v{version}", None)
+		except ImportError:
+			raise CDPPackageError(version=version)
+
+	@property
+	def v140(self) -> "CDP140Executor":
+		"""
+		Get or initialize the executor for CDP version 140.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=140)
+
+	@property
+	def v141(self) -> "CDP141Executor":
+		"""
+		Get or initialize the executor for CDP version 141.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=141)
+
+	@property
+	def v142(self) -> "CDP142Executor":
+		"""
+		Get or initialize the executor for CDP version 142.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=142)
+
+	@property
+	def v143(self) -> "CDP143Executor":
+		"""
+		Get or initialize the executor for CDP version 143.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=143)
+
+	@property
+	def v144(self) -> "CDP144Executor":
+		"""
+		Get or initialize the executor for CDP version 144.
+		Raises CDPPackageError if the version-specific package is not installed.
+		"""
+
+		return self.get(version=144)

osn_selenium/executors/trio_threads/javascript.py

@@ -1,5 +1,5 @@
 import trio
-from osn_selenium.base_mixin import TrioThreadMixin
+from osn_selenium.trio_threads_mixin import TrioThreadMixin
 from osn_selenium.javascript.models import JS_Scripts
 from typing import (
 	Any,

osn_selenium/executors/unified/javascript.py

@@ -21,10 +21,6 @@ __all__ = ["UnifiedJSExecutor"]
 class UnifiedJSExecutor:
 	"""
 	A unified executor for JavaScript scripts within the Selenium environment.
-
-	Attributes:
-		_execute_function (Callable[[str, Any], Any]): The internal function used to execute JS code.
-		_scripts (JS_Scripts): A collection of pre-defined JavaScript scripts.
 	"""
 	
 	def __init__(self, execute_function: Callable[[str, Any], Any]):

osn_selenium/flags/base.py

@@ -1,5 +1,5 @@
 from copy import deepcopy
-from osn_selenium.models import DictModel
+from osn_selenium._base_models import DictModel
 from typing import (
 	Any,
 	Dict,
@@ -47,14 +47,6 @@ class BrowserFlagsManager:
 
 	This class provides a structured way to define, set, and build browser options
 	for various Selenium WebDriver instances.
-
-	Attributes:
-		_flags_types (Dict[str, FlagType]): A dictionary mapping flag types to their handler functions.
-		_flags_definitions (Dict[str, FlagDefinition]): A dictionary of all available flag definitions.
-		_flags_definitions_by_types (Dict[str, Dict[str, FlagDefinition]]): Flags definitions grouped by type.
-		_arguments (Dict[str, ArgumentValue]): Stores the configured command-line arguments.
-		_experimental_options (Dict[str, ExperimentalOptionValue]): Stores the configured experimental options.
-		_attributes (Dict[str, AttributeValue]): Stores the configured WebDriver attributes.
 	"""
 	
 	def __init__(
@@ -159,7 +151,7 @@ class BrowserFlagsManager:
 	def clear_attributes(self):
 		"""Clears all configured browser attributes."""
 		
-		self._attributes = {}
+		self._attributes.clear()
 	
 	def remove_attribute(self, attribute_name: str):
 		"""
@@ -244,7 +236,7 @@ class BrowserFlagsManager:
 	def clear_experimental_options(self):
 		"""Clears all configured experimental options."""
 		
-		self._experimental_options = {}
+		self._experimental_options.clear()
 	
 	def remove_experimental_option(self, experimental_option_name: str):
 		"""
@@ -346,7 +338,7 @@ class BrowserFlagsManager:
 	def clear_arguments(self):
 		"""Clears all configured browser arguments."""
 		
-		self._arguments = {}
+		self._arguments.clear()
 	
 	def remove_argument(self, argument_name: str):
 		"""
@@ -471,7 +463,9 @@ class BrowserFlagsManager:
 		
 		for type_name, type_functions in self._flags_types.items():
 			options = type_functions.build_options_function(options)
-		
+
+		options.set_capability("webSocketUrl", True)
+
 		return options
 	
 	def remove_option(self, option: FlagDefinition):

osn_selenium/flags/blink.py

@@ -44,12 +44,6 @@ class BlinkFlagsManager(BrowserFlagsManager):
 	This class extends `BrowserFlagsManager` to handle Blink-specific features,
 	such as `--enable-blink-features` and `--disable-blink-features`, and provides
 	a comprehensive set of predefined flags for these browsers.
-
-	Attributes:
-		_browser_exe (Optional[PATH_TYPEHINT]): Path to the browser executable.
-		_start_page_url (Optional[str]): The URL to open when the browser starts.
-		_enable_blink_features (Dict[str, str]): Stores enabled Blink feature commands.
-		_disable_blink_features (Dict[str, str]): Stores disabled Blink feature commands.
 	"""
 	
 	def __init__(
@@ -776,8 +770,8 @@ class BlinkFlagsManager(BrowserFlagsManager):
 	def clear_blink_features(self):
 		"""Clears all configured Blink features."""
 		
-		self._enable_blink_features = {}
-		self._disable_blink_features = {}
+		self._enable_blink_features.clear()
+		self._disable_blink_features.clear()
 	
 	def remove_blink_feature(self, blink_feature_name: str):
 		"""

osn_selenium/flags/chrome.py

@@ -42,21 +42,21 @@ class ChromeFlagsManager(BlinkFlagsManager):
 		debugging port, user agent, proxy, and BiDi protocol.
 		"""
 		
-		yandex_flags_types = {}
+		chrome_flags_types = {}
 		
 		if flags_types is not None:
-			yandex_flags_types.update(flags_types)
+			chrome_flags_types.update(flags_types)
 		
-		yandex_flags_definitions = {}
+		chrome_flags_definitions = {}
 		
 		if flags_definitions is not None:
-			yandex_flags_definitions.update(flags_definitions)
+			chrome_flags_definitions.update(flags_definitions)
 		
 		super().__init__(
 				browser_exe=browser_exe,
 				start_page_url=start_page_url,
-				flags_types=yandex_flags_types,
-				flags_definitions=yandex_flags_definitions,
+				flags_types=chrome_flags_types,
+				flags_definitions=chrome_flags_definitions,
 		)
 	
 	def _build_options_arguments(self, options: Options) -> Options:

osn_selenium/flags/edge.py

@@ -42,21 +42,21 @@ class EdgeFlagsManager(BlinkFlagsManager):
 		debugging port, user agent, proxy, and BiDi protocol.
 		"""
 		
-		yandex_flags_types = {}
+		edge_flags_types = {}
 		
 		if flags_types is not None:
-			yandex_flags_types.update(flags_types)
+			edge_flags_types.update(flags_types)
 		
-		yandex_flags_definitions = {}
+		edge_flags_definitions = {}
 		
 		if flags_definitions is not None:
-			yandex_flags_definitions.update(flags_definitions)
+			edge_flags_definitions.update(flags_definitions)
 		
 		super().__init__(
 				browser_exe=browser_exe,
 				start_page_url=start_page_url,
-				flags_types=yandex_flags_types,
-				flags_definitions=yandex_flags_definitions,
+				flags_types=edge_flags_types,
+				flags_definitions=edge_flags_definitions,
 		)
 	
 	def _build_options_arguments(self, options: Options) -> Options:

osn_selenium/flags/models/base.py

@@ -1,8 +1,4 @@
 from pydantic import Field
-from osn_selenium.models import (
-	DictModel,
-	ExtraDictModel
-)
 from typing import (
 	Any,
 	Callable,
@@ -10,6 +6,10 @@ from typing import (
 	Literal,
 	Optional
 )
+from osn_selenium._base_models import (
+	DictModel,
+	ExtraDictModel
+)
 from osn_selenium.flags._typehints import (
 	ANY_WEBDRIVER_OPTION_TYPEHINT
 )

osn_selenium/flags/models/blink.py

@@ -1,7 +1,7 @@
 from pydantic import Field
 from typing import Optional
-from osn_selenium.models import ExtraDictModel
 from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium._base_models import ExtraDictModel
 from osn_selenium.flags._typehints import (
 	AUTOPLAY_POLICY_TYPEHINT,
 	LOG_LEVEL_TYPEHINT,

osn_selenium/flags/models/values.py

@@ -1,5 +1,5 @@
 from typing import Any
-from osn_selenium.models import DictModel
+from osn_selenium._base_models import DictModel
 
 
 __all__ = ["ArgumentValue", "AttributeValue", "ExperimentalOptionValue"]

osn_selenium/instances/convert.py

@@ -52,13 +52,14 @@ from selenium.webdriver.common.bidi.permissions import (
 from selenium.webdriver.common.bidi.webextension import (
 	WebExtension as legacyWebExtension
 )
+from selenium.webdriver.common.bidi.browsing_context import (
+	BrowsingContext as legacyBrowsingContext
+)
 from osn_selenium.instances.protocols import (
 	SyncInstanceWrapper,
+	TrioBiDiInstanceWrapper,
 	TrioThreadInstanceWrapper
 )
-from selenium.webdriver.common.bidi.browsing_context import (
-	BrowsingContext as legacyBrowsingContext
-)
 from osn_selenium.instances._typehints import (
 	ACTION_CHAINS_TYPEHINT,
 	ALERT_TYPEHINT,
@@ -85,11 +86,13 @@ __all__ = [
 	"get_legacy_frame_reference",
 	"get_legacy_instance",
 	"get_sync_instance_wrapper",
+	"get_trio_bidi_instance_wrapper",
 	"get_trio_thread_instance_wrapper"
 ]
 
 _SYNC_WRAPPER_TYPE = TypeVar("_SYNC_WRAPPER_TYPE", bound=SyncInstanceWrapper)
 _TRIO_THREAD_WRAPPER_TYPE = TypeVar("_TRIO_THREAD_WRAPPER_TYPE", bound=TrioThreadInstanceWrapper)
+_TRIO_BIDI_WRAPPER_TYPE = TypeVar("_TRIO_BIDI_WRAPPER_TYPE", bound=TrioBiDiInstanceWrapper)
 
 
 @overload
@@ -243,6 +246,44 @@ def get_trio_thread_instance_wrapper(
 	return wrapper_class.from_legacy(legacy_object=legacy_object, lock=lock, limiter=limiter)
 
 
+def get_trio_bidi_instance_wrapper(
+		wrapper_class: Type[_TRIO_BIDI_WRAPPER_TYPE],
+		legacy_object: Any,
+		lock: trio.Lock,
+		limiter: trio.CapacityLimiter,
+		trio_token: Optional[trio.lowlevel.TrioToken],
+		bidi_buffer_size: Union[int, float],
+) -> _TRIO_BIDI_WRAPPER_TYPE:
+	"""
+	Creates a Trio-compatible BiDi instance wrapper for a legacy Selenium object.
+
+	Args:
+		wrapper_class (Type[_TRIO_BIDI_WRAPPER_TYPE]): The class used to wrap the legacy object.
+		legacy_object (Any): The legacy Selenium object to be wrapped.
+		lock (trio.Lock): The lock for Trio synchronization.
+		limiter (trio.CapacityLimiter): The capacity limiter for Trio.
+		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.
+
+	Returns:
+		_TRIO_BIDI_WRAPPER_TYPE: An instance of the wrapper class.
+
+	Raises:
+		TypeIsNotWrapper: If the provided wrapper_class does not implement TrioBiDiInstanceWrapper.
+	"""
+	
+	if not isinstance(wrapper_class, TrioBiDiInstanceWrapper):
+		raise ProtocolComplianceError(instance=wrapper_class, expected_protocols=TrioBiDiInstanceWrapper)
+	
+	return wrapper_class.from_legacy(
+			legacy_object=legacy_object,
+			lock=lock,
+			limiter=limiter,
+			trio_token=trio_token,
+			bidi_buffer_size=bidi_buffer_size
+	)
+
+
 def get_sync_instance_wrapper(wrapper_class: Type[_SYNC_WRAPPER_TYPE], legacy_object: Any) -> _SYNC_WRAPPER_TYPE:
 	"""
 	Creates a synchronous instance wrapper for a legacy Selenium object.