docstring 相关问题

docstring是一个字符串,它作为模块,函数,类或方法定义中的第一个语句出现,用于记录发生它的对象。

理解 Python 文档字符串中“两点”的使用

我目前正在学习 Python 文档字符串,特别是在 Google 风格、NumPy 风格和 Sphinx 风格格式的背景下。我注意到有时有两个...

回答 2 投票 0

如何从单独的脚本访问文档字符串?

构建一个 GUI,供用户选择他们想要运行的 Python 脚本。每个脚本都有自己的文档字符串,解释脚本的输入和输出。我想在 UI 中显示该信息一次...

回答 2 投票 0

为什么我们在 Python 中使用文档字符串? [已关闭]

文档字符串是一个字符串文字,作为 Python 中模块、函数、类或方法定义中的第一个语句出现。它提供了一种记录代码的目的和用法的方法。

回答 1 投票 0

将 .py 文件作为模块导入时未显示文档字符串?

我正在开发一个项目,我开始在其他 .py 文件中编写函数并将它们导入到主 .py...我想为我正在导入的整个文件(模块)编写帮助文本,

回答 3 投票 0

pdoc3 错误地渲染了 Args 部分

最近从 M1 迁移到 M2 mac。之前成功调用 pdoc 是在 M1 上使用 Ventura 13.6(相同的 python 版本)。我是否缺少先决条件,或者可能需要降级

回答 1 投票 0

Python 函数/方法文档字符串变量

假设我要为下面的代码编写文档字符串: def some_thing_cool(年龄, 姓名): better_age = 年龄 - 20 Cooler_name = 名称 + '棒极了' bday_list = ['蛋糕', '气球'] 返回

回答 3 投票 0

如何在Python中访问枚举值的文档字符串?

对于代码文档工具,我想分析Python Enum类并打印其详细信息。各个枚举值的文档字符串也应被打印。 但是,由于枚举值显示为其

回答 1 投票 0

Python Google 文档字符串参考部分

有谁知道在遵循谷歌格式的Python文档字符串中包含引用的好方法吗?我正在编写一系列流体属性生成器。我想要一种轻松记录的方法

回答 2 投票 0

numpydoc:当我使用类型提示时,我可以省略文档字符串中的类型声明吗?

当在函数签名中使用类型提示时,如果我要遵守 numpydoc 风格,是否也需要在文档字符串中指定参数类型? def add(a: float, b: int) -> float: ...

回答 1 投票 0

替换 libcst 函数定义中的 SimpleString? (dataclasses.FrozenInstanceError:无法分配给字段“body”)

上下文 在尝试使用 libcst 模块时,我在更新函数文档时遇到一些困难。 微量元素 要重现该错误,以下最小工作示例 (MWE) 是

回答 1 投票 0

python:如何同时使用类型注释和文档字符串格式

现在我们在 Python 中有了类型注释,我想知道如何使用类型注释和文档字符串格式来记录代码。 具体来说,将参数类型指定为

回答 1 投票 0

Pydocstyle 引发 D407 错误的原因是什么?

我正在使用 pydocstyle,我想知道为什么它会针对我的代码引发错误 D407 / 在部分(“示例”)后缺少虚线下划线。 我的代码如下所示: def foo(): ”“”

回答 2 投票 0

如何在 Jupyter Notebook 的 VS Code 中显示文档字符串或函数签名?

我目前已安装 VS Code 作为 Jupyterlab 的替代编辑器,用于 Python 数据科学开发。现在我想知道如何显示函数的文档字符串或签名? 我做到了...

回答 3 投票 0

直接传递给API调用的Docstrings参数

我正在为我的方法编写文档,该方法有很多参数,但所有参数都只是直接传递到 API 调用中。它看起来像这样: def func(a, b, c, d, e, f, g, h): ...

回答 1 投票 0

如何在 VS Code 中获取 Google/Sphinx 风格的 Python 类属性文档的悬停信息? (如“#:文本”)

我正在尝试记录 Python 类中的实例变量,以便当我将鼠标悬停在它们上方时它们会显示在 VS Code 中。我发现这有效: TsCity 类: def __init__(self) -> 无: 自己....

回答 1 投票 0

如何在 VS Code 中获取 Sphinx 风格的 Python 类属性文档的悬停信息? (如“#:文本”)

我正在尝试记录 Python 类中的实例变量,以便当我将鼠标悬停在它们上方时它们会显示在 VS Code 中。我发现这有效: TsCity 类: def __init__(self) -> 无: 自己....

回答 1 投票 0

在 VS Code 中显示实例属性的 Python 文档字符串

我正在尝试记录 Python 类中的实例变量,以便当我将鼠标悬停在它们上方时它们会显示在 VS Code 中。我发现这有效: TsCity 类: def __init__(self) -> 无: 自己....

回答 1 投票 0

“折叠所有块注释”命令不适用于具有特定导入安排的文件中的 Python 文档字符串

VS Code 的“折叠所有块注释”命令似乎会随机决定是否对我正在编辑的任何给定 python 文件起作用,直到我能够算出导入语句的数量...

回答 1 投票 0

“折叠所有块注释”命令不适用于具有特定导入安排的文件中的 Python 文档字符串

VS Code 的“折叠所有块注释”命令似乎会随机决定是否对我正在编辑的任何给定 python 文件起作用,直到我能够算出导入语句的数量...

回答 1 投票 0

Sphinx 隐藏在 __init__.py 中导入的模块

我的包有一个结构,类似于以下内容: ├── 自述文件.md ├── __init__.py ├── 模块1 │ └── submodule1.py │ └── submodule2.py ├── 模块2 │ ├── __init__.py │ ├── _hiden_submodule1...

回答 1 投票 0

© www.soinside.com 2019 - 2024. All rights reserved.