1. 弃用问题
在Python 3.7URL
中,我使用该urllib.request.urlretrieve(..)
函数从 a 下载了一个大文件。在文档(https://docs.python.org/3/library/urllib.request.html)中,我在文档上方阅读了以下内容urllib.request.urlretrieve(..)
:
遗留接口
以下函数和类是从 Python 2 模块 urllib(与 urllib2 相对)移植而来的。它们可能会在未来的某个时候被弃用。
2. 寻找替代品
为了让我的代码永不过时,我正在寻找替代方案。Python 官方文档没有提到具体的文档,但它看起来urllib.request.urlopen(..)
是最直接的候选者。它位于文档页面的顶部。
不幸的是,替代方案——比如urlopen(..)
——没有提供reporthook
论据。此参数是您传递给urlretrieve(..)
函数的可调用对象。反过来,urlretrieve(..)
使用以下参数定期调用它:
- 块编号。
- 块大小
- 总文件大小
我用它来更新进度条。这就是为什么我错过了reporthook
替代方案中的论点。
3. urlretrieve(..) 与 urlopen(..)
我发现urlretrieve(..)
只是使用urlopen(..)
. 查看request.py
Python 3.7 安装中的代码文件(Python37/Lib/urllib/request.py):
_url_tempfiles = []
def urlretrieve(url, filename=None, reporthook=None, data=None):
"""
Retrieve a URL into a temporary location on disk.
Requires a URL argument. If a filename is passed, it is used as
the temporary file location. The reporthook argument should be
a callable that accepts a block number, a read size, and the
total file size of the URL target. The data argument should be
valid URL encoded data.
If a filename is passed and the URL points to a local resource,
the result is a copy from local file to new file.
Returns a tuple containing the path to the newly created
data file as well as the resulting HTTPMessage object.
"""
url_type, path = splittype(url)
with contextlib.closing(urlopen(url, data)) as fp:
headers = fp.info()
# Just return the local path and the "headers" for file://
# URLs. No sense in performing a copy unless requested.
if url_type == "file" and not filename:
return os.path.normpath(path), headers
# Handle temporary file setup.
if filename:
tfp = open(filename, 'wb')
else:
tfp = tempfile.NamedTemporaryFile(delete=False)
filename = tfp.name
_url_tempfiles.append(filename)
with tfp:
result = filename, headers
bs = 1024*8
size = -1
read = 0
blocknum = 0
if "content-length" in headers:
size = int(headers["Content-Length"])
if reporthook:
reporthook(blocknum, bs, size)
while True:
block = fp.read(bs)
if not block:
break
read += len(block)
tfp.write(block)
blocknum += 1
if reporthook:
reporthook(blocknum, bs, size)
if size >= 0 and read < size:
raise ContentTooShortError(
"retrieval incomplete: got only %i out of %i bytes"
% (read, size), result)
return result
4。结论
从这一切中,我看到了三个可能的决定:
我保持我的代码不变。让我们希望该
urlretrieve(..)
功能不会很快被弃用。我给自己写了一个替换函数
urlretrieve(..)
,在外部表现得像在urlopen(..)
内部使用。实际上,这样的功能将是上面代码的复制粘贴。这样做感觉不干净——与使用官方相比urlretrieve(..)
。我给自己写了一个替换函数,在外部表现得像
urlretrieve(..)
,在内部使用完全不同的东西。但是,嘿,我为什么要这样做?urlopen(..)
没有被弃用,那么为什么不使用它呢?
你会做出什么决定?