Exemplos de instruções de parsing

Veja exemplos práticos de instruções de parsing para o Custom Parser: lide com objetos aninhados, listas, erros e arrays de arrays.

O trecho HTML a seguir é analisado usando instruções de parsing de exemplo nas próximas seções.

HTML de exemplo

<body>
    <div id="products">
        <div class="product" id="shoes">
            <div class="title">Shoes</div>
            <div class="price">223.12</div>
            <div class="description">
                <ul>
                    <li class="description-item">Super</li>
                </ul>
            </div>
        </div>
        <div class="product" id="pants">
            <div class="title">Pants</div>
            <div class="price">60.12</div>
            <div class="description">
                <ul>
                    <li class="description-item">Amazing</li>
                    <li class="description-item">Quality</li>
                </ul>
            </div>
        </div>
        <div class="product" id="socks">
            <div class="title">Meias</div>
            <div class="price">123.12</div>
            <div class="description">
                <ul>
                    <li class="description-item">Muito</li>
                    <li class="description-item">Bom</li>
                    <li class="description-item">Meias</li>
                </ul>
            </div>
        </div>
    </div>
</body>

Mínimo necessário

Caso de uso: você quer extrair o texto de todos os shoes description items.

Exemplo 1. Seleção de itens de descrição de shoes usando XPath.

{
    "shoes_description": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": [
                    ".//div[@id='shoes']//li[@class='description-item']/text()"
                ]
            }
        ]
    }
}

O xpath a função encontrará um único item e o colocará em uma lista como uma string:

{
    "shoes_description": [
        "Super"
    ]
}

O exato xpath comportamento da função é descrito aqui.

Instruções de parsing aninhadas

Caso de uso: você quer analisar todas as informações relacionadas a shoes. Além disso, o resultado analisado deve representar a estrutura do documento do HTML fornecido.

Você está segmentando esta parte do HTML de exemplo:

<div class="product" id="shoes">
    <div class="title">Shoes</div>
    <div class="price">223.12</div>
    <div class="description">
        <ul>
            <li class="description-item">Super</li>
        </ul>
    </div>
</div>

E você gostaria que o resultado analisado tivesse a seguinte estrutura:

{
    "shoes": {
        "title": "Shoes",
        "price": "223.12",
        "description": [
            "Super"
        ]
    }
}

As instruções de parsing ficariam da seguinte forma.

Exemplo 2. Instruções de parsing são usadas para analisar shoes informações.

{
    "shoes": {
        "title": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@id='shoes']/div[@class='title']/text()"]
                }
            ]
        },
        "price": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@id='shoes']/div[@class='price']/text()"]
                }
            ]
        },
        "description": {
            "_fns": [
                {
                    "_fn": "xpath",
                    "_args": ["//div[@id='shoes']//li[@class='description-item']/text()"]
                }
            ]
        }
    }
}

xpath_one funciona de forma semelhante a xpath, mas em vez de retornar uma lista de todas as correspondências, ela retorna o primeiro item correspondente.

No exemplo acima, o shoes propriedade é a única propriedade definida no escopo das instruções mais externas. A shoes propriedade contém instruções de parsing aninhadas.

O shoes o escopo de instruções não tem um pipeline definido (_fns propriedade está ausente). Isso significa que pipelines definidos em title, preço, e description escopos usarão o documento-sobre-análise como entrada do pipeline.

No Exemplo 2, você pode ver uma repetição de //div[@id='shoes'] em expressões XPath. A repetição pode ser evitada definindo um pipeline no shoes escopo:

Exemplo 3. Definindo um pipeline no shoes escopo das instruções para evitar repetição de expressões XPath.

{
    "shoes": {
        "_fns": [
            {
                "_fn": "xpath_one",
                "_args": ["//div[@id='shoes']"]
            }
        ],
        "title": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["./div[@class='title']/text()"]
                }
            ]
        },
        "price": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["./div[@class='price']/text()"]
                }
            ]
        },
        "description": {
            "_fns": [
                {
                    "_fn": "xpath",
                    "_args": [".//li[@class='description-item']/text()"]
                }
            ]
        }
    }
}

Usando as instruções de parsing fornecidas no Exemplo 3, o Custom Parser irá:

Começar processando shoes._fns pipeline, que irá produzir o shoes elemento HTML;
Pegar shoes._fns a saída do pipeline e usá-la como entrada para pipelines definidos em title, preço, e description escopos;
Processar title, preço, e description pipelines para produzir os valores finais.

O resultado ficará igual ao resultado do Exemplo 2:

{
    "shoes": {
        "title": "Shoes",
        "price": "223.12",
        "description": [
            "Super"
        ]
    }
}

A principal diferença entre o Exemplo 2 e o Exemplo 3 é que no Exemplo 3, o pipeline é definido no shoes escopo. Esse pipeline adicional seleciona o elemento dos shoes e o passa para pipelines adicionais encontrados mais abaixo na hierarquia de instruções.

Lista de objetos aninhados

Caso de uso: Anteriormente, você queria analisar apenas shoes informações. Agora você quer analisar as informações de todos os produtos no HTML.

O HTML de exemplo é usado novamente como o documento-sobre-análise.

Se você quer que seu resultado analisado se pareça com isto:

{
    "products": [
        {
            "title": "Shoes",
            "price": "223.12",
            "description": [
                "Super"
            ]
        },
        {
            "title": "Pants",
            "price": "60.12",
            "description": [
                "Amazing",
                "Quality"
            ]
        },
        {
            "title": "Socks",
            "price": "123.12",
            "description": [
                "Very",
                "Nice",
                "Socks"
            ]
        }
    ]
}

As instruções de parsing ficariam da seguinte forma:

Exemplo 4. Analisando todos os produtos encontrados no documento HTML.

{
    "products": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": ["//div[@class='product']"]
            }
        ],
        "_items": {
            "title": {
                "_fns": [
                    {
                        "_fn": "xpath_one",
                        "_args": ["./div[@class='title']/text()"]
                    }
                ]
            },
            "price": {
                "_fns": [
                    {
                        "_fn": "xpath_one",
                        "_args": ["./div[@class='price']/text()"]
                    }
                ]
            },
            "description": {
                "_fns": [
                    {
                        "_fn": "xpath",
                        "_args": [".//li[@class='description-item']/text()"]
                    }
                ]
            }
        }
    }
}

A estrutura da instrução de parsing é semelhante à do Exemplo 3. No entanto, há duas grandes exceções:

xpath é usado em vez de xpath_one in products._fns pipeline. products._fns o pipeline agora irá produzir uma lista de todos os elementos que correspondem à expressão XPath fornecida (uma lista de elementos product).
_items propriedade reservada é usada para indicar que você quer formar uma lista iterando por cada item da products._fns saída do pipeline e passando/processando cada item da lista separadamente pelo escopo do pipeline.

Se _items a propriedade reservada não tivesse sido usada nas instruções de parsing do Exemplo 4, o resultado analisado seria o seguinte:

{
    "products": {
        "title": [
            "Shoes",
            "Pants",
            "Socks"
        ],
        "price": [
            "223.12",
            "60.12",
            "123.12"
        ],
        "description": [
            [
                "Super"
            ],
            [
                "Amazing",
                "Quality"
            ],
            [
                "Very",
                "Nice",
                "Socks"
            ]
        ]
    }
}

_items é usado para especificar que o Custom Parser deve passar itens da lista separadamente em vez da lista inteira pelas instruções de parsing.

Selecionar o N-ésimo elemento de uma lista

Esta seção demonstra a flexibilidade dos pipelines. O mesmo problema pode ser abordado de diferentes maneiras.

Várias opções podem ser usadas para selecionar o N-ésimo elemento de uma lista de quaisquer valores.

Caso de uso: você quer selecionar o preço do segundo produto da página.

O HTML de exemplo é novamente usado como exemplo. Você tem múltiplas opções para selecionar o 2º produto.

Opção 1

Você pode utilizar o seletor XPath [] e definir a seleção na expressão XPath.

Exemplo 5. Selecionar o 2º preço usando o seletor XPath [].

{
    "second_price": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": [
                    "(//div[@class='price'])[2]/text()"
                ]
            }
        ]
    }
}

Resultado:

{
    "second_price": [
        "60.12"
    ]
}

Opção 2

Você também pode usar a função xpath para encontrar todos os preços e encaminhá-la para a função select_nth, que seleciona o n-ésimo elemento da lista extraída de preços.

Exemplo 6. Selecionar o 2º valor usando a função `select_nth`.

{
    "second_price": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": [
                    "//div[@class='price']/text()"
                ]
            },
            {
                "_fn": "select_nth",
                "_args": 1
            }
        ]
    }
}

Resultado:

{
    "second_price": "60.12"
}

Observe como a select_nth função retorna um item de uma lista enquanto a xpath função retorna uma lista de itens, mesmo se um único item for encontrado.

Opção 3

Você pode usar select_nth com qualquer tipo de lista, incluindo listas de elementos HTML:

Exemplo 7. Selecionando todos os elementos HTML de produto com class="product" ==> selecionando o 2º elemento de produto da lista ==> extraindo o texto do preço do elemento HTML do produto selecionado.

{
    "second_price": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": ["//div[@class='product']"]
            },
            {
                "_fn": "select_nth",
                "_args": 1
            },
            {
                "_fn": "xpath",
                "_args": ["./div[@class='price']/text()"]
            }
        ]
    }
}

Resultado:

{
    "second_price": ["60.12"]
}

Tratamento de erros

Dado o seguinte trecho HTML:

<div class="product" id="shoes">
    <div class="title">Nice Shoes</div>
    <div class="price">223.12</div>
    <div class="description">Super</div>
</div>

E tentando analisá-lo com as seguintes instruções de parsing:

{
    "product": {
        "_fns": [
            {
                "_fn": "xpath_one",
                "_args": ["//div[@id='shoes']"]
            }
        ],
        "price": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@class='price']/text()"]
                }
            ]
        },
        "title": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@class='title']/text()"]
                }
            ]
        },
        "description": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@class='description']/text()"]
                },
                {
                    "_fn": "convert_to_float"
                }
            ]
        }
    }
}

O Custom Parser retornará um resultado analisado onde preço e title foram analisados normalmente, mas o description falhou ao ser analisado devido à convert_to_float função falhar ao converter string to float:

{
    "product": {
        "price": "223.12",
        "title": "Shoes",
        "description": null
    },
    "_warnings": [
        {
            "_fn": "convert_to_float",
            "_fn_idx": 1,
            "_msg": "Failed to process function.",
            "_path": ".product.description"
        }
    ]
}

Por padrão, todos os erros são contados como avisos e são colocados dentro da lista _warnings Se você quiser ignorar os erros ao analisar um campo, eles podem suprimir avisos/erros com "_on_error": "suppress" parâmetro:

{
    "product": {
        ...,
        "description": {
            "_on_error": "suppress",
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": ["//div[@class='description']/text()"]
                },
                {
                    "_fn": "convert_to_float"
                }
            ]
        }
    }
}

O que então produzirá o seguinte resultado:

{
    "product": {
        "price": "223.12",
        "title": "Shoes",
        "description": null
    }
}

Array de arrays

O Custom Parser permite arrays N-dimensionais em resultados analisados. Como exemplo, vamos usar o seguinte trecho HTML:

<div class="row">
    <div class="column">1</div>
    <div class="column">2</div>
    <div class="column">3</div>
</div>
<div class="row">
    <div class="column">4</div>
    <div class="column">5</div>
    <div class="column">6</div>
</div>
<div class="row">
    <div class="column">7</div>
    <div class="column">8</div>
    <div class="column">9</div>
</div>

Suponha que você queira analisar o documento de modo que o resultado seja um array 2D 3x3 de inteiros:

{
    "table": [
        [1, 2, 3],
        [4, 5, 6],
        [7, 8, 9],
    ]
}

Para transformar o HTML no JSON acima, você pode usar as seguintes instruções de parsing:

{
    "table": {
        "_fns": [
            {
                "_fn": "xpath",
                "_args": ["//div[@class='row']"]
            },
            {
                "_fn": "xpath",
                "_args": [".//div[@class='column']/text()"]
            },
            {
                "_fn": "convert_to_int"
            }
        ]
    }
}

AnteriorEscrevendo instruções manualmente PróximoDicas para escrever expressões XPath

Atualizado há 1 mês

Isto foi útil?

Bom dia

hashtagHTML de exemplo

hashtagMínimo necessário

hashtagInstruções de parsing aninhadas

hashtagLista de objetos aninhados

hashtagSelecionar o N-ésimo elemento de uma lista

hashtagOpção 1

hashtagOpção 2

hashtagOpção 3

hashtagTratamento de erros

hashtagArray de arrays

HTML de exemplo

Mínimo necessário

Instruções de parsing aninhadas

Lista de objetos aninhados

Selecionar o N-ésimo elemento de uma lista

Opção 1

Opção 2

Opção 3

Tratamento de erros

Array de arrays