Cómo trabajar con URLs en Python
La capa de URL de Aspose.HTML FOSS para Python implementa el análisis al estilo WHATWG, de modo que las URLs encontradas en documentos se resuelven y normalizan como los navegadores las tratan. Esta guía cubre el análisis, la validación, las cadenas de consulta y el modelo de fallos, usando pip para la instalación.
Guía paso a paso
Paso 1: Instalar el paquete
git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .Paso 2: Importar las clases requeridas
from aspose_html.url import URL, URLSearchParamsPaso 3: Analizar y validar
URL.parse() analiza URLs absolutas o relativas (con una base); URL.can_parse() responde la validez de forma económica sin construir un objeto; los fallos de análisis lanzan el URLParseError tipado.
Paso 4: Editar cadenas de consulta
URLSearchParams mantiene los parámetros de consulta — append(), get(), get_all(), has() y delete() — preservando la semántica de valores múltiples para claves repetidas.
Problemas comunes y soluciones
Una URL relativa no se puede analizar. El análisis relativo necesita una URL base — proporcione una a URL.parse().
Solo el primer valor de una clave repetida se devuelve. get() devuelve la primera coincidencia por diseño; use get_all() para cada valor.
Los componentes aparecen normalizados o codificados en porcentaje inesperadamente. Normalización WHATWG en acción — la salida coincide con el comportamiento del navegador.
Preguntas frecuentes
¿Cómo valido una URL sin analizarla?
URL.can_parse() devuelve un booleano sin construcción de objetos.
¿Las claves de consulta son sensibles a mayúsculas y minúsculas?
Sí — las claves se comparan tal cual, de acuerdo con el estándar URL.
¿Qué tipo de error se lanza al fallar el análisis?
El URLParseError tipado — captúralo en lugar de prevalidar con expresiones regulares.
