添加 License-Expression 字段

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

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

对于所有包含 License-Expression 字段的新上传的 发行版归档文件，Python 包索引 (PyPI) **必须**验证它们是否包含一个有效的、大小写规范化的许可证表达式以及有效的标识符（如 上面所定义），并且**必须**拒绝不符合要求的上传。符合 SPDX 规范的自定义许可证标识符被视为有效。PyPI **可以**拒绝使用已弃用许可证标识符的上传，只要它在上述 SPDX 许可证列表版本中被弃用。

添加 License-File 字段

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

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

如果 License-File 列在 源代码发行版 或 构建发行版 的核心元数据中

• 该文件**必须**包含在 发行版归档文件 中，路径相对于根许可证目录。
• 该文件**必须**与 项目 一起安装，路径相同。
• 指定的相对路径**必须**在项目源代码树、源代码发行版 (sdist)、构建发行版（Wheel）和已安装项目之间保持一致。
• 在根许可证目录内，打包工具**必须**复制源许可证文件相对于项目根目录所在的目录结构。
• 路径分隔符**必须**是正斜杠字符 (/)，并且**不能**使用父目录指示符 (..)。
• 许可证文件内容**必须**是 UTF-8 编码的文本。

构建工具**可以**，发布工具**应该**在构建发行版的元数据不包含 License-File 条目时发出提示性警告，发布工具**可以**，但构建工具**不能**引发错误。

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

弃用 License 字段

传统的非结构化文本 License 核心元数据字段 已被弃用，并由新的 License-Expression 字段取代。这两个字段是互斥的。生成核心元数据的工具**不得**同时创建这两个字段。读取核心元数据的工具，当同时遇到这两个字段时，**必须**读取 License-Expression 的值，并且**必须**忽略 License 字段的值。

如果只有 License 字段存在，工具**可以**发出警告，告知用户该字段已弃用，并建议使用 License-Expression 代替。

对于所有新上传的包含 License-Expression 字段的 发行版归档文件，Python 包索引 (PyPI) **必须**拒绝任何同时指定 License 和 License-Expression 字段的发行版归档文件。

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

弃用许可证分类器

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

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

否则，如果该字段包含许可证分类器，工具**可以**发出警告，告知用户此类分类器已弃用，并建议使用 License-Expression 代替。为了与现有的发布和安装流程兼容，除非也提供了 License-Expression，否则许可证分类器的存在**不应**引发错误。

**不得**将新的许可证分类器 添加到 PyPI；需要使用它们的用户**应**改用 License-Expression 字段。许可证分类器可能会在未来某个 PEP 中从规范的新版本中移除。

向 license 键添加字符串值

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

构建工具**应**验证并执行表达式的案例规范化，如 添加 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 键

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

其值是一个字符串数组，**必须**包含有效的 glob 模式，如下所述

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

本规范未涵盖的任何字符或字符序列均无效。项目**不得**使用此类值。使用此字段的工具**应**使用错误拒绝无效值。

工具**必须**假设许可证文件内容是有效的 UTF-8 编码文本，并且**应**验证这一点，如果它不是，则引发错误。

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

构建工具

• **必须**将每个值视为一个 glob 模式，并且**必须**在模式包含无效的 glob 语法时引发错误。
• **必须**在所有发行版归档文件中包含列出的模式匹配的所有文件。
• **必须**在核心元数据中的 License-File 字段下列出每个匹配的文件路径。
• **必须**在任何单个用户指定的模式至少不匹配一个文件时引发错误。

如果 license-files 键存在且设置为一个空数组的值，则工具**不得**包含任何许可证文件，并且**不得**引发错误。

有效的许可证文件声明示例

[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"]

原因：**不得**使用 ..。 \ 是无效的路径分隔符，**必须**使用 /。

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

原因：“LICEN{CSE*” 不是有效的 glob。

弃用 license 键表子键

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

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

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

如果指定的许可证 file 存在于源代码树中，构建工具**应**使用它来填充核心元数据中的 License-File 字段，并且**必须**包含指定的文件，就好像它是在 license-file 字段中指定的一样。如果该文件在指定的路径中不存在，工具**必须**引发以前指定的提示性错误。

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