molecule-vagrant

What it is and what it does

Molecule Vagrant Plugin is a driver for the Molecule testing framework that uses Vagrant to provision and manage test instances. It allows developers to define test scenarios in molecule.yml that spin up virtual machines via Vagrant (supporting providers like VirtualBox, libvirt, and Parallels) and then run Molecule's test sequence against those instances.

The plugin integrates Vagrant's configuration model directly into Molecule, letting you specify box images, network interfaces, resource allocation, and raw Vagrant provisioning directives. It depends on molecule, python-vagrant for Vagrant CLI interaction, and standard Python libraries like pyyaml and Jinja2 for configuration templating. The package requires Python 3.9 or later and is known to work on macOS with VirtualBox and Fedora/Ubuntu with libvirt, though Vagrant's CLI installation can be problematic on some platforms.

Use it for:

• Test Ansible roles and playbooks across multiple OS distributions by defining Vagrant boxes in molecule.yml
• Set up multi-node test environments with custom networking, forwarded ports, and synced folders for integration testing
• Run Molecule tests locally on developer machines using VirtualBox or on CI systems with libvirt
• Configure raw Vagrant provisioning steps and provider-specific options directly within Molecule scenarios

Worth the install?

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

Molecule Vagrant Plugin enables Vagrant-based provisioning and testing of infrastructure for Ansible molecule test scenarios, integrating Vagrant as a driver for test resource orchestration.

No. The package is abandoned (last release 2023-01-06, repository archived) with no maintenance for 1316 days. While it carries no known vulnerabilities and has permissive licensing, the lack of updates means it will not track Molecule, Ansible, or Vagrant ecosystem changes. Use only if locked into an existing project already using this version.

Install

molecule-vagrant on PyPI

pip install molecule-vagrant

uv add molecule-vagrant

poetry add molecule-vagrant

Installing molecule-vagrant

Before you install

Low install friction with a pure-Python wheel distribution. However, the package is abandoned as of January 2023 with no recent maintenance; the underlying Vagrant CLI dependency is known to have platform-specific installation issues on some systems.

License in practice

MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source contexts.

Quickstart

pip install molecule-vagrant

In molecule.yml:
driver:
  name: vagrant
platforms:
  - name: instance
    box: fedora/32-cloud-base
    memory: 512
    cpus: 1

Requires Vagrant CLI to be installed and functional on the host system; Vagrant installation is known to be problematic on some platforms including CentOS 8.

Verify before relying

• Compatibility with recent Molecule and Ansible versions given the January 2023 last release
• Status of the five runtime dependencies in current ecosystems
• Whether the package works with modern Vagrant versions and providers

Package facts

Evidence: molecule_vagrant-2.0.0-py3-none-any.whl

Keywords: ansible, roles, testing, molecule, plugin, vagrant

Tags

More Utilities packages