docstring 相关问题

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

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

如何修复“缺少模块 docstringpylint(missing-module-docstring)”

我在 VS Code 上使用 pygame 模块,遇到了 pygame 没有 init 成员的问题。我按照此链接的解决方案进行操作。我编辑了用户设置并添加了 “python.lint...

回答 5 投票 0

Python 文档字符串:不一致的前导空白错误,没有换行

我的文档字符串: def some_f(): ”“” 1.第一个故事 >>> 字符串(5) 如果你想查看该值: >>> 打印(str(5)) 2.另一个故事 ...

回答 1 投票 0

如何在 Sphinx 中记录 Python 类的私有属性

我想将 Python 类的私有属性的描述添加到该类的 Sphinx 文档字符串中以提高代码可读性,但我希望自动生成的文档不显示这些属性。 C……

回答 0 投票 0

如何在我的构造函数中继承类的文档字符串

我有一个类来生成我用文档字符串记录的测试数据。 /// /// 在这种情况下,用户是该组的新用户,但可能以前就存在。 /// 我有一个类来生成我用文档字符串记录的测试数据。 /// <summary> /// In this scenario the user is new to the group, but may have existed from before. /// </summary> class NewUserData { public User user; // More data fields here ... public NewUserData(){ // Creating test data here ... } } 类在这样的单元测试中使用: var data = new NewUserData(); 将鼠标悬停在 NewUserData 上不会显示 IDE(Visual Studio)中的文档字符串。有没有办法在不将文档字符串向下移动到构造函数的情况下实现这一点? 发现可以使用 inheritdoc 标签实现这一点并将类名指定为 cref. /// <inheritdoc cref="NewOwnerData"/> var data = new NewUserData();

回答 1 投票 0

如何在 Python 文档字符串中添加链接?

我在 python 3.x 中有一个函数 定义 foo(): """有关更多信息的 Lorem ipsum,请参见此处"" 我想在“这里”添加一个超链接以指向一个网站。没有

回答 2 投票 0

通过名称将函数的文档字符串复制到另一个函数

我正在寻找按名称(使用装饰器)在同一文件中复制函数的文档字符串。 我可以使用当前模块之外的功能轻松完成它,但是当它出现时我有点困惑......

回答 2 投票 0

文档字符串的目的[关闭]

def平方(n): ''接受一个数n,返回的平方 n'' 打印(n**2) 正方形(5) 打印(正方形.doc) 文档字符串有什么用? 为什么我们不能直接通过打印函数打印字符串

回答 0 投票 0

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