docstring 相关问题

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

三双引号 vs.文档字符串的双引号[重复]

编写 Python 文档字符串的首选方式是什么? “““ 或者 ” 在 Dive Into Python 一书中,作者提供了以下示例: def buildConnectionString(params): &...

回答 4 投票 0

sphinx 文档字符串和 vscode

我有以下文档字符串: def 测试(foo): “”“这是我的功能 .. 代码块:: python 炫酷功能 现在我应该在代码块之外。 乙...

回答 1 投票 0

Python 模块帮助 DocStrings - 排除额外文档

我编写了一个简单的模块(testmodule),它导入了一些其他模块。当我导入它并输入: 帮助(测试模块) 我也从导入的模块中获得了所有帮助。 有没有办法

回答 1 投票 0

可以计算 Python 文档字符串(f 字符串或 % 表达式)吗?

是否可以计算Python文档字符串?我的文档字符串中有很多重复的内容,因此我想使用 f 字符串或 % 样式格式表达式。 当我使用 f 弦时...

回答 3 投票 0

调整 yaml.Dumper 以导出数据类及其文档字符串

我想将数据类对象包括它们的文档字符串(如上面#注释的描述)导出到yaml。 到目前为止,我发现我需要一个定制的自卸车或调整当前的自卸车。 来自

回答 1 投票 0

PyCharm Google-docstring 俄语解析问题

我在某个函数中有一个文档字符串。这是一个谷歌风格的文档字符串。我的 PyCharm 已启用默认语法检查。 由于某些原因,我收到 PEP 提示,句子中的第一个字母应该是

回答 1 投票 0

如何以编程方式设置文档字符串?

我有一个返回函数的包装函数。有没有办法以编程方式设置返回函数的文档字符串?如果我可以写信给 __doc__ 我会执行以下操作: def 包装器(a): ...

回答 7 投票 0

如何禁用带有 ruff 的 D100 和/或 C0111?

我使用sphinx,在我的py文件顶部有这个: #!/usr/bin/env python # -*- 编码:utf-8 -*- ”“” 我的模块 ========= 关于我的模块的一些注释 ”“” 这些是...

回答 1 投票 0

Python 3 文档字符串中返回值的多行描述

我的问题与这个SO问题非常相似:从8年前开始 - 但我更感兴趣的是使Returns:文档字符串的一部分多行。要点将是完美的,但迫使新的......

回答 1 投票 0

理解 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

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