html2json

Parsing HTML to JSON

These details have not been verified by PyPI

Project links

Project description

Convert a HTML webpage to JSON data using a template defined in JSON.

Installation

This package is available on PyPi. Just use pip install -U html2json to install it. Then you can import it using from html2json import collect.

API

The method is collect(html, template). html is the HTML of page loaded as string, and template is the JSON of template loaded as Python objects.

Note that the HTML must contain the root node, like <html>...</html> or <div>...</div>.

Template Syntax

The basic syntax is keyName: [selector, attr, [listOfRegexes]].
1. selector is a CSS selector (supported by lxml).
  - When the selector is null, the root node itself is matched.
  - When the selector cannot be matched, null is returned.
2. attr matches the attribute value. It can be null to match either the inner text or the outer text when the inner text is empty.
3. The list of regexes [listOfRegexes] supports two forms of regex operations. The operations with in the list are executed sequentially.
  - Replacement: s/regex/replacement/g. g is optional for multiple replacements.
  - Extraction: /regex/.

For example:

{
    "Color": ["head link:nth-of-type(1)", "href", ["/\\w+(?=\\.css)/"]],
}

As JSON, nested structure can be easily constructed.

{
    "Cover": {
        "URL": [".cover img", "src", []],
        "Number of Favorites": [".cover .favorites", "value", []]
    },
}

An alternative simplified syntax keyName: [subRoot, subTemplate] can be used.
1. subRoot a CSS selector of the new root for each sub entry.
2. subTemplate is a sub-template for each entry, recursively.

For example, the previous example can be simplified as follow.

{
    "Cover": [".cover", {
        "URL": ["img", "src", []],
        "Number of Favorites": [".favorites", "value", []]
    }],
}

To extract a list of sub-entries following the same sub-template, the list syntax is keyName: [[subRoot, subTemplate]]. Please note the difference (surrounding [ and ]) from the previous syntax above.
1. subRoot is the CSS selector of the new root for each sub entry.
2. subTemplate is the sub-template for each entry, recursively.

For example:

{
    "Comments": [[".comments", {
        "From": [".from", null, []],
        "Content": [".content", null, []],
        "Photos": [["img", {
            "URL": ["", "src", []]
        }]]
    }]]
}

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.2.4.1

Jul 2, 2018

0.2.4

Apr 25, 2018

0.2.3

Apr 22, 2018

0.2.2

Feb 9, 2018

0.2.1

Feb 9, 2018

0.1.1

May 27, 2017

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

html2json-0.2.4.1.tar.gz (4.0 kB view details)

Uploaded Jul 2, 2018 Source

File details

Details for the file html2json-0.2.4.1.tar.gz.

File metadata

Download URL: html2json-0.2.4.1.tar.gz
Upload date: Jul 2, 2018
Size: 4.0 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for html2json-0.2.4.1.tar.gz
Algorithm	Hash digest
SHA256	`e35ab1e7a62938c990f59933a295066f4083be4404091259d9e06d493bc79a31`
MD5	`ff4134d541b2fef9bee0fc57a214e2f4`
BLAKE2b-256	`464406f3b08dac69528c7d6c9ae5415863c26415cd916c4f0cc57e29610c1f02`