Ansible Lint GitLab

The ansible-lint JSON output to GitLab friendly JUnit converter.

Installation

via pip:

pip install ansible-lint-gitlab

Updating

via pip:

pip install ansible-lint-gitlab --upgrade

Usage:

• You can run ansible-lint -f json on your playbook(s) and pipe the output in

  ansible-lint playbook.yml -f json | ansible-lint-gitlab -o ansible-lint-gitlab.xml
  

• You can use a temporary file to store the output of ansible-lint. After that run ansible-lint-gitlab and pass the generated file to it

  ansible-lint -f json your_fancy_playbook.yml > ansible-lint.json
  ansible-lint-gitlab ansible-lint.json -o ansible-lint-gitlab.xml
  

Output

• If there are any lint errors, full JUnit XML will be created.
• If there are no errors, an empty JUnit XML will be created.

Development

This project is packaged with setuptools using a PEP 621 [project] table in pyproject.toml — there is no setup.py. The package version is declared dynamically and read from src/ansible_lint_gitlab/version.py, which is the single source of truth.

Build the distribution artifacts (sdist and wheel) with the build frontend:

pip install build
python -m build

Run the tests with pytest:

pip install pytest
pytest

Contributing

Commit messages must follow the Conventional Commits format, since releases and the CHANGELOG.md are produced automatically by semantic-release. See AGENTS.md for the accepted commit types and project conventions.

License

The ansible-lint-gitlab project is distributed under the MIT license.