对于我的一个软件包,我有一个README.rst文件,它被读入setup.py的长描述中,如下所示:
readme = open('README.rst', 'r') README_TEXT = readme.read() readme.close() setup( ... long_description = README_TEXT, .... )
这样一来,我可以有README文件出现在我的github上页每一次我犯和时间的PyPI页每次我python setup.py register
.只有一个问题.我想在github页面上说"这篇文档反映了envbuilder的预发布版本.对于最新版本,请参阅pypi."
我可以把这些行放在README.rst中并在我之前删除它们python setup.py register
,但我知道在推到pypi之前我会忘记删除句子.
我正在尝试考虑自动化的最佳方法,所以我不必担心它.有人有主意吗?我可以做任何setuptools/distutils魔法吗?
您可以使用ReST注释和一些文本,例如"split here",然后在setup.py中将其拆分.Ian Bicking在带有index.txt和setup.py的 virtualenv中做到了这一点.
另一种选择是通过添加适用于两种环境的段落来完全解决问题:"最新的不稳定代码在github上.最新的稳定工具包在pypi上."
毕竟,为什么假设pypi人不想被指向github?这对两个受众都更有帮助,并简化了setup.py.