1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd">
6 A high-level cross-protocol url-grabber.
8 Using urlgrabber, data can be fetched in three basic ways:
10 urlgrab(url) copy the file to the local filesystem
11 urlopen(url) open the remote file and return a file object (like urllib2.urlopen)
12 urlread(url) return the contents of the file as a string
15 When using these functions (or methods), urlgrabber supports the following
18 * identical behavior for http://, ftp://, and file:// urls
19 * http keepalive - faster downloads of many files by using only a single
21 * byte ranges - fetch only a portion of the file
22 * reget - for a urlgrab, resume a partial download
23 * progress meters - the ability to report download progress automatically,
24 even when using urlopen!
25 * throttling - restrict bandwidth usage
26 * retries - automatically retry a download if it fails. The number of retries
27 and failure types are configurable.
28 * authenticated server access for http and ftp
29 * proxy support - support for authenticated http and ftp proxies
30 * mirror groups - treat a list of mirrors as a single source, automatically
31 switching mirrors if there is a failure.