urllib.error — Undantagsklasser som skapats av urllib.request

Källkod: Lib/urllib/error.py


Modulen urllib.error definierar undantagsklasser för undantag som orsakas av urllib.request. Basundantagsklassen är URLError.

Följande undantag tas upp av urllib.error på lämpligt sätt:

exception urllib.error.URLError

Hanterarna lyfter detta undantag (eller härledda undantag) när de stöter på ett problem. Det är en underklass till OSError.

reason

Orsaken till detta fel. Det kan vara en meddelandesträng eller en annan undantagsinstans.

Ändrad i version 3.3: URLError var tidigare en subtyp av IOError, som nu är ett alias av OSError.

exception urllib.error.HTTPError(url, code, msg, hdrs, fp)

Även om det är ett undantag (en underklass till URLError), kan ett HTTPError också fungera som ett filliknande returvärde (samma sak som urlopen() returnerar). Detta är användbart när man hanterar exotiska HTTP-fel, till exempel förfrågningar om autentisering.

url

Innehåller URL:en för begäran. Ett alias för attributet filnamn.

code

En HTTP-statuskod enligt definitionen i RFC 2616. Detta numeriska värde motsvarar ett värde som finns i kodlexikonet som finns i http.server.BaseHTTPRequestHandler.responses.

reason

Detta är vanligtvis en sträng som förklarar orsaken till felet. Ett alias för msg-attributet.

headers

HTTP-svarsrubrikerna för den HTTP-begäran som orsakade HTTPError. Ett alias för attributet hdrs.

Tillagd i version 3.4.

fp

Ett filliknande objekt där HTTP-feltexten kan läsas från.

exception urllib.error.ContentTooShortError(msg, content)

Detta undantag uppstår när funktionen urlretrieve() upptäcker att mängden data som hämtas är mindre än den förväntade mängden (som anges i rubriken Content-Length).

content

De nedladdade (och förmodligen avkortade) uppgifterna.