11.6 httplib -- Client del protocollo HTTP

Questo modulo definisce le classi che implementano il lato client dei protocolli HTTP ed HTTPS. Non Ŕ normalmente usato direttamente -- il modulo urllib li usa per gestire gli URL che fanno uso di HTTP ed HTTPS.

Note: Il supporto HTTPS Ŕ disponibile solo se il modulo socket Ŕ stato compilato con il supporto SSL.

Note: L'interfaccia pubblica per questo modulo Ŕ cambiata in modo sostanziale in Python 2.0. La classe HTTP viene mantenuta solo per compatibilitÓ con la 1.5.2. Non dovrebbe essere usata in nuovo codice. Fare riferimento alla docstrings online per il suo utilizzo.

Le costanti definite in questo modulo sono:

HTTP_PORT
La porta predefinita per il protocollo HTTP (sempre 80).

HTTPS_PORT
La porta predefinita per il protocollo HTTPS (sempre 443).

Il modulo fornisce le seguenti classi:

class HTTPConnection( host[, port])
Un'istanza HTTPConnection rappresentante una transazione con un server HTTP. Dovrebbe essere istanziata passandogli un host ed un numero di porta facoltativo. Se non viene passato alcun numero di porta, questa viene estratta attraverso la stringa host se Ŕ nella forma host:port, altrimenti viene utilizzata la porta HTTP predefinita 80). Per esempio, le seguenti chiamate creano tutte istanze che si connettono al server allo stesso host e porta:

>>> h1 = httplib.HTTPConnection('www.cwi.nl')
>>> h2 = httplib.HTTPConnection('www.cwi.nl:80')
>>> h3 = httplib.HTTPConnection('www.cwi.nl', 80)
Nuovo nella versione 2.0.

class HTTPSConnection( host[, port, key_file, cert_file])
Una sotto classe di HTTPConnection che usa SSL per le comunicazioni con server sicuri. Predefinitamente utilizza la porta 443. key_file Ŕ il nome di un file formattato PEM che contiene la propria chiave privata. cert_file Ŕ un file contenente il certificato formattato PEM.

Questo non effettua alcuna verifica del certificato!

Nuovo nella versione 2.0.

class HTTPResponse( sock[, debuglevel=0][, strict=0])
Classe la cui istanza viene restituita in caso di connessione con successo. Non viene istanziata direttamente dall'utente. Nuovo nella versione 2.0.

Le seguenti eccezioni vengono sollevate quando appropriato:

exception HTTPException
La classe di base di altre eccezioni di questo modulo. È una sotto classe di Exception. Nuovo nella versione 2.0.

exception NotConnected
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception InvalidURL
Una sotto classe di HTTPException, sollevata quando viene fornita una porta che si riveli essere non numerica o vuota. Nuovo nella versione 2.3.

exception UnknownProtocol
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception UnknownTransferEncoding
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception UnimplementedFileMode
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception IncompleteRead
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception ImproperConnectionState
Una sotto classe di HTTPException. Nuovo nella versione 2.0.

exception CannotSendRequest
Una sotto classe di ImproperConnectionState. Nuovo nella versione 2.0.

exception CannotSendHeader
Una sotto classe di ImproperConnectionState. Nuovo nella versione 2.0.

exception ResponseNotReady
Una sotto classe di ImproperConnectionState. Nuovo nella versione 2.0.

exception BadStatusLine
Una sotto classe di HTTPException. Sollevata se un server risponde con un codice di stato HTTP che non viene capito. Nuovo nella versione 2.0.



Subsections
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.