Module urllib :: Class URLopener

Class URLopener

Known Subclasses:

FancyURLopener

Class to open URLs. This is a class rather than just a subroutine because we may need more than one set of global protocol-specific options. Note -- this is a base class for those who don't want the automatic handling of errors type 302 (relocated) and 401 (authorization needed).

Instance Methods

[hide private]

__init__(self, proxies=None, **x509)

__del__(self)

close(self)

cleanup(self)

addheader(self, *args)
Add a header to be used by the HTTP interface only e.g.

open(self, fullurl, data=None)
Use URLopener().open(file) instead of open(file, 'r').

open_unknown(self, fullurl, data=None)
Overridable interface to open unknown URL type.

open_unknown_proxy(self, proxy, fullurl, data=None)
Overridable interface to open unknown URL type.

retrieve(self, url, filename=None, reporthook=None, data=None)
retrieve(url) returns (filename, headers) for a local object or (tempfilename, headers) for a remote object.

open_http(self, url, data=None)
Use HTTP protocol.

http_error(self, url, fp, errcode, errmsg, headers, data=None)
Handle http errors.

http_error_default(self, url, fp, errcode, errmsg, headers)
Default error handler: close the connection and raise IOError.

open_https(self, url, data=None)
Use HTTPS protocol.

open_gopher(self, url)
Use Gopher protocol.

open_file(self, url)
Use local file or FTP depending on form of URL.

open_local_file(self, url)
Use local file.

open_ftp(self, url)
Use FTP protocol.

open_data(self, url, data=None)
Use "data" URL.

Class Variables

[hide private]

__tempfiles = None

version = 'Python-urllib/1.17'

Method Details

[hide private]

addheader(self, *args)

Add a header to be used by the HTTP interface only e.g. u.addheader('Accept', 'sound/basic')

http_error(self, url, fp, errcode, errmsg, headers, data=None)

Handle http errors. Derived class can override this, or provide specific handlers named http_error_DDD where DDD is the 3-digit error code.