11.4.1 Objets HTTP

Les instances de HTTP possèdent les méthodes suivantes:

set_debuglevel(niveau)

Définit le niveau de débogage (le volume d'informations de débogage imprimées). Le niveau de débogage par défaut est 0, qui signifie qu'aucune information de débogage n'est imprimée.

connect(hote[, port])

Se connecte au serveur indiqué par hote et port. Pour le port par défaut, voir l'introduction. A n'appeler directement que si l'instance a été créée sans passer de nom d'hôte.

send(donnees)

Envoie les données au serveur. A n'appeler directement qu'après que la méthode endheaders() a été appelée et avant que getreply() ne soit appelée.

putrequest(requete, selecteur)

Ce doit être le premier appel après que la connection au serveur a été effectuée. La méthode envoie une ligne au serveur constituée de la chaîne requete, de la chaîne selecteur, et de la version HTTP (HTTP/1.0).

putheader(entete, argument[, ...])

Envoi d'un entête du type RFC 822 au serveur. La méthode envoie une ligne au serveur constituée de l'entête, d'un deux-points et d'un espace, et du premier argument. Si d'autres arguments sont fournis, des lignes de continuation sont neovyées, chacune constituée d'une tabulation et d'un argument.

endheaders()

Envoie une ligne vide au serveur, pour signaler la fin des entêtes.

getreply()

Complète la requête en fermant l'extrémité émettrice de la socket, lit la réponse du serveur, et retourne un triplet (codereponse, message, entete). Ici, codereponse est l'entier code de réponse à la requête (par exemple, 200 si la requête a été gérée correctement); message est la chaîne de message correspondant au code de réponse; et entete est une instance de la classe mimetools.Message contenant les entêtes reçus du serveur. Voir la description du module mimetools.

getfile()

Retourne un objet fichier depuis lequel les données retournées par le serveur peuvent être lues, avec les méthodes read(), readline() ou readlines().