跳转到主要内容

使用requests下载文件并将它们保存到目标路径

项目描述

使用requests方便地下载到文件。

基本用法

url = "https://github.com/takluyver/requests_download/archive/master.zip"
download(url, "requests_download.zip")

可选的headers=参数传递给requests。

跟踪器是监控下载数据的轻量级方式。包含两个跟踪器

  • ProgressTracker - 使用progressbar2包显示进度条。

  • HashTracker - 包装hashlib对象,在下载文件时计算文件哈希(例如sha256或md5)。

以下是使用它们的示例

import hashlib
# progressbar is provided by progressbar2 on PYPI.
from progressbar import DataTransferBar
from requests_download import download, HashTracker, ProgressTracker

hasher = HashTracker(hashlib.sha256())
progress = ProgressTracker(DataTransferBar())

download('https://github.com/takluyver/requests_download/archive/master.zip',
         'requests_download.zip', trackers=(hasher, progress))

assert hasher.hashobj.hexdigest() == '...'

要创建自己的跟踪器,从TrackerBase派生并定义这些方法中的任何一个

from requests_download import TrackerBase

class MyTracker(TrackerBase):
    def on_start(self, response):
        """Called with requests.Response object, which has response headers"""
        pass

    def on_chunk(self, chunk):
        """Called multiple times, with bytestrings of data received"""
        pass

    def on_finish(self):
        """Called when the download has completed"""
        pass

支持者