antsibull-fileutils

What it is and what it does

antsibull-fileutils is a utility library built for the Ansible community to support file operations in tooling that builds or processes Ansible distributions. It wraps aiofiles for async file I/O and integrates pyyaml for YAML handling, providing a shared foundation so that multiple Ansible tools don't duplicate file-handling logic.

The package is actively maintained under semantic versioning, supports modern Python versions (3.9 through 3.14), and is fully typed. It carries a copyleft GPL-3.0-or-later license with additional BSD-2-Clause, MIT, and PSF-2.0 components, making it suitable for open-source and internal Ansible tooling but requiring license compatibility review before use in proprietary software.

Use it for:

• Building or maintaining Ansible distribution tooling that needs consistent async file I/O patterns
• Processing YAML configuration files in Ansible community tools with async support
• Sharing file utility code across multiple Ansible-related projects to reduce duplication

Worth the install?

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

Provides file utility functions for Ansible community tools, with async file operations and YAML handling built on aiofiles and pyyaml.

Yes, if you are building or maintaining Ansible community tools. Low install friction, active maintenance, no known vulnerabilities, and full type support make it a solid dependency. The copyleft license is a non-issue for open-source Ansible work but requires review for proprietary use.

Install

antsibull-fileutils on PyPI

pip install antsibull-fileutils

uv add antsibull-fileutils

poetry add antsibull-fileutils

Installing antsibull-fileutils

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a release 54 days ago and commits through August 2026. Supports current Python versions (3.9–3.14) and is typed.

License in practice

Licensed under GPL-3.0-or-later with additional BSD-2-Clause, MIT, and PSF-2.0 components. Copyleft treatment means derivative works must be distributed under compatible terms; suitable for internal or open-source Ansible tooling but requires license review for proprietary use.

Quickstart

pip install antsibull-fileutils

import antsibull_fileutils
# Specific usage depends on the public API exposed by the package

Requires Python 3.9 or later; intended for use within Ansible community tooling ecosystems.

Verify before relying

• What specific file operations and utilities are exposed by the public API
• Whether async file operations are the primary interface or a secondary feature
• How the YAML handling integrates with pyyaml beyond basic dependency inclusion

Package facts

Evidence: antsibull_fileutils-1.5.3-py3-none-any.whl

Tags

More Build Tools packages