check_download_cache#
- astropy.utils.data.check_download_cache(pkgname='astropy')[源代码]#
对缓存执行一致性检查。
备注
从V5.0开始,该函数不再返回任何内容。
因为缓存由的所有版本共享
astropy
在您的用户可能并发运行的所有Virtualenv中,它可能会累积问题。这可能会导致难以调试的问题或浪费空间。此函数检测许多不正确的情况,包括不存在的已索引文件、已索引但位于错误位置的文件,以及其内容与所索引的散列不匹配的文件(如果您请求)。此函数还返回未编制索引的文件列表。其中一些将与搁置对象相关联;它们的确切名称取决于所使用的后端,但可能基于
urlmap
。其他文件的存在可能表示出现了问题,无法访问的文件已累积在缓存中。可以使用以下命令删除这些文件clear_download_cache()
传递此处返回的文件名,或者不使用任何参数清空整个缓存并将其返回到合理的状态(如果为空)。- 参数:
- pkgname :
str
,可选Python:字符串,可选 用于定位下载缓存的包名,即
pkgname='astropy'
默认缓存位置为~/.astropy/cache
。
- pkgname :
- 加薪:
CacheDamaged
指示缓存内容有问题;该异常包含
.bad_files
属性,该属性包含一组文件名以允许用户使用clear_download_cache()
移除有问题的物品。OSError
,RuntimeError
以指示高速缓存结构存在某些问题。这可能需要完整的
clear_download_cache()
以解决问题,或者可能表明存在某种配置错误。