docstring 相关问题

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

Sphinx 文档在字段中显示双冒号

我正在为一个包开发文档,当我构建 sphinx 文档时,我得到了双冒号 对于每个函数定义的所有字段。 我正在为我的

回答 3 投票 0

如何在 VS Code 中查看子类模型的类文档字符串

我将模块/类的所有文档字符串放在类的文档字符串中;与在类文档字符串和初始化文档字符串之间拆分文档字符串相反。阅读了一些指南后...

回答 1 投票 0

为什么当我将鼠标悬停在 VS Code 中的函数上时,函数定义和文档字符串会显示两次?如何解决只显示一次?

将鼠标指针悬停在函数上时,无论是内置函数还是自定义函数,函数的定义和文档字符串都会按预期显示,但会显示两次。 我一直在寻找什么可能......

回答 2 投票 0

Sphinx 从 autodoc 中删除数据类字段

正如本文所述,即使 napoleon 将字段添加为文档,autodoc 也会急切地将类变量添加到文档中: 从数据类导入数据类 @数据类 Fo类...

回答 2 投票 0

文档字符串格式在 VSCode 中不起作用

小问题。几天前,文档字符串将被格式化,以便当我将鼠标悬停在它们上方时,“Args”(Google 风格)和“Returns”将以粗体显示,以及参数的名称......

回答 1 投票 0

在PyTorch中,如何让nn.Module的__call__()自动复制forward()的类型提示和文档字符串?

在forward()中实现前向步骤并通过__call__调用它是很常见的,就像这个例子 从火炬导入 nn、FloatTensor、IntTensor 类 MyModule(nn.Module): def __init__(s...

回答 1 投票 0

iPython/Jupyter 中的文档字符串(三引号)带有自动闭括号/引号?

我正在尝试使用 Python 2.7 在我的 Jupyter 笔记本中使用带三引号的文档字符串。 我可以禁用自动关闭括号/引号,但我非常喜欢它们;工作流程大幅增加。 ...

回答 2 投票 0

在文档字符串中用 MathJax 替换宏 URL 锚点

我有这个带有数学指令的文档字符串,它有一个很长的锚点指向同一页面: 我的班级: r"""介绍文本。 .. 数学:: \href{#the_very_long_anc...

回答 1 投票 0

Julia 文档字符串被替换

我制作了以下模块: 模块Foo 出口酒吧 ”“” 酒吧 结构栏文档字符串。 ”“” 结构栏 n::整数 @doc“”” 酒吧(n::Int)

回答 1 投票 0

为什么当函数体为空时,文档字符串足以满足 python 对函数的定义?

我发现了Python的这个有趣的功能,其中: def do_nothing(): “”“什么也不做。”“” 与此相同: def do_nothing(): ... 我发现有人评论了他...

回答 1 投票 0

我是否应该记录函数的所有参数、异常和返回值,即使它们已经记录在其他函数中? (Python)

我注意到在许多函数中相同的参数会重复。例子: def run_inspection(第一个面板,最后一个面板,结果,设置,参考, 注册设置): &qu...

回答 1 投票 0

PyCharm:如何获取要在快速文档弹出窗口中列出的类属性?

我发现这真的很烦人,快速文档不显示类文档中列出的属性。我认为原因是不正确或不受支持的文档字符串格式,但行为是......

回答 2 投票 0

如何访问示例/模板数据表(cucumber)的参数?

我们使用codeceptjs和cucumber进行api测试。在测试步骤中,我们决定使用文档字符串来传递变量而不是数据表。 现在创建场景大纲(黄瓜风格)

回答 1 投票 0

在文档字符串中,如何为多个参数提供相同的描述(使用EpyText标签)?

对于将鼠标悬停在函数调用上显示帮助的 IDE(例如 PyCharm),而不是为多个参数创建具有相同描述的多行...有没有一种方法可以通过标记来简化...

回答 1 投票 0

PyCharm / IntelliJ 对 Python 文档字符串使用什么样式?

我试图了解有关创建文档字符串的“解决方案生态系统”,然后使用 PyCharm/IntelliJ 生成一些不错的参考文档。 我已经习惯了 Google 风格

回答 2 投票 0

无法访问pycharm中numpy库的外部python文档

Pycharm 无法访问 numpy 和所有其他已安装库的文档。运行正确,但在高电平时没有提供包含功能描述的内联文档...

回答 1 投票 0

Python 类型检查无法识别文档字符串中的类型信息

我正在使用一个名为 client_aiohttp 的内部库,它是使用 openapi-generator/python-aiohttp 生成的。 例如,这里是 Clusters 类中的 add_hosts 方法: # client_aiohttp/api/

回答 1 投票 0

当 docstring 需要字符串时,可以传递 None 参数吗?

好吧,这个问题可能已经在某个地方得到了回答,但我的 Google-fu 还没有找到正确的关键字组合。 我有一个接受字符串的函数,但是当我传递 None 时,Pycharm 的

回答 4 投票 0

在 Visual Studio 代码调试器中进行 Pytesting 文档测试

假设我在 foo.py 中有以下代码: 定义开始(): ”“” >>> 开始() 你好世界 ”“” 测试 = 10 打印('你好世界') 通常情况下,我...

回答 1 投票 0

在文档字符串中使用类型别名

是否有使用类型别名或在文档字符串中键入对象的最佳实践? 这个问题可能会吸引基于意见的答案。但也可能是 有一个被广泛接受的惯例或

回答 1 投票 0

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