ansible-dev-environment

What it is and what it does

ansible-dev-environment (ade) is a workspace isolation tool for Ansible collection development. It creates project-specific virtual environments and manages both Ansible collections and their Python dependencies, solving the problem of version conflicts when developing multiple collections with different requirements. The tool installs collections into the virtual environment's site-packages, making them discoverable by Ansible, Python tooling, and pytest while keeping them isolated from global collection directories.

The core problem it addresses is Ansible's collection search path behavior: Ansible prioritizes global collection locations (like ~/.ansible/collections) over virtual environment paths, causing silent version conflicts where your development code is overridden by older global versions. ade provides three isolation modes—cfg (default, creates ansible.cfg), restrictive (fails if global collections exist), and none—to ensure your virtual environment's collections take precedence. It complements ansible-galaxy by handling Python package dependencies that collections require, creating reproducible development setups across team members.

Use it for:

• Develop a collection with specific Python package versions (e.g., requests==2.25.0) without affecting other projects on the same machine
• Set up a reproducible development environment for a team where each developer uses the same collection and dependency versions
• Test a collection against multiple Python versions (3.10, 3.11, 3.12, 3.13) by creating separate virtual environments with --python
• Install a collection in editable mode with symlinks for active development, allowing code changes to be immediately reflected
• Prevent debugging confusion caused by Ansible loading older collection versions from global paths instead of your development code
• Manage complex dependency trees where collections have conflicting requirements that would fail in a shared environment

Worth the install?

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

Creates isolated virtual environments for Ansible collection development, managing collection installation, Python dependencies, and workspace isolation to prevent version conflicts.

Yes. The package is actively maintained (released 2 days ago), production-stable, has no known vulnerabilities, and solves a real problem in Ansible collection development—preventing version conflicts through workspace isolation. Low installation friction and broad Python version support (3.10–3.13) make it accessible. The copyleft license is a consideration only if you plan to redistribute modifications; for development use, it poses no barrier.

Install

ansible-dev-environment on PyPI

pip install ansible-dev-environment

uv add ansible-dev-environment

poetry add ansible-dev-environment

Installing ansible-dev-environment

Before you install

Low friction installation with a pure Python wheel. Active maintenance—released 2 days ago with 72 repository stars. Requires Python 3.10 or later and depends on ansible-builder, bindep, pyyaml, and subprocess-tee, all standard tools in the Ansible ecosystem.

License in practice

Licensed under GPL-3.0-only (copyleft). Any modifications or derivative works must be distributed under the same license; proprietary use is not permitted.

Quickstart

pip install ansible-dev-environment

cd /path/to/collection
ade install -e . --venv .venv

# Activate and use
source .venv/bin/activate
ansible-playbook playbooks/test.yml

Requires Python 3.10 or later; ansible-builder, bindep, pyyaml, and subprocess-tee must be installable in the target environment.

Verify before relying

• Whether the tool works with all Ansible core versions or has specific version constraints beyond what the description states
• Performance characteristics when managing large numbers of collections or complex dependency trees
• Compatibility with non-CPython implementations (PyPy, etc.) despite Python 3.10+ support

Package facts

Evidence: ansible_dev_environment-26.8.0-py3-none-any.whl

Keywords: ansible

Tags

More Software Development packages