mirror of
https://github.com/frappe/frappe_docker.git
synced 2026-06-21 07:15:09 +00:00
113 lines
5 KiB
Text
Executable file
113 lines
5 KiB
Text
Executable file
Metadata-Version: 1.1
|
|
Name: html2text
|
|
Version: 2016.9.19
|
|
Summary: Turn HTML into equivalent Markdown-structured text.
|
|
Home-page: https://github.com/Alir3z4/html2text/
|
|
Author: Alireza Savand
|
|
Author-email: alireza.savand@gmail.com
|
|
License: GNU GPL 3
|
|
Description: # html2text
|
|
|
|
[](http://travis-ci.org/Alir3z4/html2text)
|
|
[](https://coveralls.io/r/Alir3z4/html2text)
|
|
[](https://pypi.python.org/pypi/html2text/)
|
|
[](https://pypi.python.org/pypi/html2text/)
|
|
[](https://pypi.python.org/pypi/html2text/)
|
|
[](https://pypi.python.org/pypi/html2text/)
|
|
[](https://pypi.python.org/pypi/html2text/)
|
|
|
|
|
|
html2text is a Python script that converts a page of HTML into clean, easy-to-read plain ASCII text. Better yet, that ASCII also happens to be valid Markdown (a text-to-HTML format).
|
|
|
|
|
|
Usage: `html2text [(filename|url) [encoding]]`
|
|
|
|
| Option | Description
|
|
|--------------------------------------------------------|---------------------------------------------------
|
|
| `--version` | Show program's version number and exit
|
|
| `-h`, `--help` | Show this help message and exit
|
|
| `--ignore-links` | Don't include any formatting for links
|
|
|`--escape-all` | Escape all special characters. Output is less readable, but avoids corner case formatting issues.
|
|
| `--reference-links` | Use reference links instead of links to create markdown
|
|
| `--mark-code` | Mark preformatted and code blocks with [code]...[/code]
|
|
|
|
For a complete list of options see the [docs](https://github.com/Alir3z4/html2text/blob/master/docs/usage.md)
|
|
|
|
|
|
Or you can use it from within `Python`:
|
|
|
|
```
|
|
>>> import html2text
|
|
>>>
|
|
>>> print(html2text.html2text("<p><strong>Zed's</strong> dead baby, <em>Zed's</em> dead.</p>"))
|
|
**Zed's** dead baby, _Zed's_ dead.
|
|
|
|
```
|
|
|
|
|
|
Or with some configuration options:
|
|
```
|
|
>>> import html2text
|
|
>>>
|
|
>>> h = html2text.HTML2Text()
|
|
>>> # Ignore converting links from HTML
|
|
>>> h.ignore_links = True
|
|
>>> print h.handle("<p>Hello, <a href='http://earth.google.com/'>world</a>!")
|
|
Hello, world!
|
|
|
|
>>> print(h.handle("<p>Hello, <a href='http://earth.google.com/'>world</a>!"))
|
|
|
|
Hello, world!
|
|
|
|
>>> # Don't Ignore links anymore, I like links
|
|
>>> h.ignore_links = False
|
|
>>> print(h.handle("<p>Hello, <a href='http://earth.google.com/'>world</a>!"))
|
|
Hello, [world](http://earth.google.com/)!
|
|
|
|
```
|
|
|
|
*Originally written by Aaron Swartz. This code is distributed under the GPLv3.*
|
|
|
|
|
|
## How to install
|
|
|
|
`html2text` is available on pypi
|
|
https://pypi.python.org/pypi/html2text
|
|
|
|
```
|
|
$ pip install html2text
|
|
```
|
|
|
|
|
|
## How to run unit tests
|
|
|
|
PYTHONPATH=$PYTHONPATH:. coverage run --source=html2text setup.py test -v
|
|
|
|
To see the coverage results:
|
|
|
|
coverage combine
|
|
coverage html
|
|
|
|
then open the `./htmlcov/index.html` file in your browser.
|
|
|
|
## Documentation
|
|
|
|
Documentation lives [here](https://github.com/Alir3z4/html2text/blob/master/docs/usage.md)
|
|
|
|
Platform: OS Independent
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
|
|
Classifier: Operating System :: OS Independent
|
|
Classifier: Programming Language :: Python
|
|
Classifier: Programming Language :: Python :: 2
|
|
Classifier: Programming Language :: Python :: 2.4
|
|
Classifier: Programming Language :: Python :: 2.5
|
|
Classifier: Programming Language :: Python :: 2.6
|
|
Classifier: Programming Language :: Python :: 2.7
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.0
|
|
Classifier: Programming Language :: Python :: 3.2
|
|
Classifier: Programming Language :: Python :: 3.3
|
|
Classifier: Programming Language :: Python :: 3.4
|
|
Classifier: Programming Language :: Python :: 3.5
|