dompa 0.3.0

A HTML5 parser.

Dompa

A work-in-progress HTML5 document parser. It takes an input of an HTML string, parses it into a node tree, and provides an API that aims to be Web APIs compatible to modify said node tree.

Install

pip install dompa

Usage

The most basic usage looks like this:

from dompa import Dompa

dom = Dompa("<div>Hello, World</div>")

# Get the tree of nodes
nodes = dom.nodes()

# Get the HTML string
html = dom.html()

DOM manipulation

You can run queries on the node tree to get or manipulate node(s).

find

You can find nodes with the find method which takes a Callable that gets Node passed to it and that has to return
a boolean true or false, like so:

from dompa import Dompa

dom = Dompa("<h1>Site Title</h1><ul><li>...</li><li>...</li></ul>")
list_items = dom.find(lambda n: n.name == "li")

update

You can update nodes with the update method which takes a Callable, like so:

from dompa import Dompa
from dompa.nodes import Node, TextNode

dom = Dompa("<h1>Site Title</h1><ul><li>...</li><li>...</li></ul>")

def update_title(item: Node) -> None:
    if item.name == "h1":
        item.children = [TextNode(value="New Title")]

dom.update(update_title)

remove

Not implemented yet.

add_before

Not implemented yet.

add_after

Not implemented yet.