如何在setup.py脚本中设置bug跟踪器URL

Question

我刚刚发现pypi web UI在编辑egg元数据时有一个字段'Bug tracker URL'.

此字段存在,所以我想它在setup.py中受支持,但我无法使用谷歌找到任何相关信息.

所以问题如何在我的setup.py中设置这个字段,这样当在pypi上做一个dist释放时,它可以自动填充.

Answer 1

该条目被调用bugtrack_url,但它没有从中获取setup.py.

从上下文和代码中我了解到,它仅用于通过Web上的PyPI,作为每个项目的元数据,而不是通常的每个发布信息.

添加这些信息的官方途径是通过项目的URL列表,但None并setuptools还没有支持这一新的领域.随着project_urls在水(至少目前如此)死了,我会添加setuptools到bugtrack_url不管怎样,将其转换成任何分发工具,我们在未来获得在时机成熟时.

Answer 2

PyPi 项目上的错误跟踪器 URL

在 setup.py 中使用setup_urls：

setup(
...
    project_urls={
        'Documentation': 'https://readthedocs.io/',
        'Funding': 'https://donate.pypi.org',
        'Say Thanks!': 'http://saythanks.io/to/example',
        'Source': 'https://github.com/pypa/sampleproject/',
        'Tracker': 'https://github.com/pypa/sampleproject/issues',
    },
...
)

字典顺序被保留，但在 PyPi 上以相反的顺序列出：

关于 PyPibugtracker_url遗留代码

pypa/仓库问题 #233

bugtrack_url：IIRC 它是 PyPI 维护者为了帮助项目而添加的东西，但同时 PEP 345 引入了 Project-URL，旨在涵盖源代码存储库、错误跟踪器、邮件列表等。如果 PEP 426 或其同伴之一保留Project-URL（并且可能通过为常见站点定义标签来改进它，例如“存储库”），那么这种特殊情况就变得多余了。

和

目前，看起来这在他们的 API 中被硬编码为 None 。我猜他们在迁移时为了向后兼容而离开了这个领域......