如何在 Python 包元数据中指定要求

Question

Core metadata specification 记录了元数据字段Requires-External，它似乎用于指定系统（非python）依赖项。

您实际上是如何指定此字段的？这是我尝试过的：

.
├── mypackage
│   └── __init__.py
└── setup.py

setup.py的内容

from setuptools import setup

setup(
    name="mypackage",
    description="blah blah",
    url='https://example.org',
    version="0.1",
    packages=["mypackage"],
    requires_external=[
        "C",
        "libpng (>=1.5)",
        'make; sys_platform != "win32"',
    ],
)

当我构建这个包时，元数据并未包含在内

Metadata-Version: 2.1
Name: mypackage
Version: 0.1
Summary: blah blah
Home-page: https://example.org
License: UNKNOWN
Platform: UNKNOWN

UNKNOWN

那么将 Requires-External 传递给 setuptools/distutils 的语法是什么？注意：这个问题不是询问 Requires-Dist 元数据。

Answer 1

那么将 Requires-External 传递给 setuptools/distutils 的语法是什么？

默认情况下没有，因为distutils 和setuptools 都不支持该字段。此外，requires_external 关键字 arg 也不受支持 - 它被默默忽略，就像任何其他未知关键字 arg 一样。

要添加对requires_external kwarg 的本地支持，您需要提供自己的分发实现。最小示例（需要 Python 3.9）：

from setuptools.dist import Distribution as DistributionOrig

class Distribution(DistributionOrig):
    _DISTUTILS_UNSUPPORTED_METADATA = DistributionOrig._DISTUTILS_UNSUPPORTED_METADATA | {'requires_external': dict}

当与distclass 配对时，您现在可以将requires_external 传递给setup()：

setup(
    ...,
    requires_external=[
        'C',
        'libpng (>=1.5)',
        'make; sys_platform != "win32"',
    ],
    distclass=Distribution,
)

下一个目标是将requires_external的内容实际写入PKG-INFO。通过分发元数据本身来做到这一点非常棘手，因为setuptools 用自己的整体实现修补了相关方法（DistributionMetadata.read_pkg_file() 和DistributionMetadata.write_pkg_file()）。这个 IMO 最简单的方法是通过自定义 egg_info impl 修改 PKG-INFO post factum：

import email
from pathlib import Path
from setuptools.command.egg_info import egg_info as egg_info_orig


class egg_info(egg_info_orig):
    def run(self):
        super().run()
        # PKG-INFO is now guaranteed to exist
        pkg_info_file = Path(self.egg_info, 'PKG-INFO')
        pkg_info = email.message_from_bytes(pkg_info_file.read_bytes())
        for req in self.distribution.metadata.requires_external:
            pkg_info.add_header('Requires-External', req)
        pkg_info_file.write_bytes(pkg_info.as_bytes())

在setup() 中通过cmdclass 参数传递您自己的egg_info impl：

setup(
    ...,
    requires_external=[
        'C',
        'libpng (>=1.5)',
        'make; sys_platform != "win32"',
    ],
    distclass=Distribution,
    cmdclass={'egg_info': egg_info},
)