我使用诗歌来构建带有 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.txt
docs 文件夹中的文件,我想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