selectolax 0.4.4__cp310-cp310-macosx_10_9_x86_64.whl

selectolax-0.4.4.dist-info/METADATA

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: selectolax
+Version: 0.4.4
+Summary: A fast HTML5 parser with CSS selectors, written in Cython, using Modest and Lexbor engines.
+Home-page: https://github.com/rushter/selectolax
+Author: Artem Golubin
+Author-email: Artem Golubin <me@rushter.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rushter/selectolax
+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,lexbor,modest
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Internet
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: cython
+Requires-Dist: Cython; extra == "cython"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+
+![selectolax logo](docs/logo.png)
+
+---
+
+A fast HTML5 parser with CSS selectors, written in Cython,
+using [Modest](https://github.com/lexborisov/Modest/) and [Lexbor](https://github.com/lexbor/lexbor) engines.
+
+---
+
+[![PyPI - Version](https://img.shields.io/pypi/v/selectolax?logo=pypi&label=Pypi&logoColor=fff)](https://pypi.org/project/selectolax)
+[![PyPI Total Downloads](https://static.pepy.tech/badge/selectolax)](https://pepy.tech/projects/selectolax)
+[![CI](https://img.shields.io/github/actions/workflow/status/rushter/selectolax/pythonpackage.yml?branch=master&logo=githubactions&label=CI)](https://github.com/rushter/selectolax/actions/workflows/pythonpackage.yml?query=branch%3Amaster+event%3Apush)
+[![Python Versions](https://img.shields.io/pypi/pyversions/selectolax?logo=python&logoColor=fff&label=Python)](https://pypi.org/project/selectolax)
+[![GitHub License](https://img.shields.io/github/license/rushter/selectolax?logo=github&label=License)](https://github.com/rushter/selectolax/blob/master/LICENSE)
+
+---
+
+## Installation
+
+From PyPI using pip:
+
+```bash
+pip install selectolax
+```
+
+If installation fails due to compilation errors, you may need to install [Cython](https://github.com/cython/cython):
+
+```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:
+
+```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:
+
+```bash
+make clean
+make dev
+```
+
+## Basic examples
+
+Here are some basic examples to get you started with selectolax:
+
+Parsing HTML and extracting text:
+
+```python
+In [1]: from selectolax.lexbor import LexborHTMLParser
+   ...:
+   ...: 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 = LexborHTMLParser(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
+
+```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 LexborHTMLParser(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>
+```
+
+#### Using `lexbor-contains` CSS pseudo-class to match text
+
+```python
+from selectolax.lexbor import LexborHTMLParser
+html = "<div><p>hello </p><p id='main'>lexbor is AwesOme</p></div>"
+parser = LexborHTMLParser(html)
+# Case-insensitive search
+results = parser.css('p:lexbor-contains("awesome" i)')
+# Case-sensitive search
+results = parser.css('p:lexbor-contains("AwesOme")')
+assert len(results) == 1
+assert results[0].text() == "lexbor is AwesOme"
+```
+
+* [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 `Lexbor` backend.
+Most of the features between backends are almost identical, but there are 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`.
+
+```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 and examples](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)
+* [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)
+* [Universal interface to lxml and selectolax](https://github.com/lorien/domselect)
+
+## License
+
+* Modest engine — [LGPL2.1](https://github.com/lexborisov/Modest/blob/master/LICENSE)
+* lexbor engine — [Apache-2.0 license](https://github.com/lexbor/lexbor?tab=Apache-2.0-1-ov-file#readme)
+* selectolax - [MIT](https://github.com/rushter/selectolax/blob/master/LICENSE)
+
+
+## Contributors
+
+Thanks to all the contributors of selectolax!
+
+<a href="https://github.com/rushter/selectolax/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=rushter/selectolax" />
+</a>

selectolax-0.4.4.dist-info/RECORD

@@ -0,0 +1,27 @@
+selectolax/lexbor.pyi,sha256=ALFNgAsS60DN_Eh4y1EJQB7TLmxaa-Q18MQ_Y134lxg,36763
+selectolax/parser.pyx,sha256=sBq2_HR83Ek8yqnFBYrG2xBBCM4S6Jiiie_xq5O_twE,13684
+selectolax/lexbor.cpython-310-darwin.so,sha256=zXA4dcDNXkD4WlgHXEAvW5IiTsSHYjeg_9fB5enCiS0,3560000
+selectolax/__init__.py,sha256=x6GncNA8EpAckyboq-AmhTOlZZOUD7UDXq5JWMbdme4,148
+selectolax/parser.cpython-310-darwin.so,sha256=N0jRpBJ3LZ83Vte4Lmn2k-Amtesi3vORFZU3V-mELj8,2774528
+selectolax/lexbor.pxd,sha256=5vgq_RgBhemsjimZVTi9PvSfkuymB3Nib-I7CKDxfS8,22751
+selectolax/lexbor.pyx,sha256=hoHzlzDKkIk7KUvgro6YysP4N58gr-3qP7O1JXcrivs,21050
+selectolax/parser.pyi,sha256=qi9AHy_DWalANSOVTN6gbtbf-YJZCfE7i12aWJbrUp8,24929
+selectolax/utils.pxi,sha256=_g-ZLprPgbqv7BLs-WEe8IhbDd_QTcfirz_NEyR1Yww,3506
+selectolax/lexbor.c,sha256=iQUCHWpDkL3ybRtXPJ9kLblo9TsEOhAfDBQeo-RgBuI,2414163
+selectolax/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+selectolax/parser.c,sha256=oLAQzCSitN-sH1YFi9i0r50LMhHZsyyI8CuVd2ptXvg,2116069
+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=0zkJDakyOQtkBSUPhpfC_a_bxdbgU1qsE6_6sPTT2Ow,8036
+selectolax/lexbor/util.pxi,sha256=hqMQU1O_5O82ThjUzk8NxQPl-Kg29DDGFFpC46LcejI,564
+selectolax/lexbor/node.pxi,sha256=YqFgg-OGBgGuImKrHxapTGYiyIpxjpmGvi9vyEV3ee0,38762
+selectolax/lexbor/node_remove.pxi,sha256=iqJ2PPNvQmK2dq8kJLXiZawoGf1Az3MpbrlQI6k4jDM,760
+selectolax/lexbor/attrs.pxi,sha256=eH90zJYHicffTzC7peIitHkOqyIw3xzomhJHxJv9hP8,3858
+selectolax-0.4.4.dist-info/RECORD,,
+selectolax-0.4.4.dist-info/WHEEL,sha256=aNQV8Up4rZuRmZ4dQF1gRf2_E64p7eyxNGuFzXK-F6k,137
+selectolax-0.4.4.dist-info/top_level.txt,sha256=e5MuEM2PrQzoDlWetkFli9uXSlxa_ktW5jJEihhaI1c,11
+selectolax-0.4.4.dist-info/METADATA,sha256=Ef_YMdqD91XWYpFxVkHtgcagOgJwGRFrIDXY3wC0oXo,8192
+selectolax-0.4.4.dist-info/licenses/LICENSE,sha256=MYCcM-Cv_rC2-lQiwDumin0E-rMXAhK-qIGGA29434Y,1077

selectolax-0.4.4.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-macosx_10_9_x86_64
+Generator: delocate 0.13.0
+

selectolax-0.4.4.dist-info/licenses/LICENSE

@@ -0,0 +1,10 @@
+
+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.

selectolax-0.4.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+selectolax