11.11.1 Objets Telnet

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

read_until(attendu[, limite_temps])

Lit jusqu'à ce qu'une chaîne donnée soit rencontrée ou jusqu'à la limite de temps.

Quand aucune correspondance n'est trouvée, renvoie tout ce qui est disponible à la place, éventuellement la chaîne vide. Déclenche EOFError si la connexion est fermée et qu'aucune donnée préparée n'est disponible.

read_all()

Lit toutes les données jusqu'à EOF; bloque jusqu'à ce que la connexion se ferme.

read_some()

Lit au moins un octet de données préparées à moins de tomber sur EOF. Retourne '' si on tombe sur EOF. Bloque si aucune donnée n'est immédiatement disponible.

read_very_eager()

Lit tout ce qui peut l'être sans bloquer les entrées/sorties (avide).

Déclenche EOFError si la connexion est fermée et qu'aucune donnée préparée n'est disponible. Retourne '' si aucune donnée préparée n'est disponible. Ne bloque pas, sauf au milieu d'une séquence IAC.

read_eager()

Lit les données disponibles.

read_lazy()

Traite et retourne les données déjà dans les files d'attente (paresseux).

Déclenche EOFError si la connexion est fermée et qu'aucune donnée n'est disponible. Retourne '' si aucune donnée préparée n'est disponible. Ne bloque pas, sauf au milieu d'une séquence IAC.

read_very_lazy()

Retourne toute donnée disponible dans la file d'attente préparée (très paresseux).

Déclenche EOFError si la connexion est fermée et qu'aucune donnée n'est disponible. Retourne '' si aucune donnée préparée n'est disponible. Cette méthode ne bloque jamais.

open(hote[, port])

Se connecte à un hôte. Le second argument, optionnel, est le numéro de port, qui prend par défaut la valeur du port telnet standard (23).

Ne pas essayer de réouvrir une instance déjà connectée.

msg(msg[, *args])

Affiche un message de débogage quand le niveau de débogage est > 0. Si des arguments supplémentaires sont présents, ils sont substitués dans le message en utilisant l'opérateur de formattage de chaîne standard.

set_debuglevel(niveaudebogage)

Définit le niveau de débogage. Plus la valeur de niveaudebogage est élevée, plus on obtient d'informations de débogage (sur sys.stdout).

close()

Ferme la connexion.

get_socket()

Retourne l'objet socket utilisé en interne.

fileno()

Retourne le descripteur de fichier de l'objet socket utilisé en interne.

write(buffer)

Ecrit une chaîne dans la socket, en doublant les caractères IAC. Peut bloquer si la connexion est bloquée. Peut déclencher socket.error si la connexion est fermée.

interact()

Fonction d'interaction, émule un client telnet très stupide.

mt_interact()

Version multithreadée de interact().

expect(liste[, limitetemps])

Lit jusqu'à réception d'une chaîne correspondant à l'une des expressions régulières de la liste.

Le premier argument est une liste d'expressions régulières, soit compilées (instances de re.RegexObject) soit non compilées (chaînes de caractères). Le second argument, optionnel, est une limite de temps, en secondes; par défaut, on attend indéfiniment.

Retourne un tuple de trois éléments: l'index dans la liste de la première expression régulière qui correspond; l'objet match correspondant; et le texte lu jusqu'à la correspondance, celle-ci comprise.

Si on arrive en fin de fichier et qu'aucun texte n'a été lu, déclenche EOFError. Sinon, si rien ne correspond, retourne (-1, None, texte) où texte est le texte reçu jusque là (éventuellement la chaîne vide si une limite de temps est survenue).

Si une expression régulière se termine par une correspondance gourmande (par exemple .*) ou si plus d'une expression peut correspondre aux mêmes données d'entrée, les résultats sont aléatoires, et peuvent dépendre du débit d'entrée-sortie.