跳转到主要内容

处理CACHEDIR.TAG文件,指示包含缓存内容的目录

项目描述

CACHEDIR.TAG for Python

这个库处理 CACHEDIR.TAG 文件,允许任何任意目录被标记为缓存目录。

CACHEDIR.TAG 文件指示包含缓存数据的目录,例如:

  • 下载
  • 预览和缩略图
  • 构建工件和其他中间结果

缓存数据很有用,但不是必需的 - 如果需要,它可以重新生成或重新下载。然而,备份程序、磁盘清理实用程序和其他软件不知道任意路径是否是缓存数据,除非它被标记。

可以通过编写一个名为 CACHEDIR.TAG 的常规文件来标记目录(以及其内部的全部目录),其前43个字节为:

Signature: 8a477f597d28d172789f06886806bc55

在此签名之后,可以包含任何其他文本。规范建议以 # 开头的文本行,编码为UTF-8。例如:

# This file is a cache directory tag created by (application name).
# For information about cache directory tags, see:
#	http://www.brynosaurus.com/cachedir/

这个库遵循这个建议。

安装

$ python -m pip install cachedir-tag

用法

创建您的缓存目录(如果需要的话)

>>> import os, cachedir_tag
>>> os.mkdir('/var/cache/yourapp')

标记它,这将创建一个新的 CACHEDIR.TAG 文件

>>> cachedir_tag.tag('/var/cache/yourapp')

检查目录是否已标记

>>> cachedir_tag.is_tagged('/var/cache/yourapp')
True

检查子目录(可能尚未存在)是否已标记

>>> cachedir_tag.is_tagged('/var/cache/yourapp/somedir')
True

替代方案

操作系统和类似平台通常有关于在哪里放置缓存数据的约定。如果您遵循这些约定,则不需要 CACHEDIR.TAG 文件,但这也无妨。

更多信息

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

cachedir-tag-0.0.3.tar.gz (3.3 kB 查看哈希值)

上传时间 源代码

构建分布

cachedir_tag-0.0.3-py2.py3-none-any.whl (3.1 kB 查看哈希值)

上传时间 Python 2 Python 3

由以下组织支持