How can I document a function which takes a function as a parameter with Sphinx?(我如何用Sphinx记录一个以函数为参数的函数?)
本文介绍了我如何用Sphinx记录一个以函数为参数的函数?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!
问题描述
假设我有一个如下所示的类:
class FunctionCaller:
def __init__(self):
"""A class which can be used to call different functions which take the same
parameters
"""
self.f = lambda a,b: (a,b)
def setF(self, new_f):
"""Set the function to call
:param new_f: The new function this object should call
:type new_f: func(:class:`.SomeClass`, :class:`int`)
"""
self.f = new_f
def callF(self, a, b):
"""Call the function this object currently contains
:param a: Some value
:param b: Some other value
"""
return self.f(a,b)
class SomeClass:
"""Some class which does nothing
"""
pass
例如(忽略这可能是糟糕的编码风格),让我们假设FunctionCaller
将要调用的函数期望将SomeClass
作为其第一个参数,并将一个int作为其第二个参数。我希望文档显示指向这两件事的链接。我在示例中定义它的方式可以工作,但看起来不是很好。
有什么方法可以使用:type:
说明符来指示参数是函数吗?
推荐答案
有什么方法可以使用
:type:
说明符来指示参数是函数吗?
我想您可以指定types.FunctionType
作为类型。但我建议你解释一下它是如何工作的:
def setF(self, new_f):
"""Set the function to call
:param new_f: The new function this object should call.
The new function takes two positional parameters: the first of
type :class:`.SomeClass` and the second of type :class:`int`.
"""
self.f = new_f
这篇关于我如何用Sphinx记录一个以函数为参数的函数?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!
沃梦达教程
本文标题为:我如何用Sphinx记录一个以函数为参数的函数?


猜你喜欢
- 使用 Cython 将 Python 链接到共享库 2022-01-01
- 如何使用PYSPARK从Spark获得批次行 2022-01-01
- CTR 中的 AES 如何用于 Python 和 PyCrypto? 2022-01-01
- 我如何卸载 PyTorch? 2022-01-01
- ";find_element_by_name(';name';)";和&QOOT;FIND_ELEMENT(BY NAME,';NAME';)";之间有什么区别? 2022-01-01
- 计算测试数量的Python单元测试 2022-01-01
- YouTube API v3 返回截断的观看记录 2022-01-01
- 我如何透明地重定向一个Python导入? 2022-01-01
- 使用公司代理使Python3.x Slack(松弛客户端) 2022-01-01
- 检查具有纬度和经度的地理点是否在 shapefile 中 2022-01-01