4

我使用诗歌来构建带有 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
4

0 回答 0