Autodata: 使用autodoc-typehints记录没有函数签名的可调用对象
创始人
2024-09-22 21:02:55
0

要使用autodoc-typehints记录没有函数签名的可调用对象,可以按照以下步骤进行操作:

  1. 安装Sphinx和sphinx-autodoc-typehints:

    pip install Sphinx sphinx-autodoc-typehints
    
  2. 在Sphinx项目的conf.py文件中添加以下配置:

    # conf.py
    
    extensions = [
        ...
        'sphinx.ext.autodoc',
        'sphinx_autodoc_typehints',
        ...
    ]
    
    # 设置autodoc-typehints的类型推断级别,默认为1(仅基于注释),可以设置为2(基于函数签名)
    autodoc_typehints = 'description'
    
    # 设置是否在文档中显示类型提示,默认为False
    autodoc_typehints_description_target = 'documented'
    
  3. 在需要记录可调用对象的模块中使用类型提示语法,例如函数参数的类型提示和返回值的类型提示:

    def add(a: int, b: int) -> int:
        """Adds two numbers."""
        return a + b
    
  4. 运行Sphinx生成文档:

    sphinx-build -b html  
    

    这将生成HTML格式的文档。

    如果你已经有一个Sphinx项目并且只想更新文档,可以使用以下命令:

    make html
    

    这将使用Makefile中的配置来生成文档。

在生成的文档中,你将看到可调用对象的函数签名以及类型提示信息。

这是一个完整的示例:

# mymodule.py

def add(a: int, b: int) -> int:
    """Adds two numbers."""
    return a + b
# conf.py

extensions = [
    ...
    'sphinx.ext.autodoc',
    'sphinx_autodoc_typehints',
    ...
]

autodoc_typehints = 'description'
autodoc_typehints_description_target = 'documented'

最后,运行Sphinx命令生成文档:

sphinx-build -b html . _build

在生成的HTML文档中,你将看到add函数的函数签名和类型提示信息。

相关内容

热门资讯

记者揭秘!智星菠萝辅助(透视辅... 记者揭秘!智星菠萝辅助(透视辅助)拱趴大菠萝辅助神器,扑克教程(有挂细节);模式供您选择,了解更新找...
一分钟揭秘!约局吧能能开挂(透... 一分钟揭秘!约局吧能能开挂(透视辅助)hhpoker辅助靠谱,2024新版教程(有挂教学);约局吧能...
透视辅助!wepoker模拟器... 透视辅助!wepoker模拟器哪个好用(脚本)hhpoker辅助挂是真的,科技教程(有挂技巧);囊括...
透视代打!hhpkoer辅助器... 透视代打!hhpkoer辅助器视频(辅助挂)pokemmo脚本辅助,2024新版教程(有挂教程);风...
透视了解!约局吧德州真的有透视... 透视了解!约局吧德州真的有透视挂(透视脚本)德州局HHpoker透视脚本,必胜教程(有挂分析);亲,...
六分钟了解!wepoker挂底... 六分钟了解!wepoker挂底牌(透视)德普之星开辅助,详细教程(有挂解密);德普之星开辅助是一种具...
9分钟了解!wpk私人辅助(透... 9分钟了解!wpk私人辅助(透视)hhpoker德州透视,插件教程(有挂教学);风靡全球的特色经典游...
推荐一款!wepoker究竟有... 推荐一款!wepoker究竟有透视(脚本)哈糖大菠萝开挂,介绍教程(有挂技术);囊括全国各种wepo...
每日必备!wepoker有人用... 每日必备!wepoker有人用过(脚本)wpk有那种辅助,线上教程(有挂规律);wepoker有人用...
玩家必备教程!wejoker私... 玩家必备教程!wejoker私人辅助软件(脚本)哈糖大菠萝可以开挂,可靠技巧(有挂神器)申哈糖大菠萝...