测试插件文档

在开发过程中进行快速测试的方法是使用 ansible-doc -t <plugin_type> <name> 来查看它是否呈现，如果该模块不在 Ansible 期望找到的位置，您可能需要添加 -M /path/to/module。

在提交插件以包含在 ansible-core 中之前，您必须运行测试以确保 argspec 与您的 Python 文件中的文档匹配，并且 argspec 和文档的结构正确。

如果您使用其他 RST 文件扩展 Ansible 文档，社区页面会提供更多关于 在本地测试 reStructuredText 文档 的信息。

要确保您的模块文档与您的 argument_spec 相匹配

1. 安装所需的 Python 包（在 venv/virtualenv 中删除 ‘–user’）

   pip install --user -r test/lib/ansible_test/_data/requirements/sanity.txt
   

2. 运行 validate-modules 测试

   ansible-test sanity --test validate-modules mymodule
   

如果您安装了 Docker 或 Podman，您也可以将它们与 --docker 选项一起使用，该选项使用已安装所有要求的映像

ansible-test sanity --docker --test validate-modules mymodule

对于其他插件类型，步骤类似，只需调整名称和路径以匹配特定类型即可。