Ansibug

Ansible调试适配器协议的核心组件，用于调试Ansible剧本。有关ansibug的更多文档，请参阅https://jborean93.github.io/ansibug/。

请注意，此库应被视为预览版。在此预览期间，应期待新功能和行为更改。

调试适配器

此库与调试适配器协议客户端（如Visual Studio Code）结合使用，可以用于交互式地运行和调试Ansible剧本。它支持基本功能，如执行、跳过和退出剧本中的任务，并支持在运行时获取和设置变量。

有关调试适配器和Ansible的调试体验的更多信息，请参阅文档。

需求

在使用此库之前必须满足以下Python需求

• Python 3.9+（取决于ansible-core支持）
• ansible-core >= 2.14.0
• Linux或macOS（不支持Windows）

调试器旨在继续支持尚未达到生命周期的当前 ansible-core 版本。请参阅ansible-core 支持矩阵以查看当前版本和对应版本的控制器 Python 版本。不能保证所有功能在所有 Ansible 版本中都会得到支持，新功能可能只存在于较新版本的 Ansible 中。任何此类功能将在文档中明确指出。

安装

此库已在 PyPI 发布，可以使用以下命令安装：

python -m pip install ansibug

要本地测试更改，请运行以下命令

git clone https://github.com/jborean93/ansibug.git

python -m pip install -e .[dev]
pre-commit install

这将以可编辑模式安装当前代码，并包含一些用于测试或其他开发功能的开发库。

测试

此库使用tox来运行理智性和集成测试。一旦安装了此库的开发额外功能，就可以通过运行 tox 命令来运行所有测试。

由于此库的支持矩阵可能需要一些时间来运行，可能只运行某些测试是有益的。以下因素在 tox 中可用：

• 理智性
• py3{9,10,11,12}
• ansible_{2.14,2.15,2.16,2.17,devel}

以下是一些可以使用 tox 调用的示例因素：

# Run only the sanity tests
tox run -f sanity

# Run Ansible 2.16 on all its supported Python versions
tox run -f ansible_2.16

# Run Python 3.12 on all the supported Ansible versions
tox run -f py312

# Run Ansible 2.16 tests on Python 3.12
tox run -f py312 ansible_2.16