python - 如何配置 Sphinx auto flask 来记录 flask-restful API？

Question

我有一个 flask 应用程序，我想使用 Sphinx 的 autoflask 指令来记录一个 flask-restful API。

https://pythonhosted.org/sphinxcontrib-httpdomain/#module-sphinxcontrib.autohttp.flask

我已经通过 pip 安装了模块并运行了 sphinx-quickstart，这给了我一个 conf.py 和 index.rst。

我已经尝试将扩展名放入 conf.py 中:

extensions = ['sphinxcontrib.autohttp.flask']

根据文档将指令放入 index.rst 中:

.. autoflask:: autoflask_sampleapp:app
:undos-static:

但我无法正确获取 app:module (autoflask_sampleapp:app) 部分。结果，当我运行 sphinx-build 时，我收到一条错误消息，指出找不到应用程序或模块。

我的应用树看起来像这样:

.
├── admin
├── apis
├── app
│   ├── static
│   └── templates

从应用程序的根目录，我可以说:

from apis import profile

如何在 index.rst 中配置 auto flask 以正确查找和加载应用的 API 模块？

Answer 1

我的代码结构，其中带有 flask 应用程序的 application.py 文件，我运行我的服务器 python appllication.py runserver

├── application.py
├── _build
│   ├── doctrees
│   │   ├── environment.pickle
│   │   └── index.doctree
│   └── html
│       ├── genindex.html
│       ├── http-routingtable.html
│       ├── index.html
│       ├── objects.inv
│       ├── search.html
│       ├── searchindex.js
│       ├── _sources
│       │   └── index.txt
│       └── _static
├── conf.py
├── index.rst

在 conf.py 中，您应该包含扩展并包含指向您的 application.py 或项目中任何其他主要 Flask 应用程序文件的绝对路径。

import os
import sys
sys.path.insert(0, os.path.abspath('.'))

# -- General configuration ------------------------------------------------

# If your documentation needs a minimal Sphinx version, state it here.
#
# needs_sphinx = '1.0'

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
    'sphinxcontrib.autohttp.flask',
    'sphinxcontrib.autohttp.flaskqref'
]

在您可以使用蓝图后，您的 Flask 应用中的 View

My documentation!
=======================================


.. qrefflask:: application:application
   :undoc-static:

=======================================
Api details!
=======================================

.. autoflask:: application:application
   :undoc-static:

换句话说，在运行 make html 之前，您应该通过 python sys 路径 sys.path.insert(0, os.path.abspath('/home/myproject/')) 添加 abs 路径到您的根应用程序文件夹，/home/myproject 文件夹包含您的源代码。