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

加薪:
CacheDamaged

指示缓存内容有问题;该异常包含 .bad_files 属性,该属性包含一组文件名以允许用户使用 clear_download_cache() 移除有问题的物品。

OSError, RuntimeError

以指示高速缓存结构存在某些问题。这可能需要完整的 clear_download_cache() 以解决问题,或者可能表明存在某种配置错误。