11.3.1 Objets URLopener

Les objets URLopener et FancyURLopener possèdent les attributs suivants.

URLopeneropen(urlcomplete[, donnees])

Ouvre urlcomplete avec le protocole approprié. Cette méthode met à jour les informations de cache et de proxy, puis appelle la méthode open appropriée avec ses arguments d'entrée. Si le protocole n'est pas reconnu, open_unknown() est appelée. L'argument donnees a la même signification que l'argument donnees de urlopen().

URLopeneropen_unknown(urlcomplete[, donnees])

Interface surchargeable pour ouvrir des types d'URL inconnus.

URLopenerretrieve(url[, nomfichier[, accroche[, donnees]]])

Récupère le contenu de url et le place dans nomfichier. La valeur de retour est un tuple qui consiste en un nom de fichier local et soit un objet mimetools.Message contenant les entêtes de réponse (pour les URL distantes) ou None (pour les URL locales). L'appelant doit alors ouvrir et lire le contenu de nomfichier. Si nomfichier n'est pas fourni et que l'URL fait référence à un fichier local, le nom de fichier d'entrée est retourné. S'il l'URL n'est pas locale et que nomfichier n'est pas fourni, le nom de fichier est le résultat de tempfile.mktemp() avec un suffixe qui correspond à celui du dernier composant du chemin de l'URL d'entrée. Si accroche est fourni, il doit s'agir d'une fonction qui accepte trois paramètres numériques. Elle sera appelée après que chaque tronçon de données a été lu sur le réseau. accroche est ignorée pour les URL locales.

Si l'url utilise l'identifiant http:, l'argument optionnel donnees peut être fourni pour spécifier une requête POST (normalement le type de requête est GET). L'argument donnees doit être au format standard application/x-www-form-urlencoded; voir la fonction urlencode() ci-dessous.

URLopenerversion

Variable qui spécifie le "user agent" de l'objet ouvrant. Pour faire en sorte que urllib dise aux serveurs qu'il est un "user agent" particulier, affectez cette valeur dans une sous-classe comme variable de classe ou dans le constructeur avant d'appeler le constructeur de base.