我使用诗歌来构建带有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)
要摆脱docs文件夹中的requirements.txt
文件,我想添加extras_require
参数进行设置,因此setup.py
的最后一行:
setup(extras_require={'docs': ['toml']}, **setup_kwargs)
Readthedocs呼叫/<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