问使用readthedocs上模拟模块中的参数的Sphinx autodoc
EN

Stack Overflow用户

提问于 2017-05-15 12:18:51

回答 1查看 517关注 0票数 0

我们正在使用readthedocs来记录我们的开源项目pandapower。

因为pandapower依赖于numpy和其他不能在rtd上构建的C库，所以我们使用autodoc_mock_imports参数为这些库创建模拟导入。这在一般情况下是很好的，但是在以np.nan作为默认参数的函数的autodoc中会出现问题，例如这里。sn_kva参数的默认值是np.nan (参见代码中的这里 )，但是由于numpy是作为模拟模块导入的，所以它显示为"sphinx.ext.autodoc._MockModule对象“。

有人知道有可能避免这种情况吗？

python-sphinx

read-the-docs

autodoc

回答 1

Stack Overflow用户

回答已采纳

发布于 2017-05-15 18:24:20

提供想要的签名作为docstring的第一行。然后狮身人面像将在输出中使用它作为签名。见签名。

在您的示例中，函数的第一行如下所示：

def create_load(net, bus, p_kw, q_kvar=0, const_z_percent=0, const_i_percent=0, sn_kva=nan,
            name=None, scaling=1., index=None,
            in_service=True, type=None, max_p_kw=nan, min_p_kw=nan,
            max_q_kvar=nan, min_q_kvar=nan, controllable=nan):
    """
    create_load(net, bus, p_kw, q_kvar=0, const_z_percent=0, const_i_percent=0, sn_kva=nan,
                name=None, scaling=1.0, index=None,
                in_service=True, type=None, max_p_kw=nan, min_p_kw=nan,
                max_q_kvar=nan, min_q_kvar=nan, controllable=nan)

    Adds one load in table net["load"].

    ...

    """

票数 0

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/43979369

复制

相似问题

问使用readthedocs上模拟模块中的参数的Sphinx autodoc
EN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问使用readthedocs上模拟模块中的参数的Sphinx autodocEN

回答 1

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问使用readthedocs上模拟模块中的参数的Sphinx autodoc
EN