{"id":23248,"library":"ansible-dev-tools","title":"Ansible Development Tools","description":"A meta-package that bundles all essential tools for Ansible content creation and testing, including ansible-core, ansible-lint, molecule, and more. Current version 26.4.6 requires Python >=3.11 and adopts a new CLI entry point. Released roughly quarterly.","status":"active","version":"26.4.6","language":"python","source_language":"en","source_url":"https://github.com/ansible/ansible-dev-tools","tags":["ansible","devtools","testing","linting","molecule","automation"],"install":[{"cmd":"pip install ansible-dev-tools","lang":"bash","label":"Install from PyPI"},{"cmd":"pipx install ansible-dev-tools","lang":"bash","label":"Install with pipx (recommended)"}],"dependencies":[{"reason":"Core Ansible runtime","package":"ansible-core","optional":false},{"reason":"Linting and best-practices enforcement","package":"ansible-lint","optional":false},{"reason":"Testing and role/scenario management","package":"molecule","optional":false},{"reason":"Command-line tool for running Ansible in containers","package":"ansible-navigator","optional":false},{"reason":"Pytest plugin for Ansible tests","package":"pytest-ansible","optional":false}],"imports":[{"note":"The top-level package exposes a single class or entry, not a module.","wrong":"import ansible_dev_tools","symbol":"AnsibleDevTools","correct":"from ansible_dev_tools import AnsibleDevTools"},{"note":"The CLI is invoked via `ansible-dev-tools`, not a separate script.","wrong":"ansible-dev-tools-cli","symbol":"cli entry point","correct":"ansible-dev-tools --help"}],"quickstart":{"code":"from ansible_dev_tools import AnsibleDevTools\n\ntools = AnsibleDevTools()\nprint(tools.list_tools())","lang":"python","description":"Initialize the tools manager and list bundled tools."},"warnings":[{"fix":"Upgrade to Python 3.11 or later.","message":"Version 24.0.0 dropped Python 3.8 and 3.9 support. Requires Python >=3.10 (now 3.11+ in 26.x).","severity":"breaking","affected_versions":">=24.0.0"},{"fix":"Use `ansible-dev-tools --help` instead of `ansible-dev-tools-cli --help`.","message":"The CLI interface changed from `ansible-dev-tools-cli` to `ansible-dev-tools`. All command line invocations must be updated.","severity":"breaking","affected_versions":">=24.0.0"},{"fix":"Install ansible-dev-tools to get a compatible set, but do not rely on it for all Ansible dependencies.","message":"This is a meta-package; individual tools (like ansible-lint, molecule) must still be installed separately if not included. The meta-package pins compatible versions.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install ansible-dev-tools` in the correct virtual environment, or use `pipx install ansible-dev-tools`.","cause":"The package was not installed, or installed in a different Python environment.","error":"ModuleNotFoundError: No module named 'ansible_dev_tools'"},{"fix":"Ensure the package is installed. If using pipx, make sure `pipx ensurepath` was run. Or use `python -m ansible_dev_tools` instead.","cause":"The CLI entry point is missing because the package is not installed in the PATH's Python environment.","error":"Command 'ansible-dev-tools' not found"},{"fix":"Upgrade to the latest version: `pip install --upgrade ansible-dev-tools`","cause":"An older version installed (pre-24.0.0) where the class name was different or the import path was different.","error":"ImportError: cannot import name 'AnsibleDevTools' from 'ansible_dev_tools'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}