Skip to main content

Tools for building the Ansible Distribution

Project description

antsibull -- Ansible Build Scripts

Tooling for building various things related to Ansible

Scripts that are here:

  • antsibull-build - Builds Ansible-2.10+ from component collections (docs)
  • antsibull-docs - Extracts documentation from ansible plugins
  • antsibull-lint - Right now only validates changelogs/changelog.yaml files (docs)

A related project is antsibull-changelog, which is in its own repository.

Scripts are created by poetry at build time. So if you want to run from a checkout, you'll have to run them under poetry::

python3 -m pip install poetry
poetry install  # Installs dependencies into a virtualenv
poetry run antsibull-build --help

If you want to create a new release::

poetry build
poetry publish  # Uploads to pypi.  Be sure you really want to do this

.. note:: When installing a package published by poetry, it is best to use pip >= 19.0. Installing with pip-18.1 and below could create scripts which use pkg_resources which can slow down startup time (in some environments by quite a large amount).

Unless otherwise noted in the code, it is licensed under the terms of the GNU General Public License v3 or, at your option, later.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page