aspose-html-net 26.1.0
Aspose.HTML for Python via .NET is a powerful API for Python that provides a headless browser functionality, allowing you to work with HTML documents in a variety of ways. With this API, you can easily create new HTML documents or open existing ones from different sources. Once you have the document, you can perform various manipulation operations, such as removing and replacing HTML nodes.
Requires Python: <3.14,>=3.5
Keywords: Aspose, Aspose.HTML, Aspose.Total, Python, Component, Conholdate, Conholdate.Total, convert, converter, vectorization, vectorizer, vectorize, encoding, base64, css, DOM, dom-manipulation, image, JPEG, Library, Microsoft, mvc, net-standard, netcore, netstandard, to PDF, PNG, rotate, security, Standard, XPath, XPS, SVG, Windows, Vector Graphics, line, Bezier Curves, Cubic, Glyphs, Paths, Text, Scaling, Rotation, Skewing, Fill, Dots, Bitmap, HTML, HTML-to-Image, HTML-to-PDF, HTML-to-XPS, HTML-to-DOCX, HTML-to-MHTML, HTML-to-Markdown, HTML-to-MD, EPUB-to-Image, EPUB-to-PDF, EPUB-to-XPS, Markdown-to-HTML, MD-to-HTML, HTML-Template, HTML-Converter, HTML-Renderer, SVG-Renderer, MHTML-Renderer, EPUB-Renderer, HTML5, HTML5-Canvas, HTML-DOM, HTML-Form-Editor, HTML, XHTML, MHTML, EPUB, SVG, MD, Markdown, DOCX, PDF, XPS, TIFF, JPEG, JPG, PNG, BMP, GIF, WEBP, eBook-API, Headless-Browser, Document-Manipulation, Web-Scraping, Conversion, Crawler, Hypertext, Markup, XPath, Spider, CSS, CSS3, Converter, DOM, Convert, Azure, parse, render, image, graphics, to HTML-code, XHTML-to-PDF, MHTML-to-PDF, HTML-to-GIF, MHTML-to-JPG

# Process & Manipulate HTML via Python API

<!--- banner links to [Temporary License](https://purchase.aspose.com/temporary-license) -->
[![banner](https://products.aspose.com/html/images/aspose_html-for-python-banner-TL.png)](https://purchase.aspose.com/temporary-license)

[Product Page](https://products.aspose.com/html/python-net/) | [Docs](https://docs.aspose.com/html/python-net/) | [Demos](https://products.aspose.app/html/applications) | [API Reference](https://reference.aspose.com/html/python-net/) | [Examples](https://github.com/aspose-html/Aspose.HTML-for-Python-via-.NET) | [Blog](https://blog.aspose.com/categories/aspose.html-product-family/) | [Search](https://search.aspose.com/) | [Free Support](https://forum.aspose.com/c/html/29)

[Aspose.HTML for Python via .NET](https://products.aspose.com/html/python-net/) is a powerful API for Python that provides headless browser functionality, allowing you to work with HTML documents. With this API, you can easily create new HTML documents or open existing ones from different sources. Once you have the document, you can perform various manipulation operations, such as removing and replacing HTML nodes, rendering, and converting HTML to other popular formats, etc.

## HTML API Features

The following are some popular features of Aspose.HTML for Python via .NET:

### General Features

- **Create, Load, and Read Documents.** Create, load, and modify HTML, XHTML, Markdown, or SVG documents with full control over elements, attributes, and structure using a powerful DOM-based API.
- **Load EPUB and MHTML file Formats.** Open, read, and convert EPUB and MHTML documents with full support for their internal structure and linked resources.
- **Edit Documents.** Insert, remove, clone, or replace HTML elements at any level of the DOM tree for granular control over content.
- **Save HTML Documents.** Save documents along with all linked resources like CSS, fonts, and images using customizable saving options.
- **Navigate HTML.** Navigate through documents using either NodeIterator or TreeWalker.
- **Sandboxing.** Configure a Sandbox environment that is independent of the execution machine, ensuring a secure and isolated environment for running and testing.

### Data Extraction

- **DOM Traversal.** Navigate and manipulate the DOM tree using W3C-compliant traversal interfaces to inspect and retrieve content from HTML documents.
- **XPath Queries.** Perform high-performance XPath queries to find and extract target content from large HTML documents.
- **CSS Selector and JavaScript.** Use CSS selector queries and JavaScript execution to dynamically locate and extract specific elements.
- **Extract CSS Styling Information.** Retrieve and analyze inline styles, embedded `<style>` blocks, and external stylesheets within HTML documents.
- **Extract any Data from HTML Documents.** Text, attributes, form values, metadata, tables, links, or media elements: Aspose.HTML for Python via .NET enables the accurate and efficient extraction of any content for processing, analysis, or editing.

### Conversion and Rendering

- **Convert Documents.** Convert HTML, XHTML, SVG, MHTML, MD, and EPUB files to a wide range of formats, including PDF, XPS, DOCX, and different image formats (PNG, JPEG, BMP, TIFF, and GIF).
- **Custom Conversion Settings.** Adjust page size, resolution, stylesheets, resource management, script execution, and other settings during conversion to fine-tune the output.
- **Markdown Support.** Convert HTML to Markdown or vice versa for content migration and Markdown-based workflows.
- **Timeout Control.** Set and control the timeout for the rendering process.

### Advanced HTML Features

- **Monitor DOM Changes.** Use MutationObserver to monitor DOM modifications.
- **HTML Templates.** Populate HTML documents with external data sources such as XML and JSON.
- **Output Streams.** Support for both single (PDF, XPS) and multiple (image formats) output file streams.
- **Check Web Accessibility.** Check web documents against WCAG standards using built-in validators and accessibility rule sets.

## Supported File Formats

|**Format**|**Description**|**Load**|**Save**|
| :- | :- | :- | :- |
|[HTML ](https://docs.fileformat.com/web/html/)|HyperText Markup Language format|✔️|✔️|
|[XHTML ](https://docs.fileformat.com/web/xhtml/)|eXtensible HyperText Markup Language format|✔️|✔️|
|[MHTML ](https://docs.fileformat.com/web/mhtml/)|MIME HTML format|✔️|✔️|
|[EPUB ](https://docs.fileformat.com/ebook/epub/)|E-book file format|✔️| |
|[SVG ](https://docs.fileformat.com/page-description-language/svg/)|Scalable Vector Graphics format|✔️|✔️|
|[MD ](https://docs.fileformat.com/word-processing/md/)|Markdown markup language format|✔️|✔️|
|[PDF ](https://docs.fileformat.com/pdf/)|Portable Document Format| |✔️|
|[XPS ](https://docs.fileformat.com/page-description-language/xps/)|XML Paper Specification format| |✔️|
|[DOCX](https://docs.fileformat.com/word-processing/docx/) |Microsoft Word Open XML document format| |✔️|
|[TIFF ](https://docs.fileformat.com/image/tiff/)|Tagged Image File Format| |✔️|
|[JPEG ](https://docs.fileformat.com/image/jpeg/)|Joint Photographic Experts Group format| |✔️|
|[PNG ](https://docs.fileformat.com/image/png/)|Portable Network Graphics format| |✔️|
|[BMP ](https://docs.fileformat.com/image/bmp/)|Bitmap Picture format| |✔️|
|[GIF ](https://docs.fileformat.com/image/gif/)|Graphics Interchange Format| |✔️|
|[WEBP ](https://docs.fileformat.com/image/webp/)|Modern image format providing both lossy and lossless compression| |✔️|

## Platform Independence

Aspose.HTML for Python via .NET can be used to develop applications for a vast range of operating systems, such as Windows, where Python 3.5 or later is installed. You can build both 32-bit and 64-bit Python applications.

## Get Started

Are you ready to give Aspose.HTML for Python via .NET a try?

Simply run ```pip install aspose-html-net``` from the Console to fetch the package.
If you already have Aspose.HTML for Python via .NET and want to upgrade the version, please run ```pip install --upgrade aspose-html-net``` to get the latest version.

You can run the following snippets in your environment to see how Aspose.HTML works, or check out the [GitHub Repository](https://github.com/aspose-html/) or [Aspose.HTML for Python via .NET Documentation](https://docs.aspose.com/html/python-net/) for other common use cases.

## Create a New HTML Document

If you want to create an HTML document programmatically from scratch, use the parameterless constructor:

```python
import aspose.html as ah

# Initialize an empty HTML document
with ah.HTMLDocument() as document:
    # Create a text node and add it to the document
    text = document.create_text_node("Hello, World!")
    document.body.append_child(text)

    # Save the document to a file
    document.save("create-new-document.html")
```
Source - [Create a Document in Python](https://docs.aspose.com/html/python-net/create-a-document/)

## Extract Images from Website

Here is an example of how to use Aspose.HTML for Python via .NET to find images specified by the `<img>` element:

```python
import os
import aspose.html as ah
import aspose.html.net as ahnet

# Prepare output directory
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

# Open HTML document from URL
with ah.HTMLDocument("https://docs.aspose.com/svg/net/drawing-basics/svg-color/") as doc:
    # Collect all <img> elements
    images = doc.get_elements_by_tag_name("img")

    # Get distinct relative image URLs
    urls = set(img.get_attribute("src") for img in images)

    # Create absolute image URLs
    abs_urls = [ah.Url(url, doc.base_uri) for url in urls]

    for url in abs_urls:
        # Create a network request
        request = ahnet.RequestMessage(url)

        # Send request
        response = doc.context.network.send(request)

        # Check whether a response is successful
        if response.is_success:
            # Parse the URL to get the file name
            file_name = os.path.basename(url.pathname)

            # Save image to the local file system
            with open(os.path.join(output_dir, file_name), "wb") as f:
                f.write(response.content.read_as_byte_array())
```
Source - [Extract Images From Website in Python](https://docs.aspose.com/html/python-net/extract-images-from-website/)

## HTML to PDF in one line of code

Aspose.HTML for Python via .NET allows you to convert HTML to PDF, XPS, Markdown, MHTML, PNG, JPEG, and other file formats. The following snippet demonstrates the conversion from HTML to PDF literally with a single line of code!

```python
import aspose.html.converters as conv
import aspose.html.saving as sav

# Convert HTML to PDF
conv.Converter.convert_html("document.html", sav.PdfSaveOptions(), "document.pdf")
```
Source - [Convert HTML to PDF in Python](https://docs.aspose.com/html/python-net/convert-html-to-pdf/)

## Convert HTML to Markdown (MD)

The following snippet demonstrates the conversion from HTML to GIT-based Markdown (MD) Format:

```python
import aspose.html.converters as conv
import aspose.html.saving as sav

# Prepare HTML code and save it to a file
code = "<h1>Header 1</h1>" \
         "<h2>Header 2</h2>" \
         "<p>Hello, World!!</p>"
with open("document.html", "w", encoding="utf-8") as f:
         f.write(code)
         f.close()
         # Call the convert_html() method to convert HTML to Markdown
         conv.Converter.convert_html("document.html", sav.MarkdownSaveOptions.git, "output.md")
```
Source - [Creating an HTML Document](https://docs.aspose.com/html/net/creating-a-document/)

## Convert EPUB to PDF using SaveOptions

The PdfSaveOptions class provides numerous properties that give you full control over a wide range of parameters and improve the process of converting EPUB to PDF format. In the example, we use the `page_setup`, `jpeg_quality`, and `css.media_type` properties:

```python
import os
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.drawing as dr

# Setup directories and define paths
output_dir = "output/"
input_dir = "data/"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(input_dir, "input.epub")
save_path = os.path.join(output_dir, "epub-to-pdf.pdf")

# Open an existing EPUB file for reading
with open(document_path, "rb") as stream:

    # Create an instance of PdfSaveOptions
    options = sav.PdfSaveOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 600), dr.Margin(10, 10, 10, 10))
    options.css.media_type.PRINT

    # Convert EPUB to PDF
    conv.Converter.convert_epub(stream, options, save_path)
```
Source - [Convert EPUB to PDF in Python](https://docs.aspose.com/html/python-net/convert-epub-to-pdf/)

[Product Page](https://products.aspose.com/html/python-net/) | [Docs](https://docs.aspose.com/html/python-net/) | [Demos](https://products.aspose.app/html/applications) | [API Reference](https://reference.aspose.com/html/python-net/) | [Examples](https://github.com/aspose-html/Aspose.HTML-for-Python-via-.NET) | [Blog](https://blog.aspose.com/categories/aspose.html-product-family/) | [Search](https://search.aspose.com/) | [Free Support](https://forum.aspose.com/c/html/29) | [Temporary License](https://purchase.aspose.com/temporary-license)