未打补丁的 Python 版本

在不带 tarfile 过滤器的 Python 上运行时，工具可以忽略本 PEP。

该功能已向后移植到 python.org 支持的所有 Python 版本。将其在第三方库中内嵌是很棘手的，我们不应强迫所有工具都这样做。这将把跟上安全更新的责任从工具转移到用户身上。

权限

常用工具（git、zip）不保留 Unix 权限（模式位）。告诉用户不要依赖 sdist 中的这些权限，并允许工具相对自由地处理它们，这似乎是公平的。

唯一的例外是 可执行 权限。我们建议但不要求工具保留它。考虑到脚本通常是平台特定的，可以说保持它们可执行是工具特定的行为。

请注意，虽然 git 保留了可执行性，但 zip（因此 wheel）本身不这样做。（可以将其编码在“外部属性”中，但 Python 的 ZipFile.extract 不遵守这一点。）

使用数据过滤器解包

提取源代码分发时，工具必须要么使用 tarfile.data_filter（例如 TarFile.extractall(..., filter='data')），要么遵循下面的“不使用数据过滤器解包”部分。

例外情况是，在没有 hasattr(tarfile, 'data_filter')（PEP 706）的 Python 解释器上，通常使用该过滤器（直接或间接）的工具可以警告用户并忽略此规范。在这种情况下，可用性（例如完全信任归档）和安全性（例如拒绝解包）之间的权衡由工具决定。

不使用数据过滤器解包

不直接使用 data 过滤器的工具（例如出于向后兼容性、允许额外特性或不使用 Python）必须遵循本节。（在撰写本文时，data 过滤器也遵循本节，但将来可能会不同步。）

以下文件在 sdist 归档中无效。遇到此类条目时，工具应通知用户，不得解包该条目，并可以中止并失败。

• 将被放置在目标目录之外的文件。
• 指向目标目录之外的链接（符号链接或硬链接）。
• 设备文件（包括管道）。

以下也无效。工具可以像上面一样处理它们，但不是必需的。

• 文件名或链接目标中包含 .. 组件的文件。
• 指向不属于归档文件的链接。

工具可以将链接（符号链接或硬链接）解包为普通文件，使用归档中的内容。

解压 sdist 归档时

• 文件名中的前导斜杠必须被删除。（这现在是 tar 解包的标准行为。）
• 对于每个 mode (Unix 权限) 位，工具必须
  • 分别使用平台对新文件/目录的默认设置，
  • 根据归档设置该位，或
  • 对于不可执行文件使用 rw-r--r-- (0o644) 的位，对于可执行文件和目录使用 rwxr-xr-x (0o755) 的位。
• 高 mode 位（setuid、setgid、sticky）必须被清除。
• 建议保留用户 可执行 位。

进一步提示

鼓励工具作者考虑 tarfile 文档中“进一步验证的提示”如何适用于他们的工具。