pyhtml2text 0.2.0__cp310-abi3-win_amd64.whl

pyhtml2text/__init__.py

@@ -0,0 +1,3 @@
+from ._pyhtml2text import html2text
+
+__all__ = ["html2text"]

pyhtml2text/__init__.pyi

@@ -0,0 +1,12 @@
+def html2text(
+    html: str | bytes,
+    width: int = 80,
+    *,
+    base_url: str | None = None,
+    decorate: bool = True,
+    link_footnotes: bool = True,
+    table_borders: bool = True,
+    wrap_links: bool = True,
+    max_wrap_width: int | None = None,
+    raw: bool = False,
+) -> str: ...

pyhtml2text-0.2.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: pyhtml2text
+Version: 0.2.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Processing :: Markup :: HTML
+License-File: LICENSE
+Summary: Fast HTML to plain text, with relative link resolution (Python bindings to rust-html2text)
+Keywords: html,text,markdown,html2text
+Author-email: Jared Lynskey <jared@lynskey.co.nz>
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Source, https://github.com/jaredlynskey/pyhtml2text
+Project-URL: Upstream, https://github.com/jugglerchris/rust-html2text
+
+# pyhtml2text
+
+Fast HTML to plain text for Python, built on
+[rust-html2text](https://github.com/jugglerchris/rust-html2text).
+
+It adds one thing the upstream crate doesn't have yet: relative links can be
+resolved against the page's URL, so footnote links are usable on their own.
+
+```python
+from pyhtml2text import html2text
+
+html = '<p>Please <a href="/login">sign in</a> first.</p>'
+
+print(html2text(html, base_url="https://example.com/docs/page.html"))
+# Please [sign in][1] first.
+#
+# [1]: https://example.com/login
+```
+
+`html` can be a `str` or UTF-8 `bytes` (e.g. `response.content`). Requires
+Python 3.10 or later.
+
+## Options
+
+`html2text(html, width=80, *, ...)`
+
+| option | default | |
+|---|---|---|
+| `base_url` | `None` | resolve relative `href`s against this URL (RFC 3986). Absolute and `mailto:` etc. links are left alone |
+| `decorate` | `True` | markdown-ish `*em*`, `**strong**`, `` `code` `` |
+| `link_footnotes` | `True` | list link targets as `[1]: ...` footnotes |
+| `table_borders` | `True` | draw table borders |
+| `wrap_links` | `True` | allow long links to wrap |
+| `max_wrap_width` | `None` | wrap paragraphs narrower than `width` |
+| `raw` | `False` | flatten tables so cell text stays together |
+
+## Performance
+
+Median time to render a page, on an Apple Silicon Mac:
+
+| | Wikipedia article (780 KB) | BBC News front page (370 KB) |
+|---|---|---|
+| [html2text](https://pypi.org/project/html2text/) (pure Python) | 71.5 ms | 14.9 ms |
+| [html2text-rs](https://pypi.org/project/html2text-rs/) | 15.2 ms | 2.5 ms |
+| **pyhtml2text** | **10.9 ms** | **1.6 ms** |
+
+- The GIL is released while rendering, so threads scale across cores. On
+  free-threaded Python (3.14t) the module runs without re-enabling the GIL.
+- Wheels for Linux (x86_64, aarch64), macOS and Windows x64 are built with
+  profile-guided optimisation, which makes them about 25% faster. Other
+  platforms get the same code without it.
+- Deeply nested HTML is parsed in linear time, so hostile input can't stall a
+  worker: 40,000 nested lists take 0.14 s, against 6 s with stock html5ever.
+
+## Credits
+
+The rendering is done by rust-html2text by Chris Emerson (MIT). This package
+uses [a fork](https://github.com/jaredlynskey/rust-html2text/tree/pyhtml2text-perf)
+that adds `base_url` and some performance changes, and a patched copy of
+[html5ever](https://github.com/servo/html5ever) (MIT/Apache-2.0, see
+`vendor/`). It isn't affiliated with or endorsed by either upstream project, so
+please report issues here rather than upstream.
+

pyhtml2text-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pyhtml2text/__init__.py,sha256=SNSvBk7XadgoTer_FNl-CpVj35EwpSH562UvJnpQl0c,64
+pyhtml2text/__init__.pyi,sha256=TUzQPItlH84t-6PIk44zbUW1sfd9T4Co103pFBWTNEY,308
+pyhtml2text/_pyhtml2text.pyd,sha256=SJnLg5F_WlNNHQZFgelhTNOzaU1_2JqYfbnt2fn17XA,1852416
+pyhtml2text/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyhtml2text-0.2.0.dist-info/METADATA,sha256=6nHBs1WRXV6fpsDP6AtDam-DmSly_LwOBiw0emgWNO0,3250
+pyhtml2text-0.2.0.dist-info/WHEEL,sha256=7HL-TGvq44Ofp0yhZL-uRIIFHcJTIqqkRZVQ2wZidzM,96
+pyhtml2text-0.2.0.dist-info/licenses/LICENSE,sha256=dw7sNXB8KgHIYo1ow4R6gT935LhuObKKM__zMT7c_7g,1170
+pyhtml2text-0.2.0.dist-info/sboms/pyhtml2text.cyclonedx.json,sha256=TqvE4naeiNriSVPXfWGq-BPXZMxTBx-dD1KwDquc8Vk,58848
+pyhtml2text-0.2.0.dist-info/RECORD,,

pyhtml2text-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.15.0)
+Root-Is-Purelib: false
+Tag: cp310-abi3-win_amd64

pyhtml2text-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Jared Lynskey
+Copyright (c) 2016 Chris Emerson (rust-html2text, which this package embeds)
+
+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.