Metadata-Version: 2.1
Name: molecule-virtup
Version: 1.2.0
Summary: virt-up Molecule Plugin :: run molecule tests using virt-up
Home-page: https://github.com/meffie/molecule-virtup
Author: Michael Meffie
Author-email: mmeffie@sinenomine.net
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: molecule (>=3.2.0)
Requires-Dist: pyyaml (<6,>=5.1)

**********************
Molecule VirtUp Plugin
**********************

Molecule VirtUp is designed to allow use of `virt-up`_ for provisioning of
molecule test guests on a `libvirt` based hypervisor.  The `libvirt` hypervisor
may be local or remote.

See `virt-up`_ for installation instructions.

.. _`virt-up`: https://github.com/meffie/virt-up.git

Requires
========

On the hypervisor (local or remote)
* libvirt based hypervisor
* ssh server and connection credentials if remote
* python virt_up module and dependencies

Supported libvirt providers:
* qemu/KVM
* XEN

Documentation
=============

To use this plugin, you'll need to set the ``driver`` and ``platform``
variables in your ``molecule.yml``. Here's a simple example using the
``generic/centos8`` template:

.. code-block:: yaml

   driver:
     name: virtup

   platforms:
     - name: instance
       template: generic/centos8
       memory: 512
       cpus: 1

Authors
=======

Molecule Virt-Up Plugin was created by Michael Meffie based on code from
Molecule.

License
=======

The `MIT`_ License.

.. _`MIT`: https://github.com/meffie/molecule-virtup/blob/master/LICENSE


