Initial commit

This commit is contained in:
Alex committed 2026-11-02 22:54:14 +08:00
commit 57fc3525eb
7311 files changed
+1291398

No files matched your search

+153
View File
@@ -0,0 +1,153 @@
"""R2-1:内存假驱动——不需要浏览器,供单测替代真实标签页。
支持的定位器(经 ``to_locator`` 规范化后):``css:tag``、``css:#id``、``css:.class``、
``css:tag#id.class[attr="v"]`` 这类单个复合选择器(不支持后代、逗号分组、伪类),
以及 ``tag:名称``、``@属性=值``。其他写法抛 ScriptError,行为与真实浏览器遇到非法选择器一致。
"""
from __future__ import annotations
import re
from typing import Any, Callable, Dict, List, Optional
from app.core.driver.errors import DriverError, ScriptError
from app.core.driver.locators import split_locator
_COMPOUND = re.compile(r"^(?P<tag>[a-zA-Z][\w-]*)?(?P<rest>(?:#[\w-]+|\.[\w-]+|\[[^\]]+\])*)$")
_ATTR = re.compile(r"""\[\s*([\w-]+)\s*(?:=\s*["']?([^"'\]]*)["']?)?\s*\]""")
class FakeElement:
def __init__(self, tag: str, text: str = "", **attrs: Any):
self.tag = tag.lower()
self.text = text
# class_ 之类规避 Python 关键字的写法:先去掉末尾下划线,再把下划线换成连字符(data_test -> data-test)
self.attrs = {k.rstrip("_").replace("_", "-"): str(v) for k, v in attrs.items()}
self.clicks = 0
self.inputs: List[str] = []
def attr(self, name: str) -> Optional[str]:
return self.attrs.get(name)
def click(self, *, by_js: bool = False) -> None:
self.clicks += 1
def input(self, text: str, *, clear: bool = False) -> None:
if clear:
self.inputs.clear()
self.inputs.append(text)
def run_js(self, script: str, *args: Any) -> Any:
return None
def matches(self, locator: str) -> bool:
kind, expr = split_locator(locator)
if kind == "tag":
return self.tag == expr.strip().lower()
if kind == "attr":
name, _, value = expr.partition("=")
return self.attrs.get(name.strip()) == value.strip() if value else name.strip() in self.attrs
if kind != "css":
raise ScriptError(f"FakeTabDriver 不支持的定位器: {locator}")
match = _COMPOUND.match(expr.strip())
if not match or not expr.strip():
raise ScriptError(f"FakeTabDriver 不支持的 CSS 选择器: {expr}")
if match.group("tag") and match.group("tag").lower() != self.tag:
return False
rest = match.group("rest")
for element_id in re.findall(r"#([\w-]+)", rest):
if self.attrs.get("id") != element_id:
return False
classes = set((self.attrs.get("class") or "").split())
if not set(re.findall(r"\.([\w-]+)", rest)) <= classes:
return False
for name, value in _ATTR.findall(rest):
if name not in self.attrs or (value and self.attrs[name] != value):
return False
return True
class FakeTabDriver:
def __init__(
self,
elements: Optional[List[FakeElement]] = None,
*,
url: str = "about:blank",
title: str = "",
tab_id: str = "fake-tab",
js: Optional[Callable[[str, tuple], Any]] = None,
cdp: Optional[Callable[[str, Dict[str, Any]], Any]] = None,
):
self.elements = list(elements or [])
self._url = url
self._title = title
self._tab_id = tab_id
self._js = js
self._cdp = cdp
self.js_calls: List[tuple] = []
self.cdp_calls: List[tuple] = []
self.navigations: List[str] = []
self.reloads = 0
self.inserted_text: List[str] = []
self._next_error: Optional[DriverError] = None
# 让下一次调用抛出指定的驱动异常,用于测试错误处理路径
def fail_next(self, error: DriverError) -> None:
self._next_error = error
def _maybe_fail(self) -> None:
if self._next_error is not None:
error, self._next_error = self._next_error, None
raise error
@property
def raw(self) -> Any:
return self
@property
def tab_id(self) -> str:
return self._tab_id
@property
def url(self) -> str:
return self._url
@property
def title(self) -> str:
return self._title
def run_js(self, script: str, *args: Any, timeout: Optional[float] = None, as_expr: bool = False) -> Any:
self._maybe_fail()
self.js_calls.append((script, args))
return self._js(script, args) if self._js else None
def run_cdp(self, method: str, **params: Any) -> Any:
self._maybe_fail()
self.cdp_calls.append((method, params))
return self._cdp(method, params) if self._cdp else {}
def find(self, locator: str, timeout: Optional[float] = None) -> Optional[FakeElement]:
matches = self.find_all(locator, timeout)
return matches[0] if matches else None
def find_all(self, locator: str, timeout: Optional[float] = None) -> List[FakeElement]:
self._maybe_fail()
return [element for element in self.elements if element.matches(locator)]
def navigate(self, url: str, timeout: Optional[float] = None) -> bool:
self._maybe_fail()
self.navigations.append(url)
self._url = url
return True
def reload(self, ignore_cache: bool = False) -> None:
self._maybe_fail()
self.reloads += 1
def screenshot(self, full_page: bool = False) -> bytes:
self._maybe_fail()
return b"\x89PNG\r\n\x1a\nFAKE"
def insert_text(self, text: str) -> None:
self._maybe_fail()
self.inserted_text.append(str(text))