summaryrefslogtreecommitdiff
path: root/dev-python/urlgrabber/metadata.xml
blob: 10b42d6d5af98c3d2602a4f74d03d0c934f9209e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
<pkgmetadata>
  <herd>python</herd>
  <longdescription>
    A high-level cross-protocol url-grabber.

    Using urlgrabber, data can be fetched in three basic ways:

    urlgrab(url) copy the file to the local filesystem
    urlopen(url) open the remote file and return a file object (like urllib2.urlopen)
    urlread(url) return the contents of the file as a string


    When using these functions (or methods), urlgrabber supports the following
    features:

    * identical behavior for http://, ftp://, and file:// urls
    * http keepalive - faster downloads of many files by using only a single
      connection
    * byte ranges - fetch only a portion of the file
    * reget - for a urlgrab, resume a partial download
    * progress meters - the ability to report download progress automatically,
      even when using urlopen!
    * throttling - restrict bandwidth usage
    * retries - automatically retry a download if it fails. The number of retries
      and failure types are configurable.
    * authenticated server access for http and ftp
    * proxy support - support for authenticated http and ftp proxies
    * mirror groups - treat a list of mirrors as a single source, automatically
      switching mirrors if there is a failure.
  </longdescription>
</pkgmetadata>