python - 如何确保 README.rst 有效？

我的小工具有两个版本:

https://pypi.python.org/pypi/tbzuploader/2017.11.0

https://pypi.python.org/pypi/tbzuploader/2017.12.0 错误:pypi 页面看起来很难看。

在上次更新 README.rst 中的更改案例警告:

user@host> rst2html.py README.rst  > /tmp/foo.html
README.rst:18: (WARNING/2) Inline emphasis start-string without end-string.
README.rst:18: (WARNING/2) Inline emphasis start-string without end-string.

现在 pypi 页面看起来很难看 :-(

我用这个rec​​ipe做CI，bumpversion，上传到pypi:https://github.com/guettli/github-travis-bumpversion-pypi

我如何确保不再发布损坏的 README.rst？换句话说，我想避免 pypi 页面看起来很难看。

亲爱的细节爱好者:请不要查看 README.rst 中当前的特定错误。这不是问题:-)

最佳答案

更新

截至 2018 年 9 月 21 日，Python Packaging Authority 推荐了一个替代命令 twine check 。到 install twine :

pip install twine
twine check dist/*

请注意 twine requires readme_renderer 。你仍然可以使用 readme_renderer ，如果你想要它的其他功能，你只需要安装 twine ，如果你要发布到 PyPI，这是一个好主意。

来自官方 Python 打包文档 Uploading your Project to PyPI :



从该工具的 README.rst :

$ pip install readme_renderer
$ python setup.py check -r -s

关于python - 如何确保 README.rst 有效？，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/46682793/