Como trabalhar com URLs em Python
A camada de URL do Aspose.HTML FOSS para Python implementa análise no estilo WHATWG, de modo que URLs encontradas em documentos são resolvidas e normalizadas da mesma forma que os navegadores as tratam. Este guia aborda análise, validação, strings de consulta e o modelo de falhas, usando pip para instalação.
Guia Passo a Passo
Passo 1: Instale o Pacote
git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .Passo 2: Importe as Classes Necessárias
from aspose_html.url import URL, URLSearchParamsPasso 3: Analise e Valide
URL.parse() analisa URLs absolutas ou relativas (com uma base); URL.can_parse() responde à validade de forma barata sem construir um objeto; falhas de análise lançam o URLParseError tipado.
Etapa 4: Editar strings de consulta
URLSearchParams faz round-trip de parâmetros de consulta — append(), get(), get_all(), has() e delete() — preservando a semântica de múltiplos valores para chaves repetidas.
Problemas comuns e correções
Um URL relativo não consegue analisar. A análise relativa precisa de um URL base — forneça um para URL.parse().
Apenas o primeiro valor de uma chave repetida é retornado. get() retorna a primeira correspondência por design; use get_all() para cada valor.
Os componentes parecem normalizados ou percent-encoded inesperadamente. Normalização WHATWG em ação — a saída corresponde ao comportamento do navegador.
Perguntas Frequentes
Como validar uma URL sem analisá-la?
URL.can_parse() retorna um booleano sem construção de objeto.
As chaves de consulta são sensíveis a maiúsculas e minúsculas?
Sim — as chaves são correspondidas exatamente, de acordo com o padrão de URL.
Que tipo de erro as falhas de análise geram?
O URLParseError tipado — capture-o em vez de pré-validar com expressões regulares.
