源码分发构建器(Source distribution builder)¶
源码分发包(source distribution,简称 sdist
)是一个包含 Python “源代码” 的归档文件。尽管其结构并无严格规范,但按照惯例,它应包含构建 wheel 所需的全部内容,且无需发起网络请求。
配置¶
该构建器插件的名称为 sdist
。
[tool.hatch.build.targets.sdist]
[build.targets.sdist]
选项(Options)¶
选项 | 默认值 | 描述 |
---|---|---|
core-metadata-version | "2.4" | 所使用的 核心元数据 版本 |
strict-naming | true | 文件名是否应包含规范化后的项目名称 |
support-legacy | false | 是否包含一个 setup.py 文件以支持旧式安装机制 |
版本类型(Versions)¶
版本 | 描述 |
---|---|
standard (默认) | 最新的常规格式 |
默认文件选择¶
当用户未设置任何 文件选择 选项时,所有未被 版本控制系统忽略 的文件将会被包含。
Note
以下文件总是会被包含,且无法排除:
/pyproject.toml
/hatch.toml
/hatch_build.py
/.gitignore
或/.hgignore
- 任何已定义的
readme
文件 - 所有已定义的
license-files
可重现性(Reproducibility)¶
支持 可重现构建。
构建数据(Build data)¶
以下数据可由 构建钩子 动态修改:
数据项 | 默认值 | 描述 |
---|---|---|
dependencies | 附加的 项目依赖 |