mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
241 lines
7.3 KiB
Python
241 lines
7.3 KiB
Python
# -*- coding:utf-8 -*-
|
|
"""
|
|
@Author : g1879
|
|
@Contact : g1879@qq.com
|
|
@Copyright: (c) 2024 by g1879, Inc. All Rights Reserved.
|
|
@License : BSD 3-Clause.
|
|
"""
|
|
from abc import abstractmethod
|
|
from typing import Union, Tuple, List, Any, Optional
|
|
|
|
from DownloadKit import DownloadKit
|
|
|
|
from .._elements.none_element import NoneElement
|
|
from .._elements.session_element import SessionElement
|
|
from .._functions.elements import SessionElementsList
|
|
from .._pages.chromium_page import ChromiumPage
|
|
from .._pages.session_page import SessionPage
|
|
from .._pages.mix_page import MixPage
|
|
|
|
|
|
class BaseParser(object):
|
|
_type: str
|
|
|
|
def __call__(self, locator: Union[Tuple[str, str], str], index: int = 1): ...
|
|
|
|
def ele(self,
|
|
locator: Union[Tuple[str, str], str, BaseElement],
|
|
index: int = 1,
|
|
timeout: float = None): ...
|
|
|
|
def eles(self, locator: Union[Tuple[str, str], str], timeout=None): ...
|
|
|
|
# ----------------以下属性或方法待后代实现----------------
|
|
@property
|
|
def html(self) -> str: ...
|
|
|
|
def s_ele(self,
|
|
locator: Union[Tuple[str, str], str, BaseElement, None] = None,
|
|
index: int = 1) -> SessionElement: ...
|
|
|
|
def s_eles(self, locator: Union[Tuple[str, str], str]) -> SessionElementsList: ...
|
|
|
|
def _ele(self,
|
|
locator: Union[Tuple[str, str], str],
|
|
timeout: float = None,
|
|
index: Optional[int] = 1,
|
|
raise_err: bool = None,
|
|
method: str = None): ...
|
|
|
|
def _find_elements(self,
|
|
locator: Union[Tuple[str, str], str],
|
|
timeout: float = None,
|
|
index: Optional[int] = 1,
|
|
relative: bool = False,
|
|
raise_err: bool = None): ...
|
|
|
|
|
|
class BaseElement(BaseParser):
|
|
|
|
def __init__(self, owner: BasePage = None):
|
|
self.owner: BasePage = ...
|
|
|
|
# ----------------以下属性或方法由后代实现----------------
|
|
@property
|
|
def tag(self) -> str: ...
|
|
|
|
def _ele(self,
|
|
locator: Union[Tuple[str, str], str],
|
|
timeout: float = None,
|
|
index: Optional[int] = 1,
|
|
relative: bool = False,
|
|
raise_err: bool = None,
|
|
method: str = None): ...
|
|
|
|
def parent(self, level_or_loc: Union[tuple, str, int] = 1): ...
|
|
|
|
def prev(self, index: int = 1) -> None: ...
|
|
|
|
def prevs(self) -> None: ...
|
|
|
|
def next(self, index: int = 1): ...
|
|
|
|
def nexts(self): ...
|
|
|
|
|
|
class DrissionElement(BaseElement):
|
|
|
|
def __init__(self, owner: BasePage = None): ...
|
|
|
|
@property
|
|
def link(self) -> str: ...
|
|
|
|
@property
|
|
def css_path(self) -> str: ...
|
|
|
|
@property
|
|
def xpath(self) -> str: ...
|
|
|
|
@property
|
|
def comments(self) -> list: ...
|
|
|
|
def texts(self, text_node_only: bool = False) -> list: ...
|
|
|
|
def parent(self,
|
|
level_or_loc: Union[tuple, str, int] = 1,
|
|
index: int = 1) -> Union[DrissionElement, None]: ...
|
|
|
|
def child(self,
|
|
locator: Union[Tuple[str, str], str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[DrissionElement, str, NoneElement]: ...
|
|
|
|
def prev(self,
|
|
locator: Union[Tuple[str, str], str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[DrissionElement, str, NoneElement]: ...
|
|
|
|
def next(self,
|
|
locator: Union[Tuple[str, str], str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[DrissionElement, str, NoneElement]: ...
|
|
|
|
def before(self,
|
|
locator: Union[Tuple[str, str], str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[DrissionElement, str, NoneElement]: ...
|
|
|
|
def after(self,
|
|
locator: Union[Tuple[str, str], str, int] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> Union[DrissionElement, str, NoneElement]: ...
|
|
|
|
def children(self,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
def prevs(self,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
def nexts(self,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
def befores(self,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
def afters(self,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
def _get_relative(self,
|
|
func: str,
|
|
direction: str,
|
|
brother: bool,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
index: int = 1,
|
|
timeout: float = None,
|
|
ele_only: bool = True) -> DrissionElement: ...
|
|
|
|
def _get_relatives(self,
|
|
index: int = None,
|
|
locator: Union[Tuple[str, str], str] = '',
|
|
direction: str = 'following',
|
|
brother: bool = True,
|
|
timeout: float = 0.5,
|
|
ele_only: bool = True) -> List[Union[DrissionElement, str]]: ...
|
|
|
|
# ----------------以下属性或方法由后代实现----------------
|
|
@property
|
|
def attrs(self) -> dict: ...
|
|
|
|
@property
|
|
def text(self) -> str: ...
|
|
|
|
@property
|
|
def raw_text(self) -> str: ...
|
|
|
|
@abstractmethod
|
|
def attr(self, name: str) -> str: ...
|
|
|
|
def _get_ele_path(self, mode) -> str: ...
|
|
|
|
|
|
class BasePage(BaseParser):
|
|
|
|
def __init__(self):
|
|
self._url_available: bool = ...
|
|
self.retry_times: int = ...
|
|
self.retry_interval: float = ...
|
|
self._download_path: str = ...
|
|
self._DownloadKit: DownloadKit = ...
|
|
self._none_ele_return_value: bool = ...
|
|
self._none_ele_value: Any = ...
|
|
self._page: Union[ChromiumPage, SessionPage, MixPage] = ...
|
|
|
|
@property
|
|
def title(self) -> Union[str, None]: ...
|
|
|
|
@property
|
|
def url_available(self) -> bool: ...
|
|
|
|
@property
|
|
def download_path(self) -> str: ...
|
|
|
|
@property
|
|
def download(self) -> DownloadKit: ...
|
|
|
|
def _before_connect(self, url: str, retry: int, interval: float) -> tuple: ...
|
|
|
|
# ----------------以下属性或方法由后代实现----------------
|
|
@property
|
|
def url(self) -> str: ...
|
|
|
|
@property
|
|
def json(self) -> dict: ...
|
|
|
|
@property
|
|
def user_agent(self) -> str: ...
|
|
|
|
@abstractmethod
|
|
def get(self, url: str, show_errmsg: bool = False, retry: int = None, interval: float = None): ...
|
|
|
|
def _ele(self,
|
|
locator,
|
|
timeout: float = None,
|
|
index: Optional[int] = 1,
|
|
raise_err: bool = None,
|
|
method: str = None): ...
|