我使用诗歌来构建带有 cython 扩展的包,因此启用了安装包标志。我想通过 readthedocs 托管文档。诗歌使用build.py文件setup.py通过poetry build命令生成。但是 readthedocs 不支持build.py,所以我提供setup.py了以下内容:
from setuptools import setup
from build import *
global setup_kwargs
setup_kwargs = {}
build(setup_kwargs)
setup(**setup_kwargs)
为了摆脱requirements.txtdocs 文件夹中的文件,我想extras_require在 setup 中添加参数,所以最后一行setup.py:
setup(extras_require={'docs': ['toml']}, **setup_kwargs)
阅读文档调用/<path>/envs/latest/bin/python -m pip install --upgrade --upgrade-strategy eager --no-cache-dir .[docs]
警告:不提供额外的“文档”docs/conf.py并且从失败导入 toml
如果我添加额外内容pyproject.toml:
[tool.poetry.extras]
docs = ['toml']
警告消失但 rtd 仍然无法导入 toml。
我的.readthedocs.yml:
version: 2
sphinx:
configuration: docs/conf.py
formats: all
python:
version: 3.7
install:
- method: pip
path: .
extra_requirements:
- docs
submodules:
include: all