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

osn_selenium/_functions.py

@@ -0,0 +1,84 @@
+import pathlib
+from types import UnionType
+from osn_selenium.exceptions.path import PathValidationError
+from typing import (
+	Iterable,
+	Optional,
+	Set,
+	Union,
+	get_args,
+	get_origin
+)
+from osn_selenium._typehints import (
+	PATH_TYPEHINT,
+	TYPES_FOR_FLATTENING_TYPEHINT
+)
+
+
+__all__ = ["flatten_types", "validate_path"]
+
+
+def validate_path(path: Optional[PATH_TYPEHINT]) -> Optional[pathlib.Path]:
+	"""
+	Validates the provided path and converts it to a pathlib.Path object.
+
+	Args:
+		path (Optional[PATH_TYPEHINT]): The path to be validated and converted.
+
+	Returns:
+		Optional[pathlib.Path]: A Path object if valid, or None if the input was None.
+
+	Raises:
+		PathValidationError: If the path conversion fails due to an exception.
+	"""
+	
+	try:
+		if path is None:
+			return None
+	
+		return pathlib.Path(path)
+	except (Exception,) as exception:
+		raise PathValidationError(path=path, exception=exception)
+
+
+def flatten_types(
+		types_: Union[TYPES_FOR_FLATTENING_TYPEHINT, Iterable[TYPES_FOR_FLATTENING_TYPEHINT]]
+) -> Set[str]:
+	"""
+	Recursively extracts type names from a type, a union of types, or a collection of types.
+
+	Args:
+		types_ (Union[Type, Iterable[Type]]): The type definition or collection of types to flatten.
+
+	Returns:
+		Set[str]: A set of strings representing the names of the types found.
+	"""
+	
+	types_of_level = set()
+	
+	if isinstance(types_, Iterable) and not isinstance(types_, str):
+		for t in types_:
+			types_of_level.update(flatten_types(t))
+	
+		return types_of_level
+	
+	if isinstance(types_, str):
+		types_of_level.add(types_)
+	
+	origin = get_origin(types_)
+	args = get_args(types_)
+	
+	is_union = origin is Union or isinstance(types_, UnionType)
+	
+	if is_union:
+		for arg in args:
+			types_of_level.update(flatten_types(arg))
+	else:
+		if types_ is None or types_ is type(None):
+			types_of_level.add("NoneType")
+		elif hasattr(types_, "__name__"):
+			types_of_level.add(types_.__name__)
+		else:
+			types_of_level.add(str(types_))
+	
+	return types_of_level

osn_selenium/_typehints.py

@@ -0,0 +1,19 @@
+import os
+import pathlib
+from typing import Literal, Type, Union
+from selenium.webdriver.common.actions.key_input import KeyInput
+from selenium.webdriver.common.actions.wheel_input import WheelInput
+from selenium.webdriver.common.actions.pointer_input import PointerInput
+
+
+__all__ = [
+	"ARCHITECTURES_TYPEHINT",
+	"DEVICES_TYPEHINT",
+	"PATH_TYPEHINT",
+	"TYPES_FOR_FLATTENING_TYPEHINT"
+]
+
+DEVICES_TYPEHINT = Union[PointerInput, KeyInput, WheelInput]
+ARCHITECTURES_TYPEHINT = Literal["sync", "trio_threads"]
+PATH_TYPEHINT = Union[str, bytes, pathlib.Path, os.PathLike]
+TYPES_FOR_FLATTENING_TYPEHINT = Union[str, Type]

osn_selenium/abstract/executors/cdp/__init__.py

@@ -0,0 +1,435 @@
+from typing import Any, Dict
+from abc import ABC, abstractmethod
+from osn_selenium.abstract.executors.cdp.io import (
+	AbstractIoCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.css import (
+	AbstractCssCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.dom import (
+	AbstractDomCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.log import (
+	AbstractLogCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.pwa import (
+	AbstractPwaCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.cast import (
+	AbstractCastCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.page import (
+	AbstractPageCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.fetch import (
+	AbstractFetchCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.input import (
+	AbstractInputCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.media import (
+	AbstractMediaCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.fed_cm import (
+	AbstractFedCmCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.audits import (
+	AbstractAuditsCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.memory import (
+	AbstractMemoryCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.schema import (
+	AbstractSchemaCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.target import (
+	AbstractTargetCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.browser import (
+	AbstractBrowserCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.console import (
+	AbstractConsoleCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.network import (
+	AbstractNetworkCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.overlay import (
+	AbstractOverlayCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.preload import (
+	AbstractPreloadCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.runtime import (
+	AbstractRuntimeCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.storage import (
+	AbstractStorageCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.tracing import (
+	AbstractTracingCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.autofill import (
+	AbstractAutofillCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.debugger import (
+	AbstractDebuggerCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.profiler import (
+	AbstractProfilerCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.security import (
+	AbstractSecurityCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.web_audio import (
+	AbstractWebAudioCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.web_authn import (
+	AbstractWebAuthnCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.animation import (
+	AbstractAnimationCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.emulation import (
+	AbstractEmulationCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.inspector import (
+	AbstractInspectorCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.tethering import (
+	AbstractTetheringCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.indexed_db import (
+	AbstractIndexedDbCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.layer_tree import (
+	AbstractLayerTreeCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.extensions import (
+	AbstractExtensionsCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.dom_storage import (
+	AbstractDomStorageCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.file_system import (
+	AbstractFileSystemCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.system_info import (
+	AbstractSystemInfoCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.performance import (
+	AbstractPerformanceCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.dom_debugger import (
+	AbstractDomDebuggerCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.dom_snapshot import (
+	AbstractDomSnapshotCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.cache_storage import (
+	AbstractCacheStorageCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.device_access import (
+	AbstractDeviceAccessCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.heap_profiler import (
+	AbstractHeapProfilerCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.accessibility import (
+	AbstractAccessibilityCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.service_worker import (
+	AbstractServiceWorkerCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.event_breakpoints import (
+	AbstractEventBreakpointsCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.background_service import (
+	AbstractBackgroundServiceCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.device_orientation import (
+	AbstractDeviceOrientationCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.bluetooth_emulation import (
+	AbstractBluetoothEmulationCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.performance_timeline import (
+	AbstractPerformanceTimelineCDPExecutor
+)
+from osn_selenium.abstract.executors.cdp.headless_experimental import (
+	AbstractHeadlessExperimentalCDPExecutor
+)
+
+
+__all__ = ["AbstractCDPExecutor"]
+
+
+class AbstractCDPExecutor(ABC):
+	@property
+	@abstractmethod
+	def accessibility(self) -> AbstractAccessibilityCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def animation(self) -> AbstractAnimationCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def audits(self) -> AbstractAuditsCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def autofill(self) -> AbstractAutofillCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def background_service(self) -> AbstractBackgroundServiceCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def bluetooth_emulation(self) -> AbstractBluetoothEmulationCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def browser(self) -> AbstractBrowserCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def cache_storage(self) -> AbstractCacheStorageCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def cast(self) -> AbstractCastCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def console(self) -> AbstractConsoleCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def css(self) -> AbstractCssCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def debugger(self) -> AbstractDebuggerCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def device_access(self) -> AbstractDeviceAccessCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def device_orientation(self) -> AbstractDeviceOrientationCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def dom(self) -> AbstractDomCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def dom_debugger(self) -> AbstractDomDebuggerCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def dom_snapshot(self) -> AbstractDomSnapshotCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def dom_storage(self) -> AbstractDomStorageCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def emulation(self) -> AbstractEmulationCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def event_breakpoints(self) -> AbstractEventBreakpointsCDPExecutor:
+		...
+	
+	@abstractmethod
+	def execute(self, cmd: str, cmd_args: Dict[str, Any]) -> Any:
+		...
+	
+	@property
+	@abstractmethod
+	def extensions(self) -> AbstractExtensionsCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def fed_cm(self) -> AbstractFedCmCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def fetch(self) -> AbstractFetchCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def file_system(self) -> AbstractFileSystemCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def headless_experimental(self) -> AbstractHeadlessExperimentalCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def heap_profiler(self) -> AbstractHeapProfilerCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def indexed_db(self) -> AbstractIndexedDbCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def input(self) -> AbstractInputCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def inspector(self) -> AbstractInspectorCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def io(self) -> AbstractIoCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def layer_tree(self) -> AbstractLayerTreeCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def log(self) -> AbstractLogCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def media(self) -> AbstractMediaCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def memory(self) -> AbstractMemoryCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def network(self) -> AbstractNetworkCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def overlay(self) -> AbstractOverlayCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def page(self) -> AbstractPageCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def performance(self) -> AbstractPerformanceCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def performance_timeline(self) -> AbstractPerformanceTimelineCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def preload(self) -> AbstractPreloadCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def profiler(self) -> AbstractProfilerCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def pwa(self) -> AbstractPwaCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def runtime(self) -> AbstractRuntimeCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def schema(self) -> AbstractSchemaCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def security(self) -> AbstractSecurityCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def service_worker(self) -> AbstractServiceWorkerCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def storage(self) -> AbstractStorageCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def system_info(self) -> AbstractSystemInfoCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def target(self) -> AbstractTargetCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def tethering(self) -> AbstractTetheringCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def tracing(self) -> AbstractTracingCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def web_audio(self) -> AbstractWebAudioCDPExecutor:
+		...
+	
+	@property
+	@abstractmethod
+	def web_authn(self) -> AbstractWebAuthnCDPExecutor:
+		...

osn_selenium/abstract/executors/cdp/accessibility.py

@@ -0,0 +1,62 @@
+from abc import ABC, abstractmethod
+from typing import (
+	Any,
+	Dict,
+	List,
+	Optional
+)
+
+
+__all__ = ["AbstractAccessibilityCDPExecutor"]
+
+
+class AbstractAccessibilityCDPExecutor(ABC):
+	@abstractmethod
+	def disable(self) -> None:
+		...
+	
+	@abstractmethod
+	def enable(self) -> None:
+		...
+	
+	@abstractmethod
+	def get_ax_node_and_ancestors(
+			self,
+			node_id: Optional[int] = None,
+			backend_node_id: Optional[int] = None,
+			object_id: Optional[str] = None
+	) -> List[Dict[str, Any]]:
+		...
+	
+	@abstractmethod
+	def get_child_ax_nodes(self, id_: str, frame_id: Optional[str] = None) -> List[Dict[str, Any]]:
+		...
+	
+	@abstractmethod
+	def get_full_ax_tree(self, depth: Optional[int] = None, frame_id: Optional[str] = None) -> List[Dict[str, Any]]:
+		...
+	
+	@abstractmethod
+	def get_partial_ax_tree(
+			self,
+			node_id: Optional[int] = None,
+			backend_node_id: Optional[int] = None,
+			object_id: Optional[str] = None,
+			fetch_relatives: Optional[bool] = None
+	) -> List[Dict[str, Any]]:
+		...
+	
+	@abstractmethod
+	def get_root_ax_node(self, frame_id: Optional[str] = None) -> Dict[str, Any]:
+		...
+	
+	@abstractmethod
+	def query_ax_tree(
+			self,
+			node_id: Optional[int] = None,
+			backend_node_id: Optional[int] = None,
+			object_id: Optional[str] = None,
+			accessible_name: Optional[str] = None,
+			role: Optional[str] = None
+	) -> List[Dict[str, Any]]:
+		...

osn_selenium/abstract/executors/cdp/animation.py

@@ -0,0 +1,47 @@
+from typing import Any, Dict, List
+from abc import ABC, abstractmethod
+
+
+__all__ = ["AbstractAnimationCDPExecutor"]
+
+
+class AbstractAnimationCDPExecutor(ABC):
+	@abstractmethod
+	def disable(self) -> None:
+		...
+	
+	@abstractmethod
+	def enable(self) -> None:
+		...
+	
+	@abstractmethod
+	def get_current_time(self, id_: str) -> float:
+		...
+	
+	@abstractmethod
+	def get_playback_rate(self) -> float:
+		...
+	
+	@abstractmethod
+	def release_animations(self, animations: List[str]) -> None:
+		...
+	
+	@abstractmethod
+	def resolve_animation(self, animation_id: str) -> Dict[str, Any]:
+		...
+	
+	@abstractmethod
+	def seek_animations(self, animations: List[str], current_time: float) -> None:
+		...
+	
+	@abstractmethod
+	def set_paused(self, animations: List[str], paused: bool) -> None:
+		...
+	
+	@abstractmethod
+	def set_playback_rate(self, playback_rate: float) -> None:
+		...
+	
+	@abstractmethod
+	def set_timing(self, animation_id: str, duration: float, delay: float) -> None:
+		...

osn_selenium/abstract/executors/cdp/audits.py

@@ -0,0 +1,39 @@
+from abc import ABC, abstractmethod
+from typing import (
+	Any,
+	Dict,
+	List,
+	Optional,
+	Tuple
+)
+
+
+__all__ = ["AbstractAuditsCDPExecutor"]
+
+
+class AbstractAuditsCDPExecutor(ABC):
+	@abstractmethod
+	def check_contrast(self, report_aaa: Optional[bool] = None) -> None:
+		...
+	
+	@abstractmethod
+	def check_forms_issues(self) -> List[Dict[str, Any]]:
+		...
+	
+	@abstractmethod
+	def disable(self) -> None:
+		...
+	
+	@abstractmethod
+	def enable(self) -> None:
+		...
+	
+	@abstractmethod
+	def get_encoded_response(
+			self,
+			request_id: str,
+			encoding: str,
+			quality: Optional[float] = None,
+			size_only: Optional[bool] = None
+	) -> Tuple[Optional[str], int, int]:
+		...

osn_selenium/abstract/executors/cdp/autofill.py

@@ -0,0 +1,34 @@
+from abc import ABC, abstractmethod
+from typing import (
+	Any,
+	Dict,
+	List,
+	Optional
+)
+
+
+__all__ = ["AbstractAutofillCDPExecutor"]
+
+
+class AbstractAutofillCDPExecutor(ABC):
+	@abstractmethod
+	def disable(self) -> None:
+		...
+	
+	@abstractmethod
+	def enable(self) -> None:
+		...
+	
+	@abstractmethod
+	def set_addresses(self, addresses: List[Dict[str, Any]]) -> None:
+		...
+	
+	@abstractmethod
+	def trigger(
+			self,
+			field_id: int,
+			frame_id: Optional[str] = None,
+			card: Optional[Dict[str, Any]] = None,
+			address: Optional[Dict[str, Any]] = None
+	) -> None:
+		...