docstring 相关问题

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

表示NumpyDoc DocStrings中参数的关键字作用?

[在尝试为我的DocString遵循NumpyDoc格式时,我似乎无法弄清楚如何告诉用户参数是关键字参数(即,指定为SomeFunc(theKeyWordArg = 100)...

回答 1 投票 3


如何以Google文档字符串格式格式化长行的参数描述

[这是从Google样式文档字符串中摘录的:def function_with_types_in_docstring(param1,param2):“”“示例函数具有文档字符串中记录的类型。 [

回答 1 投票 0

Sphinx:链接到Python文档字符串中另一个模块中类的方法

我想在一个模块(例如module_1.py)的另一个方法中添加到一个模块(例如module_2.py)中类的方法的链接。我希望链接在Sphinx中工作。假设:module_1.py类ABC:...

回答 2 投票 5

像Jupyter一样获得适当的文档字符串

在Jupyter笔记本中,您可以通过shfit-tabbing获得完整的符号字符串:相比之下,Pycharm的ctrl-Q行为令人讨厌,并且几乎没有用。格式不正确,缺少关键的...

回答 1 投票 0


“文件串”在球拍中?

[我知道Racket并不像许多其他语言一样具有“ docstrings”,但是鉴于在源代码上记录事情的便利性,我想在Racket中近似它。 ...

回答 1 投票 0

vscode文档字符串未正确显示

我不知道为什么会遇到这个问题。在过去的项目中(在具有不同OS的另一台计算机上),显示文档字符串没有问题。当我写一个文档字符串时,它应该显示...

回答 1 投票 0

Python装饰的类文档

我在python中为单例使用装饰器,实现如下所示。我希望装饰类的pydoc与非装饰类的pydoc完全相同,但是我不......>

回答 2 投票 0

python是否具有与javascript等效的功能注释?

在Java语言中,编码人员可以使用@param和{string}选项对函数进行如下注释。 Python有一个文档字符串,但是请阅读https://www.python.org/dev/peps/pep-0257/文档字符串约定...

回答 1 投票 0

如果错误是在代码中处理的,则文档字符串应包含'Raises'语句

假设我有一个简单的功能。例如:def if_a_float(string):尝试:float(string)除了ValueError:返回False其他:return True我应该包括加法:...

回答 2 投票 -1

在Python文档字符串中记录复杂的嵌套字典参数的最佳实践?

对于我正在研究的项目,我编写了一个函数,该函数使用matplotlib创建多个动画。问题是,该函数接受一个相当复杂的函数,并且(如果我很诚实地说)...

回答 1 投票 0

将文档字符串中的预期结果指定为十六进制吗?

是否有一种方法可以在文档字符串中以十六进制指定期望的整数结果? def identity(val):“”“ >>> identity(243)243 >>> identity(243)0xf3”“” ...

回答 1 投票 3

有没有一种描述/类型提示功能参数内容的方法?

我正在尝试学习如何更好地记录我的代码。尽管描述了一个功能,只是暗示它接受了字典,但这似乎使任何未来的读者在信息上都显得很短。在...

回答 1 投票 1

我如何为以下Python函数编写文档字符串?

假设我具有以下功能:def get_matrix(* args,任意= True):如果任意== True:返回np.random.randint(-10,10,size = [args [0],args [1]] )else:返回np.array(...

回答 1 投票 0

更一致的Sphinx主题

考虑mymodule.py中的以下功能#:def myfunc(num,mystring):“”“复制一个字符串:param num:一个正整数:param mystring:一个字符串:return:string ...

回答 1 投票 2

在另一个文档字符串中包含一个文档字符串

问题:我想在另一个文档字符串中使用一个文档字符串。假设我有以下代码段:def window(dimensions:tuple):'''创建应用程序窗口并将其返回的函数...

回答 1 投票 0

为所有Class方法打印python文档字符串

我想打印一个模块的文档,以包含每个类和该类中每个方法的文档字符串,但只包括我编写的方法;不是默认方法。这是...

回答 1 投票 2

麻烦命令行上输入模块后打印文档字符串

我无法使用Python解释器将它导入到我的终端窗口后,打印文档字符串。在我的终端窗口中键入蟒蛇后,我在下面的代码输入:进口比萨饼...

回答 1 投票 0

使用pandas.read_csv文档字符串在我写的函数

我想写出与下面的头一个功能:高清split_csv(文件,月= “;”,output_path =,= NROWS无,CHUNKSIZE =无,low_memory =真,usecols =无 “”):你可以看,我使用的是相同的...

回答 1 投票 4

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