antsibull-core

What it is and what it does

antsibull-core is a library that provides shared build and tooling infrastructure for the Ansible project and related distribution-building tasks. It handles common patterns needed across Ansible's build scripts—changelog management, versioning, file utilities, and release automation—rather than being a user-facing Ansible feature. The package depends on aiohttp for async HTTP operations, pydantic for data validation, semantic-version for version parsing, and several other utilities for file handling and logging.

The library is actively maintained by the Ansible community and follows semantic versioning from version 1.0.0 onward, with the current development series at 3.x.y. It requires Python 3.9 or later and is typed for static analysis. The package is primarily intended for developers working on Ansible tooling and build infrastructure.

Use it for:

• Building custom Ansible distributions or collections that need standardized versioning and changelog management
• Automating release workflows for Ansible-related projects using the provided build and publishing utilities
• Integrating with Ansible project infrastructure when developing tools that need to interact with Ansible's build system
• Validating and processing Ansible project metadata using pydantic-based data structures

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides core library utilities and tooling infrastructure for building Ansible distributions and related build automation scripts.

Yes, if you are developing Ansible tooling or building Ansible distributions. The package is actively maintained, has low install friction, and provides essential build infrastructure. No, if you are a general Ansible user—this is a developer library for the Ansible project itself, not an Ansible feature or plugin. The copyleft license requires your project to be GPL-compatible.

Install

antsibull-core on PyPI

pip install antsibull-core

uv add antsibull-core

poetry add antsibull-core

Installing antsibull-core

Before you install

Low install friction with a pure-Python wheel distribution. Active maintenance with a release 27 days ago. Requires Python 3.9 or later and depends on 9 runtime packages including aiohttp and pydantic.

License in practice

Copyleft license (GPL-3.0-or-later) with mixed licensing in vendored code (BSD-2-Clause, MIT, PSF-2.0). Use is restricted to GPL-compatible projects unless you obtain alternative licensing.

Quickstart

pip install antsibull-core
import antsibull_core

Requires Python 3.9 or later

Verify before relying

• Whether the package is intended for end-user consumption or primarily for Ansible project maintainers
• Specific API stability guarantees beyond the semantic versioning statement in the description

Package facts

Evidence: antsibull_core-3.6.0-py3-none-any.whl

Tags

More Build Tools packages