Skip to main content

狮身人面像

项目描述

介绍

sphinxcontrib-argdocSphinx 文档引擎的扩展。

它会自动为用 Python 编写的可执行脚本生成描述命令行参数的表格,并将这些表格插入到:automodule:由 Sphinx 扩展autodoc为脚本生成的文档中。

唯一的要求是:

  1. 可执行脚本使用 Python argparse模块进行参数解析。

  2. 脚本的第一个文档存根文件包括:automodule:指令(默认情况下,如果您使用sphinx-apidoc ,它们将使用该指令)。

有关更多信息、详细说明和示例,请参阅 sphinxcontrib-argdoc 文档

安装使用

sphinxcontrib-argdoc 可以 使用pip从PyPI安装。或者,您可以将开发版本克隆到您的PYTHONPATH中。

要使用sphinxcontrib-argdoc,只需将“sphinxcontrib.argdoc”添加到项目的 Sphinx 配置文件conf.py的扩展列表中:

# somewhere in conf.py
extensions = ['sphinxcontrib.argdoc',
              'another_extension',
              'some_other_extension'
             ]

测试

测试是使用nose编写的,可以在子包sphinxcontrib.argdoc.test中找到。要运行测试,请从终端键入:

$ nosetests sphinxcontrib.argdoc.test

作者

执照

sphinxcontrib-argdoc根据 BSD 3-Clause License 获得许可

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

sphinxcontrib-argdoc-0.1.3.tar.gz (22.9 kB 查看哈希)

已上传 source

内置分布

sphinxcontrib_argdoc-0.1.3-py2.py3-none-any.whl (51.9 kB 查看哈希

已上传 py2 py3