selectolax 0.3.33__cp311-cp311-win_amd64.whl → 0.4.0__cp311-cp311-win_amd64.whl

selectolax/parser.pyi

@@ -203,7 +203,10 @@ class Node:
         ...
     @property
     def child(self) -> Node | None:
-        """Return the child node."""
+        """Alias for the `first_child` property.
+
+        **Deprecated**. Please use `first_child` instead.
+        """
         ...
     @property
     def parent(self) -> Node | None:
@@ -588,7 +591,7 @@ class HTMLParser:
         query : str
         default : bool, default None
             Default value to return if there is no match.
-        strict: bool, default True
+        strict: bool, default False
             Set to True if you want to check if there is strictly only one match in the document.
 
 

selectolax/parser.pyx

@@ -72,9 +72,9 @@ cdef class HTMLParser:
         ----------
 
         query : str
-        default : bool, default None
+        default : Any, default None
             Default value to return if there is no match.
-        strict: bool, default True
+        strict: bool, default False
             Set to True if you want to check if there is strictly only one match in the document.
 
 

selectolax-0.4.0.dist-info/METADATA

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: selectolax
+Version: 0.4.0
+Summary: Fast HTML5 parser with CSS selectors.
+Home-page: https://github.com/rushter/selectolax
+Author: Artem Golubin
+Author-email: Artem Golubin <me@rushter.com>
+License-Expression: MIT
+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/master/CHANGES.md
+Keywords: selectolax,html,parser,css,fast
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Topic :: Internet
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+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; extra == "cython"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file

selectolax-0.4.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+selectolax/__init__.py,sha256=-050n6lsikxxW1ZltsXOBwrx_z-ULnFcxLZ0xTjoJQg,156
+selectolax/base.pxi,sha256=zOj3BrCA71xd-mJFtkMIAglP4ZybfrHVoCoy6ljTBDQ,93
+selectolax/lexbor.c,sha256=6syPUDLP3Kua9c9D13ahscLTX2LmSbru1gzqcTpwDVs,2501237
+selectolax/lexbor.cp311-win_amd64.pyd,sha256=JyfVbOUZzC_lLyFMcJ-7AejJWXpTJimVbfqFxXrzyBU,3186176
+selectolax/lexbor.pxd,sha256=jZugG2ClrbWzJohWWeqblIVmbvFHkbX5WB-Wvc8tkn4,22236
+selectolax/lexbor.pyi,sha256=hu1HMzR3mWfraGM-XNyiX3eHU_xljVEPg0AoRF27a_w,31046
+selectolax/lexbor.pyx,sha256=P5Q3it_Apj3rFhywvpSlcZXofOhuq9upHzbOAEDBcuA,13892
+selectolax/parser.c,sha256=gWdDUJkfF1K75R15HA17AWaV0JF2jSXM5zYEa2WWVIk,2260668
+selectolax/parser.cp311-win_amd64.pyd,sha256=XmUeV74Xr6JfABdbnIhYXX80Jj8h3Mnn5ErWcl2mB3A,2107392
+selectolax/parser.pxd,sha256=T7GoQdaOkhp_W2TBlRY0tZqom97PkHrytYaXQlyVnbI,25196
+selectolax/parser.pyi,sha256=wO1pkE5efgtWLGt0ULEqHEZ_XyxcBy_YWzFZmU5mJdQ,25699
+selectolax/parser.pyx,sha256=wy6GHgv__oa5gt1kQYGJGNc4cwVIU1NdJUJ8O4FKqmI,14127
+selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+selectolax/utils.pxi,sha256=hkzKfycdpwH1P-E_pP-9NTGsmiajt6EJNZSlkxlRapA,3623
+selectolax/lexbor/attrs.pxi,sha256=d59V77aGkpp7YsYsd6t_z4-tRnUoQTJZKsvMC8nyttM,3978
+selectolax/lexbor/node.pxi,sha256=98M-9bRzKfnbHn0-vT1v3fSUrXqojpPK2yK4FI2BEJk,36345
+selectolax/lexbor/node_remove.pxi,sha256=6h7KwWCxkLWtl71VROlLDA6EukHK745iyKK-uNw78fI,789
+selectolax/lexbor/selection.pxi,sha256=H2-oPgLAEBwhwXMmk_-49YKah5z5hGgwBK0gciQtBak,8245
+selectolax/lexbor/util.pxi,sha256=q2EYVNdnROg9y30mWpGwlNA0W00nJ7ZRNEEDrOEG14s,584
+selectolax/modest/node.pxi,sha256=M52G3TlJrHIErR8CLqIXWUjSlNSCanjSJ9aFKn1p74Y,34777
+selectolax/modest/selection.pxi,sha256=PfHUN1uuNA7YfcxTu7JZjhxevVbFRP1bHd3kyyFdO7E,6703
+selectolax/modest/util.pxi,sha256=zab67Wzo8FcipA2VS8ClptaC19lZirbNqFEGQ3hW2Is,572
+selectolax-0.4.0.dist-info/licenses/LICENSE,sha256=A7Jb3WZcENcLfZRc7QPdm9zJdwfpIyPodPJu-kdMH6E,1087
+selectolax-0.4.0.dist-info/METADATA,sha256=tbBfJ2_fHMj95Pm8aazPr0U2Jvon511S9bn5FKDMWSs,1319
+selectolax-0.4.0.dist-info/WHEEL,sha256=JLOMsP7F5qtkAkINx5UnzbFguf8CqZeraV8o04b0I8I,101
+selectolax-0.4.0.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
+selectolax-0.4.0.dist-info/RECORD,,

selectolax-0.3.33.dist-info/METADATA

@@ -1,187 +0,0 @@
-Metadata-Version: 2.4
-Name: selectolax
-Version: 0.3.33
-Summary: Fast HTML5 parser with CSS selectors.
-Home-page: https://github.com/rushter/selectolax
-Author: Artem Golubin
-Author-email: Artem Golubin <me@rushter.com>
-License: MIT
-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
-Classifier: Topic :: Internet :: WWW/HTTP
-Classifier: Intended Audience :: Developers
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3
-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; extra == "cython"
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-
-.. image:: docs/logo.png
-  :alt: selectolax logo
-
--------------------------
-
-.. image:: https://img.shields.io/pypi/v/selectolax.svg
-        :target: https://pypi.python.org/pypi/selectolax
-
-A fast HTML5 parser with CSS selectors using `Modest <https://github.com/lexborisov/Modest/>`_ and
-`Lexbor <https://github.com/lexbor/lexbor>`_ engines.
-
-
-Installation
-------------
-From PyPI using pip:
-
-.. code-block:: bash
-
-        pip install selectolax
-
-If installation fails due to compilation errors, you may need to install `Cython <https://github.com/cython/cython>`_:
-
-.. code-block:: bash
-
-        pip install selectolax[cython]
-
-This usually happens when you try to install an outdated version of selectolax on a newer version of Python.
-
-
-Development version from GitHub:
-
-.. code-block:: bash
-
-        git clone --recursive  https://github.com/rushter/selectolax
-        cd selectolax
-        pip install -r requirements_dev.txt
-        python setup.py install
-
-How to compile selectolax while developing:
-
-.. code-block:: bash
-
-    make clean
-    make dev
-
-Basic examples
---------------
-
-Here are some basic examples to get you started with selectolax:
-
-Parsing HTML and extracting text:
-
-.. code:: python
-
-    In [1]: from selectolax.parser import HTMLParser
-       ...:
-       ...: html = """
-       ...: <h1 id="title" data-updated="20201101">Hi there</h1>
-       ...: <div class="post">Lorem Ipsum is simply dummy text of the printing and typesetting industry. </div>
-       ...: <div class="post">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</div>
-       ...: """
-       ...: tree = HTMLParser(html)
-
-    In [2]: tree.css_first('h1#title').text()
-    Out[2]: 'Hi there'
-
-    In [3]: tree.css_first('h1#title').attributes
-    Out[3]: {'id': 'title', 'data-updated': '20201101'}
-
-    In [4]: [node.text() for node in tree.css('.post')]
-    Out[4]:
-    ['Lorem Ipsum is simply dummy text of the printing and typesetting industry. ',
-     'Lorem ipsum dolor sit amet, consectetur adipiscing elit.']
-
-Using advanced CSS selectors:
-
-.. code:: python
-
-    In [1]: html = "<div><p id=p1><p id=p2><p id=p3><a>link</a><p id=p4><p id=p5>text<p id=p6></div>"
-       ...: selector = "div > :nth-child(2n+1):not(:has(a))"
-
-    In [2]: for node in HTMLParser(html).css(selector):
-       ...:     print(node.attributes, node.text(), node.tag)
-       ...:     print(node.parent.tag)
-       ...:     print(node.html)
-       ...:
-    {'id': 'p1'}  p
-    div
-    <p id="p1"></p>
-    {'id': 'p5'} text p
-    div
-    <p id="p5">text</p>
-
-
-* `Detailed overview <https://github.com/rushter/selectolax/blob/master/examples/walkthrough.ipynb>`_
-
-Available backends
-------------------
-
-Selectolax supports two backends: ``Modest`` and ``Lexbor``. By default, all examples use the Modest backend.
-Most of the features between backends are almost identical, but there are still some differences.
-
-As of 2024, the preferred backend is ``Lexbor``. The ``Modest`` backend is still available for compatibility reasons
-and the underlying C library that selectolax uses is not maintained anymore.
-
-
-To use ``lexbor``, just import the parser and use it in the similar way to the `HTMLParser`.
-
-.. code:: python
-
-    In [1]: from selectolax.lexbor import LexborHTMLParser
-
-    In [2]: html = """
-       ...: <title>Hi there</title>
-       ...: <div id="updated">2021-08-15</div>
-       ...: """
-
-    In [3]: parser = LexborHTMLParser(html)
-    In [4]: parser.root.css_first("#updated").text()
-    Out[4]: '2021-08-15'
-
-
-Simple Benchmark
-----------------
-
-* Extract title, links, scripts and a meta tag from main pages of top 754 domains. See ``examples/benchmark.py`` for more information.
-
-============================ ===========
-Package                       Time
-============================ ===========
-Beautiful Soup (html.parser)  61.02 sec.
-lxml / Beautiful Soup (lxml)  9.09 sec.
-html5_parser                  16.10 sec.
-selectolax (Modest)           2.94 sec.
-selectolax (Lexbor)           2.39 sec.
-============================ ===========
-
-Links
------
-
-*  `selectolax API reference <https://selectolax.readthedocs.io/en/latest/index.html>`_
-*  `Video introduction to web scraping using selectolax <https://youtu.be/HpRsfpPuUzE>`_
-*  `How to Scrape 7k Products with Python using selectolax and httpx <https://www.youtube.com/watch?v=XpGvq755J2U>`_
-*  `Detailed overview <https://github.com/rushter/selectolax/blob/master/examples/walkthrough.ipynb>`_
-*  `Modest introduction <https://lexborisov.github.io/Modest/>`_
-*  `Modest benchmark <https://lexborisov.github.io/benchmark-html-parsers/>`_
-*  `Python benchmark <https://rushter.com/blog/python-fast-html-parser/>`_
-*  `Another Python benchmark <https://www.peterbe.com/plog/selectolax-or-pyquery>`_
-
-License
--------
-
-* Modest engine — `LGPL2.1 <https://github.com/lexborisov/Modest/blob/master/LICENSE>`_
-* selectolax - `MIT <https://github.com/rushter/selectolax/blob/master/LICENSE>`_

selectolax-0.3.33.dist-info/RECORD

@@ -1,26 +0,0 @@
-selectolax/__init__.py,sha256=_qbVtaupjc0xeV8F8cU3lbDgckEoaUlhy2N013uLu4Y,157
-selectolax/base.pxi,sha256=zOj3BrCA71xd-mJFtkMIAglP4ZybfrHVoCoy6ljTBDQ,93
-selectolax/lexbor.c,sha256=K806oXPqw4y4LoljPDmj7d7weW0xG58gTRQ7UR1jNU8,2418331
-selectolax/lexbor.cp311-win_amd64.pyd,sha256=QOWQAtYxtfrdPZxVqJheyPBGh5RXjE4lqs_uvTk_Qqg,3149824
-selectolax/lexbor.pxd,sha256=BcqAzhlUVq0GVWiJHWXNhs4jY-gi6k0BELEnQtSYJAI,21720
-selectolax/lexbor.pyi,sha256=6oQU-9-LE_OAhwsETmynUYhCEE3lhxnEzj36TefQheo,28586
-selectolax/lexbor.pyx,sha256=mgP31DQHkRVAOvu0Eax29sCEq57OWUA51LoPOAFZ6VU,12691
-selectolax/parser.c,sha256=PABrCk3JLEVb3nf02FtAplokuPQDSFVuuoV54MBKu1s,2258494
-selectolax/parser.cp311-win_amd64.pyd,sha256=aO22XnknHTaPZyt3AC3Anglz_H8MZ71I1bGsUfpLAlo,2107392
-selectolax/parser.pxd,sha256=T7GoQdaOkhp_W2TBlRY0tZqom97PkHrytYaXQlyVnbI,25196
-selectolax/parser.pyi,sha256=-qutpjrK1dD4rrl3SsHWQt2FT5lv6meaACkQzk1Bt6o,25612
-selectolax/parser.pyx,sha256=nIWuhaEFRwlfo64WmgrSOM0A8mUw0eWw9j_fWyLV-Ro,14127
-selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-selectolax/utils.pxi,sha256=hkzKfycdpwH1P-E_pP-9NTGsmiajt6EJNZSlkxlRapA,3623
-selectolax/lexbor/attrs.pxi,sha256=d59V77aGkpp7YsYsd6t_z4-tRnUoQTJZKsvMC8nyttM,3978
-selectolax/lexbor/node.pxi,sha256=aOH-pr0DtXOZ63YyfVVd3pppXL3mAbuugNT9HhKvoE0,33205
-selectolax/lexbor/selection.pxi,sha256=BeUDypw5_P0CTmi-ACLcd7pK2NnG9ASrwWOdLdweAZY,7378
-selectolax/lexbor/util.pxi,sha256=q2EYVNdnROg9y30mWpGwlNA0W00nJ7ZRNEEDrOEG14s,584
-selectolax/modest/node.pxi,sha256=iX_yRPIPVkG0ALW7hEfmXiVperw6RjkSGATkxzLokz0,34691
-selectolax/modest/selection.pxi,sha256=PfHUN1uuNA7YfcxTu7JZjhxevVbFRP1bHd3kyyFdO7E,6703
-selectolax/modest/util.pxi,sha256=zab67Wzo8FcipA2VS8ClptaC19lZirbNqFEGQ3hW2Is,572
-selectolax-0.3.33.dist-info/licenses/LICENSE,sha256=A7Jb3WZcENcLfZRc7QPdm9zJdwfpIyPodPJu-kdMH6E,1087
-selectolax-0.3.33.dist-info/METADATA,sha256=HmxKX5O__XxvqspHStldQCxGb22RSRndWDtpxBSntl8,6402
-selectolax-0.3.33.dist-info/WHEEL,sha256=JLOMsP7F5qtkAkINx5UnzbFguf8CqZeraV8o04b0I8I,101
-selectolax-0.3.33.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
-selectolax-0.3.33.dist-info/RECORD,,