添加 License-Expression 字段

可选的 License-Expression 核心元数据字段 被指定为包含一个文本字符串，该字符串是一个有效的SPDX 许可证表达式，如 上述定义。

构建和发布工具 SHOULD 检查 License-Expression 字段是否包含有效的SPDX表达式，包括特定许可证标识符的有效性（如 上述定义）。发现无效表达式时，工具 MAY 停止执行并引发错误。如果工具选择验证SPDX表达式，它们还 SHOULD 存储 License-Expression 字段的大小写规范化版本，其中每个SPDX许可证标识符使用参考大小写，AND、OR 和 WITH 关键词使用大写。如果一个或多个许可证标识符在 SPDX许可证列表 中被标记为已弃用，工具 SHOULD 报告警告，发布工具 MAY 引发错误。

对于所有包含 License-Expression 字段的新上传的 分发档案，Python包索引 (PyPI) MUST 验证它们是否包含有效且大小写规范化的许可证表达式以及有效的标识符（如 上述定义），并且 MUST 拒绝不符合的上传。符合SPDX规范的自定义许可证标识符被认为是有效的。PyPI MAY 拒绝使用已弃用许可证标识符的上传，只要该标识符在上述SPDX许可证列表版本中已弃用。

添加 License-File 字段

License-File 是一个可选的 核心元数据字段。每个实例都包含许可证相关文件的路径的字符串表示形式。该路径位于 项目源树 内，相对于 项目根目录。这是一个可多次使用的字段，可以出现零次或多次，每个实例列出其中一个文件的路径。在此字段下指定的文件可能包括许可证文本、作者/归属信息或其他需要随包分发的法律声明。

如 本PEP所规定，其值也是该文件在 已安装项目 和标准化的 分发包 类型中相对于 根许可证目录 的路径。

如果 License-File 列在 源分发 或 构建分发 的核心元数据中

• 该文件 MUST 包含在 分发档案 中，其路径相对于根许可证目录。
• 该文件 MUST 随 项目 一同安装，路径相同。
• 指定的相对路径在项目源树、源分发 (sdists)、构建分发 (Wheels) 和已安装项目之间 MUST 保持一致。
• 在根许可证目录内，打包工具 MUST 复制源许可证文件相对于项目根目录的目录结构。
• 路径分隔符 MUST 是正斜杠字符 (/)，并且 MUST NOT 使用父目录指示符 (..)。
• 许可证文件内容 MUST 为UTF-8编码的文本。

构建工具 MAY 并且发布工具 SHOULD 在构建分发元数据不包含 License-File 条目时生成信息性警告，发布工具 MAY 但构建工具 MUST NOT 抛出错误。

对于所有新上传的 分发档案，如果其核心元数据中包含一个或多个 License-File 字段并声明 Metadata-Version 为 2.4 或更高版本，PyPI SHOULD 验证所有指定文件是否存在于该 分发档案 中，并且 MUST 拒绝未通过验证的上传。

弃用 License 字段

旧版非结构化文本 License 核心元数据字段 已被弃用，并由新的 License-Expression 字段取代。这两个字段互斥。生成核心元数据的工具 MUST NOT 同时创建这两个字段。读取核心元数据的工具，在同时处理这两个字段时，MUST 读取 License-Expression 的值，并且 MUST 忽略 License 字段的值。

如果只存在 License 字段，工具 MAY 发出警告，告知用户该字段已弃用，并推荐使用 License-Expression。

对于所有新上传的 分发档案，如果包含 License-Expression 字段，Python包索引 (PyPI) MUST 拒绝同时指定 License 和 License-Expression 字段的任何上传。

在未来的PEP中，License 字段可能会从新版规范中移除。

弃用许可证分类器

在 Classifier 核心元数据字段 中使用 许可证分类器（在核心元数据规范中描述）已被弃用，并由更精确的 License-Expression 字段取代。

如果 License-Expression 字段存在，构建工具 MAY 在 Classifier 字段中包含一个或多个许可证分类器时引发错误，并且 MUST NOT 自己添加此类分类器。

否则，如果此字段包含许可证分类器，工具 MAY 发出警告，告知用户此类分类器已弃用，并推荐使用 License-Expression。为了与现有的发布和安装过程兼容，除非同时提供了 License-Expression，否则出现许可证分类器 SHOULD NOT 引发错误。

新的许可证分类器 MUST NOT 添加到 PyPI；需要它们的用户 SHOULD 使用 License-Expression 字段。许可证分类器可能会在未来的PEP中从新版规范中移除。

向 license 键添加字符串值

[project] 表中的 license 键被定义为包含一个顶级字符串值。它是一个有效的SPDX许可证表达式，如 本PEP中所定义。其值映射到核心元数据中的 License-Expression 字段。

构建工具 SHOULD 按照 添加 License-Expression 字段 部分所述验证并执行表达式的大小写规范化，并按规定输出错误或警告。

示例

[project]
license = "MIT"

[project]
license = "MIT AND (Apache-2.0 OR BSD-2-clause)"

[project]
license = "MIT OR GPL-2.0-or-later OR (FSFUL AND BSD-2-Clause)"

[project]
license = "LicenseRef-Proprietary"

添加 license-files 键

在 [project] 表中添加了一个新的 license-files 键，用于指定项目源树中相对于 pyproject.toml 的文件路径，这些文件包含要随包分发的许可证和其他法律声明。它对应于核心元数据中的 License-File 字段。

其值为字符串数组，MUST 包含有效的全局模式，如下所述

• 字母数字字符、下划线 (_)、连字符 (-) 和点 (.) MUST 按字面匹配。
• 特殊全局字符：*、?、** 和字符范围：[] 仅包含字面匹配字符的 MUST 受支持。在 [...] 内，连字符表示不区分区域的范围（例如 a-z，顺序基于Unicode代码点）。开头或结尾的连字符按字面匹配。
• 路径分隔符 MUST 是正斜杠字符 (/)。模式是相对于包含 pyproject.toml 的目录，因此 MUST NOT 使用前导斜杠字符。
• 父目录指示符 (..) MUST NOT 使用。

任何不受本规范涵盖的字符或字符序列都是无效的。项目 MUST NOT 使用此类值。使用此字段的工具 SHOULD 拒绝无效值并报错。

工具 MUST 假定许可证文件内容是有效的UTF-8编码文本，并且 SHOULD 验证这一点并在不是时引发错误。

字面路径（例如 LICENSE）被视为有效的全局模式，这意味着它们也可以被定义。

构建工具

• MUST 将每个值视为一个全局模式，并且如果模式包含无效的全局语法，MUST 抛出错误。
• MUST 将所有被列出的模式匹配的文件包含在所有分发档案中。
• MUST 在核心元数据的 License-File 字段下，列出每个匹配的文件路径。
• 如果任何单个用户指定的模式未匹配到至少一个文件，MUST 抛出错误。

如果 license-files 键存在且设置为空数组，则工具 MUST NOT 包含任何许可证文件，并且 MUST NOT 抛出错误。

有效许可证文件声明示例

[project]
license-files = ["LICEN[CS]E*", "AUTHORS*"]

[project]
license-files = ["licenses/LICENSE.MIT", "licenses/LICENSE.CC0"]

[project]
license-files = ["LICENSE.txt", "licenses/*"]

[project]
license-files = []

无效许可证文件声明示例

[project]
license-files = ["..\LICENSE.MIT"]

原因：MUST NOT 使用 ..。\ 是无效的路径分隔符，MUST 使用 /。

[project]
license-files = ["LICEN{CSE*"]

原因：“LICEN{CSE*”不是一个有效的全局模式。

弃用 license 键表子键

[project] 表中 license 键的表值，包括 text 和 file 表子键，现已弃用。如果新的 license-files 键存在，则如果 license 键已定义且其值不是单个顶级字符串，则构建工具 MUST 抛出错误。

如果新的 license-files 键不存在，并且 license 表中存在 text 子键，工具 SHOULD 发出警告，告知用户它已弃用，并建议使用许可证表达式作为顶级字符串键。

同样，如果新的 license-files 键不存在，并且 license 表中存在 file 子键，工具 SHOULD 发出警告，告知用户它已弃用，并建议使用 license-files 键。

如果指定的许可证 file 存在于源树中，构建工具 SHOULD 用它来填充核心元数据中的 License-File 字段，并且 MUST 包含指定的文件，如同它在 license-file 字段中指定一样。如果文件在指定路径不存在，工具 MUST 抛出之前指定的信息性错误。

在未来的PEP中，license 键的表值可能会从新版规范中移除。