Module urllib :: Class URLopener
[hide private]
[frames] | no frames]

_ClassType URLopener

Known Subclasses:

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.