selectolax 0.3.28__cp312-cp312-win_amd64.whl → 0.3.30__cp312-cp312-win_amd64.whl

selectolax/parser.pyi

@@ -1,4 +1,4 @@
-from typing import Any, Iterator, TypeVar, Literal, overload
+from typing import Iterator, TypeVar, Literal, overload
 
 DefaultT = TypeVar("DefaultT")
 
@@ -146,17 +146,13 @@ class Node:
         ...
     @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: ...
+            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."""
+            self, query: str, default: None = None, strict: bool = False
+    ) -> Node | None | DefaultT:
         ...
     def decompose(self, recursive: bool = True) -> None:
         """Remove a Node from the tree."""
@@ -170,7 +166,7 @@ class Node:
     def strip_tags(self, tags: list[str], recursive: bool = False) -> None:
         """Remove specified tags from the HTML tree."""
         ...
-    def unwrap_tags(self, tags: list[str]) -> None:
+    def unwrap_tags(self, tags: list[str], delete_empty: bool = False) -> None:
         """Unwraps specified tags from the HTML tree.
 
         Works the same as the unwrap method, but applied to a list of tags."""
@@ -236,18 +232,15 @@ class HTMLParser:
         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: ...
+    ) -> Node | DefaultT:
+        ...
+
     @overload
     def css_first(
-        self, query: str, default: None = ..., strict: bool = False
-    ) -> Node | None:
-        """Same as css but returns only the first match."""
+            self, query: str, default: None = None, strict: bool = False
+    ) -> Node | None | DefaultT:
         ...
     @property
     def input_encoding(self) -> str:
@@ -274,7 +267,7 @@ class HTMLParser:
         """Returns the text of the node including text of all its child nodes."""
         ...
     def strip_tags(self, tags: list[str], recursive: bool = False) -> None: ...
-    def unwrap_tags(self, tags: list[str]) -> None:
+    def unwrap_tags(self, tags: list[str], delete_empty: bool = False) -> None:
         """Unwraps specified tags from the HTML tree.
 
         Works the same as th unwrap method, but applied to a list of tags."""

selectolax/parser.pyx

@@ -124,7 +124,7 @@ cdef class HTMLParser:
             status = myhtml_parse(self.html_tree, self._encoding, html, html_len)
 
         if status != 0:
-            raise RuntimeError("Can't parse HTML:\n%s" % str(html))
+            raise RuntimeError("Can't parse HTML (status code: %d)" % status)
 
         assert self.html_tree.node_html != NULL
 
@@ -147,9 +147,13 @@ cdef class HTMLParser:
     def root(self):
         """Returns root node."""
         if self.html_tree and self.html_tree.node_html:
-            node = Node()
-            node._init(self.html_tree.node_html, self)
-            return node
+            try:
+                node = Node()
+                node._init(self.html_tree.node_html, self)
+                return node
+            except Exception:
+                # If Node creation or initialization fails, return None
+                return None
         return None
 
     @property
@@ -185,6 +189,12 @@ cdef class HTMLParser:
         name : str (e.g. div)
 
         """
+        # Validate tag name
+        if not name:
+            raise ValueError("Tag name cannot be empty")
+        if len(name) > 100:  # Reasonable limit for tag names
+            raise ValueError("Tag name is too long")
+
         cdef myhtml_collection_t* collection = NULL
         pybyte_name = name.encode('UTF-8')
         cdef mystatus_t status = 0;
@@ -269,7 +279,7 @@ cdef class HTMLParser:
             myhtml_collection_destroy(collection)
 
 
-    def unwrap_tags(self, list tags):
+    def unwrap_tags(self, list tags, delete_empty : bool = False):
         """Unwraps specified tags from the HTML tree.
 
         Works the same as th `unwrap` method, but applied to a list of tags.
@@ -278,6 +288,8 @@ cdef class HTMLParser:
         ----------
         tags : list
             List of tags to remove.
+        delete_empty : bool, default False
+            If True, removes empty tags.
 
         Examples
         --------
@@ -288,7 +300,7 @@ cdef class HTMLParser:
         '<body><div>Hello world!</div></body>'
         """
         if self.root is not None:
-            self.root.unwrap_tags(tags)
+            self.root.unwrap_tags(tags, delete_empty=delete_empty)
 
     @property
     def html(self):
@@ -426,6 +438,7 @@ cdef class HTMLParser:
         if self.html_tree != NULL:
             myhtml = self.html_tree.myhtml
             myhtml_tree_destroy(self.html_tree)
+            self.html_tree = NULL  # Prevent double-free
             if myhtml != NULL:
                 myhtml_destroy(myhtml)
 

{selectolax-0.3.28.dist-info → selectolax-0.3.30.dist-info}/METADATA

@@ -1,13 +1,25 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: selectolax
-Version: 0.3.28
+Version: 0.3.30
 Summary: Fast HTML5 parser with CSS selectors.
 Home-page: https://github.com/rushter/selectolax
 Author: Artem Golubin
-Author-email: me@rushter.com
-License: MIT license
-Project-URL: Source code, https://github.com/rushter/selectolax
-Keywords: selectolax
+Author-email: Artem Golubin <me@rushter.com>
+License: 
+        MIT License
+        
+        Copyright (c) 2018-2025, Artem Golubin
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+        
+Project-URL: Repository, https://github.com/rushter/selectolax
+Project-URL: Documentation, https://selectolax.readthedocs.io/en/latest/parser.html
+Project-URL: Changelog, https://github.com/rushter/selectolax/blob/main/CHANGES.rst
+Keywords: selectolax,html,parser,css,fast
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Topic :: Internet
@@ -16,26 +28,18 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
 License-File: LICENSE
-Provides-Extra: cython
-Requires-Dist: Cython==3.0.11; extra == "cython"
+Requires-Dist: Cython==3.0.11
 Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
 Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: summary
+Dynamic: license-file
 
 .. image:: docs/logo.png
   :alt: selectolax logo

selectolax-0.3.30.dist-info/RECORD

@@ -0,0 +1,26 @@
+selectolax/__init__.py,sha256=QXGDeB8i55GmKcd_UXLaBjnqN76hPlaDFhHSTBgQwEc,185
+selectolax/base.pxi,sha256=zOj3BrCA71xd-mJFtkMIAglP4ZybfrHVoCoy6ljTBDQ,93
+selectolax/lexbor.c,sha256=t2OJwP7pIHYq-Ry6qHIIvivpAsJN4E-08FVdNmer5gU,2373583
+selectolax/lexbor.cp312-win_amd64.pyd,sha256=bksK0foiNRLaFa0sUJuQeHdfebjZq69BxAl1X2OVgHQ,3189760
+selectolax/lexbor.pxd,sha256=1d9nvZd9rZl27gwPwVV5BlbR2LAi6jDK69Xm9Guz5Kk,21538
+selectolax/lexbor.pyi,sha256=BZSChBeL9ctyJk3IICpHyzmbFytD8sYvr4v3hSG7iIk,6877
+selectolax/lexbor.pyx,sha256=-O-g03mLCQKc9F19eMvo3PyoLDtF09IIuFziXJAl6Ao,11520
+selectolax/parser.c,sha256=pok6ajFRnMk_QBj0cFkvNk4C_jt7gGTbbqHoJ2j8yHk,2237176
+selectolax/parser.cp312-win_amd64.pyd,sha256=Wn_FPA7iMxLiYp1sSUmSIg-XZUxgP7YhmItuGz7BUAs,2152960
+selectolax/parser.pxd,sha256=4pM_CcZlvJlaR8EMjZCnSmnCcJbwcYOldRTBEbfwm48,25145
+selectolax/parser.pyi,sha256=jFQa0_av9w9HT4XtbJioI86Le0N_Wvbc7BFbdPqDuHM,11598
+selectolax/parser.pyx,sha256=bS2n70o_5OPJ6JuXTBAVUTc-XhxqC4DXzPE4H3-e5Ek,13987
+selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+selectolax/utils.pxi,sha256=4rtdRcLWuemxN1qe7Eul5jvAmHZ65r7Gvf67_Wg8Bt4,3566
+selectolax/lexbor/attrs.pxi,sha256=r9DroDAkoxIvSMiDTRKpfYp503b7yUteDoYwglhQ0FM,3241
+selectolax/lexbor/node.pxi,sha256=aLt7VzOvVErdkafncXR8LSwPBdODACh00kBtoaBBSQM,30736
+selectolax/lexbor/selection.pxi,sha256=irSqUr6-csI3RNQMv11FNGd__GX1VjVmVhB7aSmj8Wg,6951
+selectolax/lexbor/util.pxi,sha256=0I4ElWIwXxrZCfMmGCtyDU127oMsPCqC3IcUk4QmMAc,582
+selectolax/modest/node.pxi,sha256=Da2b3cdmggCX736x0htGvac51SEeGCcY5l-LA5H4HNI,34376
+selectolax/modest/selection.pxi,sha256=0elY7JwnpPVaw0QZE1T7A78s9FIph5uWIhwy4sEXGU8,6586
+selectolax/modest/util.pxi,sha256=o2nPGGGtRlLqOCa7yPk94CfBzNlVr7ull7osFy6NRX4,570
+selectolax-0.3.30.dist-info/licenses/LICENSE,sha256=A7Jb3WZcENcLfZRc7QPdm9zJdwfpIyPodPJu-kdMH6E,1087
+selectolax-0.3.30.dist-info/METADATA,sha256=QPFdZ2KqmowrwhCaOA9B49GIKqpHzAEW6ObesnXTvZw,7582
+selectolax-0.3.30.dist-info/WHEEL,sha256=8UP9x9puWI0P1V_d7K2oMTBqfeLNm21CTzZ_Ptr0NXU,101
+selectolax-0.3.30.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
+selectolax-0.3.30.dist-info/RECORD,,

{selectolax-0.3.28.dist-info → selectolax-0.3.30.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: false
 Tag: cp312-cp312-win_amd64
 

selectolax-0.3.28.dist-info/RECORD

@@ -1,26 +0,0 @@
-selectolax/__init__.py,sha256=IMgHVlDkSCVB-D4ya7t6eqh3wvTxHwRpxOvV6ybw-Lw,185
-selectolax/base.pxi,sha256=zOj3BrCA71xd-mJFtkMIAglP4ZybfrHVoCoy6ljTBDQ,93
-selectolax/lexbor.c,sha256=Uwb33OzA7c6RxSct6extDwdzZZOGZrBjfnZqJklCvMk,2360252
-selectolax/lexbor.cp312-win_amd64.pyd,sha256=-hOR5choWScXEuvKF6bhtgWSxbAEW4T3DdirgbVbqCU,3197440
-selectolax/lexbor.pxd,sha256=1d9nvZd9rZl27gwPwVV5BlbR2LAi6jDK69Xm9Guz5Kk,21538
-selectolax/lexbor.pyi,sha256=32Ky5eZkOAPc4pN3m-eZQy4EJQV7O8xUwGHOWkOI06o,6724
-selectolax/lexbor.pyx,sha256=CYorl52H--UfKOihmZn7SxVIjl2GYvSVh3Lg9YMRACU,11231
-selectolax/parser.c,sha256=rGXXnE3kJJDElEps9cQMYaIfXCCxVpDk5ELR-RQF5nk,2215098
-selectolax/parser.cp312-win_amd64.pyd,sha256=aNfiQvEvkFBytjpZxi4ayo-eql0BsPjFe8gEAoZ9Pfc,2149888
-selectolax/parser.pxd,sha256=4pM_CcZlvJlaR8EMjZCnSmnCcJbwcYOldRTBEbfwm48,25145
-selectolax/parser.pyi,sha256=XItuYMW5pdpTbTFMI1FjH0JvBao9VTwbtfvnnrLn0Pk,11891
-selectolax/parser.pyx,sha256=lQW4qJ6nCDraCupvcT61zUkgo-S-KIzl9JIGV6hh6hA,13386
-selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-selectolax/utils.pxi,sha256=4rtdRcLWuemxN1qe7Eul5jvAmHZ65r7Gvf67_Wg8Bt4,3566
-selectolax/lexbor/attrs.pxi,sha256=r9DroDAkoxIvSMiDTRKpfYp503b7yUteDoYwglhQ0FM,3241
-selectolax/lexbor/node.pxi,sha256=g5R3gZw-Xa7y8TkupE4mAyaorcdDArl5DeaKBBU35jA,30207
-selectolax/lexbor/selection.pxi,sha256=DVtVnaCwzXPPkDqgW0vEtkQa1zWJ0c2Ud3KGSrvK5PM,6755
-selectolax/lexbor/util.pxi,sha256=0I4ElWIwXxrZCfMmGCtyDU127oMsPCqC3IcUk4QmMAc,582
-selectolax/modest/node.pxi,sha256=xDJTFhcvkF7FGSObnCftZJSIBj7wV1--IdLJbFoIItw,33519
-selectolax/modest/selection.pxi,sha256=0elY7JwnpPVaw0QZE1T7A78s9FIph5uWIhwy4sEXGU8,6586
-selectolax/modest/util.pxi,sha256=o2nPGGGtRlLqOCa7yPk94CfBzNlVr7ull7osFy6NRX4,570
-selectolax-0.3.28.dist-info/LICENSE,sha256=A7Jb3WZcENcLfZRc7QPdm9zJdwfpIyPodPJu-kdMH6E,1087
-selectolax-0.3.28.dist-info/METADATA,sha256=KFj4io2mGglBQQmipQ0zmc_yAmwXu8kDVav_YS3SBZc,6448
-selectolax-0.3.28.dist-info/WHEEL,sha256=cRmSBGD-cl98KkuHMNqv9Ac9L9_VqTvcBYwpIvxN0cg,101
-selectolax-0.3.28.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
-selectolax-0.3.28.dist-info/RECORD,,