selectolax 0.3.33__cp312-cp312-macosx_11_0_arm64.whl → 0.4.0__cp312-cp312-macosx_11_0_arm64.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-0.4.0.dist-info/RECORD,,
+selectolax-0.4.0.dist-info/WHEEL,sha256=V1loQ6TpxABu1APUg0MoTRBOzSKT5xVc3skizX-ovCU,136
+selectolax-0.4.0.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
+selectolax-0.4.0.dist-info/METADATA,sha256=xFNpvUeepMxneDCjZoP5kTv4nBQccf5_wyWieI3BFnY,1287
+selectolax-0.4.0.dist-info/licenses/LICENSE,sha256=MYCcM-Cv_rC2-lQiwDumin0E-rMXAhK-qIGGA29434Y,1077
+selectolax/lexbor.pyi,sha256=MDQ4YQWcywG3oeSITWifMkCsa09MmPbyXMQq06wqwAY,30092
+selectolax/parser.pyx,sha256=sBq2_HR83Ek8yqnFBYrG2xBBCM4S6Jiiie_xq5O_twE,13684
+selectolax/__init__.py,sha256=CnY6a5BeJexKaFN_b2L28F5AVD1jPM1lFz9kfS6RC5w,148
+selectolax/lexbor.pxd,sha256=cAitQeHgGxp5Aac-o5aaOyg6_IiOpp3Rg0JNlz8Cstk,21652
+selectolax/lexbor.pyx,sha256=-QsF8Ru8DvWEEy3AIjXDdoKTG5saocX-HkTE_feS6tQ,13468
+selectolax/parser.pyi,sha256=qi9AHy_DWalANSOVTN6gbtbf-YJZCfE7i12aWJbrUp8,24929
+selectolax/utils.pxi,sha256=_g-ZLprPgbqv7BLs-WEe8IhbDd_QTcfirz_NEyR1Yww,3506
+selectolax/lexbor.cpython-312-darwin.so,sha256=CVrn2QYhMAfOUUuZOD6OLa7pfYBBMdIHKo7IHfnuOu4,3623072
+selectolax/lexbor.c,sha256=lSvE0yZPdmEMord00GqpDiLYKz8_iZriiTy3TwO86Cc,2445661
+selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+selectolax/parser.c,sha256=V2KgVlllg6gKjnW99qB4snuKg0XYpS2f2YDMsoaFLt0,2210174
+selectolax/parser.cpython-312-darwin.so,sha256=dMAbSK0KJAl1t-Mt0OQ7HakBZriAUCH3dTsItwh0OB4,2872576
+selectolax/base.pxi,sha256=eiPKlY9gG3l49qJoRQVLl1Ljza6z1k0A-met6sDPcqE,89
+selectolax/parser.pxd,sha256=BQSlDGibVfqFDhfqX6l5sBnfkHEETxlj-eSpGWERKEs,24618
+selectolax/modest/selection.pxi,sha256=m4GDpl0aI7lSWHFeBBheroUKDrZgJcc6uVubtzrXL1M,6508
+selectolax/modest/util.pxi,sha256=di9cLmAyuGFXmiuptZ7Fz1SgkCf7hmiZLnpKCKEKsUc,552
+selectolax/modest/node.pxi,sha256=l0aQf2Ojpzxh-L-0KxLetG7uGgGhkV7Cqgfy8O_5ch4,33786
+selectolax/lexbor/selection.pxi,sha256=ZJ5ed7YgxvcsOW_qPbMhUQRKgChl9cih1n1d5elfTZ8,8030
+selectolax/lexbor/util.pxi,sha256=hqMQU1O_5O82ThjUzk8NxQPl-Kg29DDGFFpC46LcejI,564
+selectolax/lexbor/node.pxi,sha256=Sj5Kx_I2vBarZRNrYhPk2TufhEYYNlV9wnSbLACyZMQ,35311
+selectolax/lexbor/node_remove.pxi,sha256=iqJ2PPNvQmK2dq8kJLXiZawoGf1Az3MpbrlQI6k4jDM,760
+selectolax/lexbor/attrs.pxi,sha256=eH90zJYHicffTzC7peIitHkOqyIw3xzomhJHxJv9hP8,3858

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/lexbor.pyi,sha256=CX_14MMiljOLZcoRVy96bEmGbqLTXTzSv12flrVzGDg,27721
-selectolax/parser.pyx,sha256=i2bCslGrqYARZvCab4mIdRFyA9k7AuvJSVjZsqrT4SM,13684
-selectolax/__init__.py,sha256=MLVYxSOb4b5Rkz6I8O35L8iUn-Z691F1THazWpmf-iw,149
-selectolax/lexbor.pxd,sha256=FTx2SphXsIHCCmEouzGSp9j2CBgrOc12Wf9E7DPIbrI,21144
-selectolax/lexbor.pyx,sha256=g_6kYxAlqCOsMoihwOuRVgyf-F-TIbgxksHYPNlNE3s,12308
-selectolax/parser.pyi,sha256=tCCAWcaeBJrhctUKpdTKVX6z4_tsxPz8D5GpbxO3Hz0,24845
-selectolax/utils.pxi,sha256=_g-ZLprPgbqv7BLs-WEe8IhbDd_QTcfirz_NEyR1Yww,3506
-selectolax/lexbor.cpython-312-darwin.so,sha256=odl7lLRIChnazm0n1uFf0u_5QiAdMdwln58w6EwlbZA,3755648
-selectolax/lexbor.c,sha256=O5VPB3zfyb-QP557RGxvP6j--S1tJX25JBEIsdgV8cg,2364654
-selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-selectolax/parser.c,sha256=SMGGm8vfvCFgwdxab4GgZwZYJguoEsFY3BhHtuFCCT4,2208079
-selectolax/parser.cpython-312-darwin.so,sha256=XKrY-z0BAWNNqDwyPTP0261kwsf8TRt8UnD2OPMxyJk,3066656
-selectolax/base.pxi,sha256=eiPKlY9gG3l49qJoRQVLl1Ljza6z1k0A-met6sDPcqE,89
-selectolax/parser.pxd,sha256=BQSlDGibVfqFDhfqX6l5sBnfkHEETxlj-eSpGWERKEs,24618
-selectolax/modest/selection.pxi,sha256=m4GDpl0aI7lSWHFeBBheroUKDrZgJcc6uVubtzrXL1M,6508
-selectolax/modest/util.pxi,sha256=di9cLmAyuGFXmiuptZ7Fz1SgkCf7hmiZLnpKCKEKsUc,552
-selectolax/modest/node.pxi,sha256=9D-o4Kdd-e_ebc-z8eAVxlVDdmfN5g2fUn6rj4sUSxg,33703
-selectolax/lexbor/selection.pxi,sha256=aYna6zEH9vBGxtcYe8AdOGseEh4ieymFt3Zu4cQssTs,7185
-selectolax/lexbor/util.pxi,sha256=hqMQU1O_5O82ThjUzk8NxQPl-Kg29DDGFFpC46LcejI,564
-selectolax/lexbor/node.pxi,sha256=1lpb3t-lGSeGMBkCT3a0IML-MonNJzTKDgiOWPfPpbA,32271
-selectolax/lexbor/attrs.pxi,sha256=eH90zJYHicffTzC7peIitHkOqyIw3xzomhJHxJv9hP8,3858
-selectolax-0.3.33.dist-info/RECORD,,
-selectolax-0.3.33.dist-info/WHEEL,sha256=V1loQ6TpxABu1APUg0MoTRBOzSKT5xVc3skizX-ovCU,136
-selectolax-0.3.33.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
-selectolax-0.3.33.dist-info/METADATA,sha256=sQZmiyZ9oiWmyUNzYHd_cnkmVPjk7cK8ef0Wyyf7h_A,6215
-selectolax-0.3.33.dist-info/licenses/LICENSE,sha256=MYCcM-Cv_rC2-lQiwDumin0E-rMXAhK-qIGGA29434Y,1077