docstring 相关问题

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

如何将代码示例嵌入到文档字符串中?

如何将代码嵌入到文档字符串中,以告诉 Sphinx 将代码格式化为与 Markdown 中类似的格式(不同的背景颜色、等宽无衬线字体)?例如记录 c...

回答 2 投票 0

如何在 Python 中记录使用 `type` 定义的类型别名?

Python 3.12 有 type 声明。如何正确记录类型别名? 我试过: 类型数字 = int |漂浮 """表示标量,可以是整数或浮点数"&

回答 1 投票 0

使用 Sphinx Napoleon 将 Google 风格的文档字符串提取到数据类中

我正在尝试以编程方式摄取(“反映”)Google 风格的文档字符串。我正在使用 sphinx.ext.napoleon,因为似乎没有多少工具可以做到这一点。我按照下面的示例进行操作

回答 1 投票 0

在Python包中添加__author__的位置[关闭]

我正在编写一个简单的 Python 包,(目前)只有一个模块。 我应该将 docstring 和 __author__ 元属性放在哪里?它们是在 __init__.py 中还是在每个模块中? 有没有...

回答 2 投票 0

用于自动完成文档字符串的Python IDE

我正在寻找一个可以自动为我生成文档字符串框架的Python IDE。 例如: def GetTextByCtrlName(self, _hwnd, _ctrName): ''' @描述: @

回答 3 投票 0

有没有办法用新的/修改的参数自动更新Python自动文档字符串?

我使用 VS Code 作为编辑器,使用 autoDocstring 作为 Python 的自动文档字符串生成器扩展。有时我会修改函数的参数,或者通过引入新参数......

回答 1 投票 0

如何获取NamedTuple或数据类字段的文档字符串?

我正在使用带有针对 Python 3.6+ 的建议的注释的 NamedTuple: 从输入导入NamedTuple 类配置(NamedTuple): buy_fee:浮动 """我的字段描述...""&...

回答 1 投票 0

错误 mkdocstrings 生成错误“没有名为模块”

我正在使用 mkdocstrings 为我的 python 项目构建一个文档站点。 为了生成代码参考文件,我遵循了此说明 https://mkdocstrings.github.io/recipes/ 我明白这些

回答 2 投票 0

如何让 VS Code 在重构时也重命名 Python 文档字符串中的符号?

我在 Python 项目中使用 VS Code,目前我使用文档字符串来记录它。但是,当我重命名函数参数的符号 (F2) 时,它不会在文档字符串中更新。你...

回答 1 投票 0

如何将 Python 文档字符串转换为不同的样式?

我正在开发一个使用 Google 风格的 Python 文档字符串的代码库,我想将它们自动转换为 numpy 风格。 有没有自动工具可以做到这一点? 快速谷歌搜索

回答 1 投票 0

Sphinx 抛出一些缩进错误,我不知道如何修复它们

这些是我从 Sphinx 收到的错误: 意外的缩进: [{ “资源”:“/c:/Users/User/Documents/GitHub/MIMIC/mimic/model_simulate/base_model.py”, “主人&qu...

回答 1 投票 0

三双引号 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

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