Skip to main content

Tools for building the Ansible Distribution

Project description

antsibull -- Ansible Build Scripts

Python linting badge Python testing badge dumb PyPI on GH pages badge Codecov badge

Tooling for building various things related to Ansible

Scripts that are here:

  • antsibull-build - Builds Ansible-2.10+ from component collections (docs)
  • antsibull-lint - Soon to be deprecated; collection docs linting functionality is now part of antsibull-docs, and changelogs/changelog.yaml validation functionality is now part of antsibull-changelog.

This also includes a Sphinx extension sphinx_antsibull_ext which provides a minimal CSS file to render the output of antsibull-docs correctly.

Related projects are antsibull-changelog and antsibull-docs, which are in their own repositories (antsibull-changelog repository, antsibull-docs repository). Currently both are dependencies of antsibull. Therefore, the scripts contained in them will be available as well when installing antsibull.

You can find a list of changes in the Antsibull changelog.

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

antsibull is covered by the Ansible Code of Conduct.

Versioning and compatibility

From version 0.1.0 on, antsibull sticks to semantic versioning and aims at providing no backwards compatibility breaking changes to the command line API (antsibull and antsibull-lint) during a major release cycle. We might make exceptions from this in case of security fixes for vulnerabilities that are severe enough.

We explicitly exclude code compatibility. antsibull is not supposed to be used as a library. The only exception are potential dependencies with other antsibull projects (currently, none). If you want to use a certain part of antsibull-docs as a library, please create an issue so we can discuss whether we add a stable interface for parts of the Python code. We do not promise that this will actually happen though.

Running from source

Please note that to run antsibull from source, you need to install some related projects adjacent to the antsibull checkout. More precisely, assuming you checked out the antsibull repository in a directory ./antsibull/, you need to check out the following projects in the following locations:

This can be done as follows:

git clone https://github.com/ansible-community/antsibull-changelog.git
git clone https://github.com/ansible-community/antsibull-core.git
git clone https://github.com/ansible-community/antsibull-docs.git
git clone https://github.com/ansible-community/antsibull.git
cd antsibull

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

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).

Creating a new release:

If you want to create a new release::

vim pyproject.toml  # Make sure the correct version number is used
vim changelogs/fragment/$VERSION_NUMBER.yml  # create 'release_summary:' fragment
antsibull-changelog release --version $VERSION_NUMBER
git add CHANGELOG.rst changelogs
git commit -m "Release $VERSION_NUMBER."
poetry build
poetry publish  # Uploads to pypi.  Be sure you really want to do this

git tag $VERSION_NUMBER
git push --tags
vim pyproject.toml  # Bump the version number to X.Y.Z.post0
git commit -m 'Update the version number for the next release' pyproject.toml
git push

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

antsibull-0.49.0.tar.gz (62.7 kB view details)

Uploaded Source

Built Distribution

antsibull-0.49.0-py3-none-any.whl (84.5 kB view details)

Uploaded Python 3

File details

Details for the file antsibull-0.49.0.tar.gz.

File metadata

  • Download URL: antsibull-0.49.0.tar.gz
  • Upload date:
  • Size: 62.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.5 Linux/5.18.14-arch1-1

File hashes

Hashes for antsibull-0.49.0.tar.gz
Algorithm Hash digest
SHA256 662985c159085b6505db3dcb2251b61dc1425f3122b13b3f4d3aa8c0ea5fd86d
MD5 979888a1f765e8a61e917d947d68cb87
BLAKE2b-256 9f43c3fe6f28fd71a5fa0bb16f7a725b4076de2657819a8c630f2ece2f132550

See more details on using hashes here.

Provenance

File details

Details for the file antsibull-0.49.0-py3-none-any.whl.

File metadata

  • Download URL: antsibull-0.49.0-py3-none-any.whl
  • Upload date:
  • Size: 84.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.5 Linux/5.18.14-arch1-1

File hashes

Hashes for antsibull-0.49.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5651fe2620682122d9e7350833bcbb2d37f6c3a9f35ef8151b5a22486ebe25b2
MD5 ef6eecc7f651f68083da41c3ae527a9f
BLAKE2b-256 2a153c2d7ecf4426bb2068e9518798dbd48165eb21da02ece71c4d2248b76994

See more details on using hashes here.

Provenance

Supported by

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