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.

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

11.6 httplib -- Client del protocollo HTTP

11.6 `httplib` -- Client del protocollo HTTP