---
id: antsibull-fileutils
version: "1.5.3"
license: GPL-3.0-or-later AND BSD-2-Clause AND MIT AND PSF-2.0
license_treatment: copyleft
maintenance: active
---

# antsibull-fileutils — Tools for building the Ansible Distribution

License: copyleft · Maintenance: active · Downloads: 362.0K/mo

## 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 above — 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

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

- License: GPL-3.0-or-later AND BSD-2-Clause AND MIT AND PSF-2.0 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 362.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ansible file utilities, async file operations, community ansible tools, file handling library, ansible build tools, ansible, async-io, community-maintained

[View on SkillFed](https://skillfed.io/packages/antsibull-fileutils) · [View on PyPI](https://pypi.org/project/antsibull-fileutils/)