selectolax 0.3.25__cp310-cp310-macosx_10_9_universal2.whl → 0.3.26__cp310-cp310-macosx_10_9_universal2.whl

selectolax/__init__.py

@@ -3,7 +3,7 @@
 
 __author__ = """Artem Golubin"""
 __email__ = 'me@rushter.com'
-__version__ = '0.3.25'
+__version__ = '0.3.26'
 
 from . import parser
 from . import lexbor

selectolax/lexbor.pyi

@@ -1,14 +1,27 @@
-from typing import Iterator, TypeVar, NoReturn
+from typing import Any, Iterator, Literal, TypeVar, NoReturn, overload
 
 DefaultT = TypeVar("DefaultT")
 
 class LexborAttributes:
     @staticmethod
-    def create(node: "LexborAttributes") -> "LexborAttributes": ...
+    def create(node: LexborAttributes) -> LexborAttributes: ...
     def keys(self) -> Iterator[str]: ...
-    def items(self) -> Iterator[tuple[str, str]]: ...
-    def values(self) -> Iterator[str]: ...
-    def get(self, key: str, default: DefaultT | None = None) -> str | DefaultT | None: ...
+    def items(self) -> Iterator[tuple[str, str | None]]: ...
+    def values(self) -> Iterator[str | None]: ...
+    def __iter__(self) -> Iterator[str]: ...
+    def __len__(self) -> int: ...
+    def __getitem__(self, key: str) -> str | None: ...
+    def __setitem__(self, key: str, value: str) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def __contains__(self, key: str) -> bool: ...
+    def __repr__(self) -> str: ...
+    @overload
+    def get(self, key: str, default: DefaultT) -> DefaultT | str | None: ...
+    @overload
+    def get(self, key: str, default: None = ...) -> str | None: ...
+    @overload
+    def sget(self, key: str, default: str | DefaultT) -> str | DefaultT: ...
+    @overload
     def sget(self, key: str, default: str = "") -> str: ...
 
 class LexborSelector:
@@ -20,38 +33,38 @@ class LexborSelector:
     def any_matches(self) -> bool: ...
     def text_contains(
         self, text: str, deep: bool = True, separator: str = "", strip: bool = False
-    ) -> "LexborSelector": ...
+    ) -> LexborSelector: ...
     def any_text_contains(
         self, text: str, deep: bool = True, separator: str = "", strip: bool = False
     ) -> bool: ...
     def attribute_longer_than(
         self, attribute: str, length: int, start: str | None = None
-    ) -> "LexborSelector": ...
+    ) -> LexborSelector: ...
     def any_attribute_longer_than(
         self, attribute: str, length: int, start: str | None = None
     ) -> bool: ...
 
 class LexborCSSSelector:
     def __init__(self): ...
-    def find(self, query: str, node: "LexborNode") -> list["LexborNode"]: ...
-    def any_matches(self, query: str, node: "LexborNode") -> bool: ...
+    def find(self, query: str, node: LexborNode) -> list[LexborNode]: ...
+    def any_matches(self, query: str, node: LexborNode) -> bool: ...
 
 class LexborNode:
-    parser: "LexborHTMLParser"
+    parser: LexborHTMLParser
     @property
     def mem_id(self) -> int: ...
     @property
-    def child(self) -> None | "LexborNode": ...
+    def child(self) -> LexborNode | None: ...
     @property
-    def first_child(self) -> None | "LexborNode": ...
+    def first_child(self) -> LexborNode | None: ...
     @property
-    def parent(self) -> None | "LexborNode": ...
+    def parent(self) -> LexborNode | None: ...
     @property
-    def next(self) -> None | "LexborNode": ...
+    def next(self) -> LexborNode | None: ...
     @property
-    def prev(self) -> None | "LexborNode": ...
+    def prev(self) -> LexborNode | None: ...
     @property
-    def last_child(self) -> None | "LexborNode": ...
+    def last_child(self) -> LexborNode | None: ...
     @property
     def html(self) -> str | None: ...
     def __hash__(self) -> int: ...
@@ -59,10 +72,19 @@ class LexborNode:
     def text(
         self, deep: bool = True, separator: str = "", strip: bool = False
     ) -> str: ...
-    def css(self, query: str) -> list["LexborNode"]: ...
+    def css(self, query: str) -> list[LexborNode]: ...
+    @overload
     def css_first(
-        self, query: str, default: DefaultT | None = None, strict: bool = False
-    ) -> "LexborNode" | DefaultT | None: ...
+        self, query: str, default: Any = ..., strict: Literal[True] = ...
+    ) -> LexborNode: ...
+    @overload
+    def css_first(
+        self, query: str, default: DefaultT, strict: bool = False
+    ) -> LexborNode | DefaultT: ...
+    @overload
+    def css_first(
+        self, query: str, default: None = ..., strict: bool = False
+    ) -> LexborNode | None: ...
     def any_css_matches(self, selectors: tuple[str]) -> bool: ...
     def css_matches(self, selector: str) -> bool: ...
     @property
@@ -74,23 +96,23 @@ class LexborNode:
     @property
     def attributes(self) -> dict[str, str | None]: ...
     @property
-    def attrs(self) -> "LexborAttributes": ...
+    def attrs(self) -> LexborAttributes: ...
     @property
-    def id(self) -> None | str: ...
-    def iter(self, include_text: bool = False) -> Iterator["LexborNode"]: ...
+    def id(self) -> str | None: ...
+    def iter(self, include_text: bool = False) -> Iterator[LexborNode]: ...
     def unwrap(self) -> None: ...
     def unwrap_tags(self, tags: list[str]) -> None: ...
-    def traverse(self, include_text: bool = False) -> Iterator["LexborNode"]: ...
-    def replace_with(self, value: bytes | str | "LexborNode") -> None: ...
-    def insert_before(self, value: bytes | str | "LexborNode") -> None: ...
-    def insert_after(self, value: bytes | str | "LexborNode") -> None: ...
-    def insert_child(self, value: bytes | str | "LexborNode") -> None: ...
+    def traverse(self, include_text: bool = False) -> Iterator[LexborNode]: ...
+    def replace_with(self, value: bytes | str | LexborNode) -> None: ...
+    def insert_before(self, value: bytes | str | LexborNode) -> None: ...
+    def insert_after(self, value: bytes | str | LexborNode) -> None: ...
+    def insert_child(self, value: bytes | str | LexborNode) -> None: ...
     @property
     def raw_value(self) -> NoReturn: ...
     def scripts_contain(self, query: str) -> bool: ...
     def scripts_srcs_contain(self, queries: tuple[str]) -> bool: ...
     def remove(self, recursive: bool = True) -> None: ...
-    def select(self, query: str | None = None) -> "LexborSelector": ...
+    def select(self, query: str | None = None) -> LexborSelector: ...
     @property
     def text_content(self) -> str | None: ...
 
@@ -99,38 +121,47 @@ class LexborHTMLParser:
     @property
     def selector(self) -> "LexborCSSSelector": ...
     @property
-    def root(self) -> "LexborNode" | None: ...
+    def root(self) -> LexborNode | None: ...
     @property
-    def body(self) -> "LexborNode" | None: ...
+    def body(self) -> LexborNode | None: ...
     @property
-    def head(self) -> None | "LexborNode": ...
-    def tags(self, name: str) -> list["LexborNode"]: ...
+    def head(self) -> LexborNode | None: ...
+    def tags(self, name: str) -> list[LexborNode]: ...
     def text(
         self, deep: bool = True, separator: str = "", strip: bool = False
     ) -> str: ...
     @property
-    def html(self) -> None | str: ...
-    def css(self, query: str) -> list["LexborNode"]: ...
+    def html(self) -> str | None: ...
+    def css(self, query: str) -> list[LexborNode]: ...
+    @overload
+    def css_first(
+        self, query: str, default: Any = ..., strict: Literal[True] = ...
+    ) -> LexborNode: ...
+    @overload
+    def css_first(
+        self, query: str, default: DefaultT, strict: bool = False
+    ) -> LexborNode | DefaultT: ...
+    @overload
     def css_first(
-        self, query: str, default: DefaultT | None = None, strict: bool = False
-    ) -> "LexborNode" | DefaultT | None : ...
+        self, query: str, default: None = ..., strict: bool = False
+    ) -> LexborNode | None: ...
     def strip_tags(self, tags: list[str], recursive: bool = False) -> None: ...
-    def select(self, query: str | None = None) -> "LexborSelector" | None: ...
+    def select(self, query: str | None = None) -> LexborSelector | None: ...
     def any_css_matches(self, selectors: tuple[str]) -> bool: ...
     def scripts_contain(self, query: str) -> bool: ...
     def scripts_srcs_contain(self, queries: tuple[str]) -> bool: ...
     def css_matches(self, selector: str) -> bool: ...
-    def clone(self) -> "LexborHTMLParser": ...
+    def clone(self) -> LexborHTMLParser: ...
     def unwrap_tags(self, tags: list[str]) -> None: ...
 
-def create_tag(tag: str) -> "LexborNode":
+def create_tag(tag: str) -> LexborNode:
     """
     Given an HTML tag name, e.g. `"div"`, create a single empty node for that tag,
     e.g. `"<div></div>"`.
     """
     ...
 
-def parse_fragment(html: str) -> list["LexborNode"]:
+def parse_fragment(html: str) -> list[LexborNode]:
     """
     Given HTML, parse it into a list of Nodes, such that the nodes
     correspond to the given HTML.

selectolax/parser.pyi

@@ -1,15 +1,28 @@
-from typing import Iterator, TypeVar, Literal
+from typing import Any, Iterator, TypeVar, Literal, overload
 
 DefaultT = TypeVar("DefaultT")
 
 class _Attributes:
     @staticmethod
-    def create(node: "Node", decode_errors: str) -> "_Attributes": ...
+    def create(node: Node, decode_errors: str) -> _Attributes: ...
     def keys(self) -> Iterator[str]: ...
-    def items(self) -> Iterator[tuple[str, str]]: ...
-    def values(self) -> Iterator[str]: ...
-    def get(self, key, default: DefaultT | None = None) -> str | DefaultT: ...
-    def sget(self, key, default: str = "") -> str | DefaultT: ...
+    def items(self) -> Iterator[tuple[str, str | None]]: ...
+    def values(self) -> Iterator[str | None]: ...
+    def __iter__(self) -> Iterator[str]: ...
+    def __len__(self) -> int: ...
+    def __getitem__(self, key: str) -> str | None: ...
+    def __setitem__(self, key: str, value: str) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def __contains__(self, key: str) -> bool: ...
+    def __repr__(self) -> str: ...
+    @overload
+    def get(self, key: str, default: DefaultT) -> DefaultT | str | None: ...
+    @overload
+    def get(self, key: str, default: None = ...) -> str | None: ...
+    @overload
+    def sget(self, key: str, default: str | DefaultT) -> str | DefaultT: ...
+    @overload
+    def sget(self, key: str, default: str = "") -> str: ...
 
 class Selector:
     """An advanced CSS selector that supports additional operations.
@@ -18,12 +31,12 @@ class Selector:
 
     Please note, this is an experimental feature that can change in the future."""
 
-    def __init__(self, node: "Node", query: str): ...
-    def css(self, query: str) -> "Node":
+    def __init__(self, node: Node, query: str): ...
+    def css(self, query: str) -> Node:
         """Evaluate CSS selector against current scope."""
         ...
     @property
-    def matches(self) -> list["Node"]:
+    def matches(self) -> list[Node]:
         """Returns all possible selector matches"""
         ...
     @property
@@ -32,7 +45,7 @@ class Selector:
         ...
     def text_contains(
         self, text: str, deep: bool = True, separator: str = "", strip: bool = False
-    ) -> "Selector":
+    ) -> Selector:
         """Filter all current matches given text."""
         ...
     def any_text_contains(
@@ -42,7 +55,7 @@ class Selector:
         ...
     def attribute_long_than(
         self, text: str, length: int, start: str | None = None
-    ) -> "Selector":
+    ) -> Selector:
         """Filter all current matches by attribute length.
 
         Similar to string-length in XPath."""
@@ -56,15 +69,15 @@ class Selector:
         ...
 
 class Node:
-    parser: "HTMLParser"
+    parser: HTMLParser
     @property
-    def attributes(self) -> dict[str, None | str]:
+    def attributes(self) -> dict[str, str | None]:
         """Get all attributes that belong to the current node.
 
         The value of empty attributes is None."""
         ...
     @property
-    def attrs(self) -> "_Attributes":
+    def attrs(self) -> _Attributes:
         """A dict-like object that is similar to the attributes property, but operates directly on the Node data."""
         ...
     @property
@@ -88,10 +101,10 @@ class Node:
     def text(self, deep: bool = True, separator: str = "", strip: bool = False) -> str:
         """Returns the text of the node including text of all its child nodes."""
         ...
-    def iter(self, include_text: bool = False) -> Iterator["Node"]:
+    def iter(self, include_text: bool = False) -> Iterator[Node]:
         """Iterate over nodes on the current level."""
         ...
-    def traverse(self, include_text: bool = False) -> Iterator["Node"]:
+    def traverse(self, include_text: bool = False) -> Iterator[Node]:
         """Iterate over all child and next nodes starting from the current level."""
         ...
     @property
@@ -99,30 +112,30 @@ class Node:
         """Return the name of the current tag (e.g. div, p, img)."""
         ...
     @property
-    def child(self) -> None | "Node":
+    def child(self) -> Node | None:
         """Return the child node."""
         ...
     @property
-    def parent(self) -> None | "Node":
+    def parent(self) -> Node | None:
         """Return the parent node."""
         ...
     @property
-    def next(self) -> None | "Node":
+    def next(self) -> Node | None:
         """Return next node."""
         ...
     @property
-    def prev(self) -> None | "Node":
+    def prev(self) -> Node | None:
         """Return previous node."""
         ...
     @property
-    def last_child(self) -> None | "Node":
+    def last_child(self) -> Node | None:
         """Return last child node."""
         ...
     @property
-    def html(self) -> None | str:
+    def html(self) -> str | None:
         """Return HTML representation of the current node including all its child nodes."""
         ...
-    def css(self, query: str) -> list["Node"]:
+    def css(self, query: str) -> list[Node]:
         """Evaluate CSS selector against current node and its child nodes."""
         ...
     def any_css_matches(self, selectors: tuple[str]) -> bool:
@@ -131,9 +144,18 @@ class Node:
     def css_matches(self, selector: str) -> bool:
         """Returns True if CSS selector matches a node."""
         ...
+    @overload
     def css_first(
-        self, query: str, default: DefaultT | None = None, strict: bool = False
-    ) -> "Node" | DefaultT:
+        self, query: str, default: Any = ..., strict: Literal[True] = ...
+    ) -> Node: ...
+    @overload
+    def css_first(
+        self, query: str, default: DefaultT, strict: bool = False
+    ) -> Node | DefaultT: ...
+    @overload
+    def css_first(
+        self, query: str, default: None = ..., strict: bool = False
+    ) -> Node | None:
         """Evaluate CSS selector against current node and its child nodes."""
         ...
     def decompose(self, recursive: bool = True) -> None:
@@ -171,7 +193,7 @@ class Node:
 
         Currently, works on text nodes only."""
         ...
-    def select(self, query: str | None = None) -> "Selector":
+    def select(self, query: str | None = None) -> Selector:
         """Select nodes given a CSS selector.
 
         Works similarly to the css method, but supports chained filtering and extra features.
@@ -208,14 +230,23 @@ class HTMLParser:
         use_meta_tags: bool = True,
         decode_errors: Literal["strict", "ignore", "replace"] = "ignore",
     ): ...
-    def css(self, query: str) -> list["Node"]:
+    def css(self, query: str) -> list[Node]:
         """A CSS selector.
 
         Matches pattern query against HTML tree."""
         ...
+    @overload
+    def css_first(
+        self, query: str, default: Any = ..., strict: Literal[True] = ...
+    ) -> Node: ...
+    @overload
+    def css_first(
+        self, query: str, default: DefaultT, strict: bool = False
+    ) -> Node | DefaultT: ...
+    @overload
     def css_first(
-        self, query: str, default: DefaultT | None = None, strict: bool = False
-    ) -> DefaultT | "Node":
+        self, query: str, default: None = ..., strict: bool = False
+    ) -> Node | None:
         """Same as css but returns only the first match."""
         ...
     @property
@@ -225,18 +256,18 @@ class HTMLParser:
         Returns unknown in case the encoding is not determined."""
         ...
     @property
-    def root(self) -> "Node" | None:
+    def root(self) -> Node | None:
         """Returns root node."""
         ...
     @property
-    def head(self) -> "Node" | None:
+    def head(self) -> Node | None:
         """Returns head node."""
         ...
     @property
-    def body(self) -> "Node" | None:
+    def body(self) -> Node | None:
         """Returns document body."""
         ...
-    def tags(self, name: str) -> list["Node"]:
+    def tags(self, name: str) -> list[Node]:
         """Returns a list of tags that match specified name."""
         ...
     def text(self, deep: bool = True, separator: str = "", strip: bool = False) -> str:
@@ -249,10 +280,10 @@ class HTMLParser:
         Works the same as th unwrap method, but applied to a list of tags."""
         ...
     @property
-    def html(self) -> None | str:
+    def html(self) -> str | None:
         """Return HTML representation of the page."""
         ...
-    def select(self, query: str | None = None) -> "Selector" | None:
+    def select(self, query: str | None = None) -> Selector | None:
         """Select nodes given a CSS selector.
 
         Works similarly to the css method, but supports chained filtering and extra features.
@@ -272,7 +303,7 @@ class HTMLParser:
         Caches values on the first call to improve performance."""
         ...
     def css_matches(self, selector: str) -> bool: ...
-    def clone(self) -> "HTMLParser":
+    def clone(self) -> HTMLParser:
         """Clone the current tree."""
         ...
     def merge_text_nodes(self):
@@ -281,14 +312,14 @@ class HTMLParser:
         This is useful for text extraction."""
         ...
 
-def create_tag(tag: str) -> "Node":
+def create_tag(tag: str) -> Node:
     """
     Given an HTML tag name, e.g. `"div"`, create a single empty node for that tag,
     e.g. `"<div></div>"`.
     """
     ...
 
-def parse_fragment(html: str) -> list["Node"]:
+def parse_fragment(html: str) -> list[Node]:
     """
     Given HTML, parse it into a list of Nodes, such that the nodes
     correspond to the given HTML.

{selectolax-0.3.25.dist-info → selectolax-0.3.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: selectolax
-Version: 0.3.25
+Version: 0.3.26
 Summary: Fast HTML5 parser with CSS selectors.
 Home-page: https://github.com/rushter/selectolax
 Author: Artem Golubin

{selectolax-0.3.25.dist-info → selectolax-0.3.26.dist-info}/RECORD

@@ -1,16 +1,16 @@
-selectolax-0.3.25.dist-info/RECORD,,
-selectolax-0.3.25.dist-info/LICENSE,sha256=kYggm2ZJzBgL79x1gCsYsx8rFIYP2IE-BdXRV3Rm0NU,1077
-selectolax-0.3.25.dist-info/WHEEL,sha256=ULRBhwOJ1mBUfjWY14LXp5Tokrb8ZwCfut8Xmx2MYRo,114
-selectolax-0.3.25.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
-selectolax-0.3.25.dist-info/METADATA,sha256=XbR_TA9gBumRbVEUX7o7IlMBJgDVyAFF0sgmFxCP-v8,5928
-selectolax/lexbor.pyi,sha256=FFVEZfXI8BwvUI0AtNQRUaTTzf66sXq2PWXiggaglug,5543
+selectolax-0.3.26.dist-info/RECORD,,
+selectolax-0.3.26.dist-info/LICENSE,sha256=kYggm2ZJzBgL79x1gCsYsx8rFIYP2IE-BdXRV3Rm0NU,1077
+selectolax-0.3.26.dist-info/WHEEL,sha256=-ZgnvM3LKeNuKQdkG78gsNHkSP6EdmDSvOu3ufDF3Vw,114
+selectolax-0.3.26.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
+selectolax-0.3.26.dist-info/METADATA,sha256=HqNPkDK0NqFA-N4HsTn3QtHYktNEwobUdCj7kw-e4VU,5928
+selectolax/lexbor.pyi,sha256=X2PMQR2XLd2rOPliKSpeFZ_VEf6mOQFTcFm0ChQbzsQ,6544
 selectolax/parser.pyx,sha256=o1HkYE_nQr3TS7EPlldJx2-ygU9B5FI2uWYFzdF-VaI,12953
-selectolax/lexbor.cpython-310-darwin.so,sha256=xrivKjM7MYXT6jpI6juvsyB4e_NorpbvVor04TZyGXU,23085632
-selectolax/__init__.py,sha256=oWCGdiVLnaTCmGs0dtRQpNGri89OdU7AwSRoqhmbajI,175
-selectolax/parser.cpython-310-darwin.so,sha256=-JckO09ERzjhBzLSEDtEAohT5HWLtaLIlpOCV3inIyY,6130424
+selectolax/lexbor.cpython-310-darwin.so,sha256=FvyVIJMZ_5hxDKtWtZqGM2Ikx0S2pT9qApE_QMUzQgg,23085632
+selectolax/__init__.py,sha256=r8TrGaSWTYcCt8yNkcf_pH1I7c7IPOMagr3wd9tCgy8,175
+selectolax/parser.cpython-310-darwin.so,sha256=yjgt_da6XJ2wnW0TuCchrsiEu7CPVDemTHkhSB9D3QU,6130424
 selectolax/lexbor.pxd,sha256=PwygBdb1blWAQcxXubZS5uffhgcXaqgySNMPFMT02-c,20958
 selectolax/lexbor.pyx,sha256=ffEzBnZjGTsI-H5qck7bfjVRE9vteOhQnDp6RjVD7G0,10750
-selectolax/parser.pyi,sha256=gDTx5Qde0rKrWDMSpZZDS5XJbPlERnwSQCN8bg5U4AA,10558
+selectolax/parser.pyi,sha256=kbR5eWvkJEy-9Hx3L_4JmGy3caIl0ki4SiagWz-fnhw,11557
 selectolax/utils.pxi,sha256=rPNMFqS0PRLkQPugwPfj-pnHCzkQzQ2cjIRMPZdR6R8,3453
 selectolax/lexbor.c,sha256=mDFnCQbjAav1zsNLpikrhF1nth0NnhlvHwFzo45-hIc,2353590
 selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0

{selectolax-0.3.25.dist-info → selectolax-0.3.26.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.2.0)
+Generator: setuptools (75.3.0)
 Root-Is-Purelib: false
 Tag: cp310-cp310-macosx_10_9_universal2