Metadata-Version: 2.4
Name: molecule-pve
Version: 0.9.0
Summary: Ansible Collection of Util-Modules for the Ansible-Molecule Proxmox-VE Driver
Author-email: Pascal Rath <rath+moleculepve@oxl.at>
License: The MIT License (MIT)
        
        Copyright (c) 2019 Sorin Sbarnea
        Copyright (c) 2022 Sine Nomine Associates
        Copyright (c) 2026 Pascal Rath
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
Project-URL: Homepage, https://github.com/O-X-L/ansible-molecule-pve
Project-URL: Documentation, https://ansible-molecule-pve.oxl.app
Project-URL: Repository, https://github.com/O-X-L/ansible-molecule-pve.git
Project-URL: Issues, https://github.com/O-X-L/ansible-molecule-pve/issues
Keywords: ansible,ansible-molecule,ansible-molecule-driver,ansible-testing
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Framework :: Ansible
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ansible-core
Requires-Dist: molecule
Requires-Dist: proxmoxer>=1.3.1
Requires-Dist: PyYAML
Requires-Dist: requests
Dynamic: license-file

# Ansible-Molecule Proxmox-VE Driver

[![Lint](https://github.com/O-X-L/ansible-molecule-pve/actions/workflows/lint.yml/badge.svg?branch=latest)](https://github.com/O-X-L/ansible-molecule-pve/actions/workflows/lint.yml)
[![Check Docs](https://github.com/O-X-L/ansible-molecule-pve/actions/workflows/check_docs.yml/badge.svg?branch=latest)](https://github.com/O-X-L/ansible-molecule-pve/actions/workflows/check_docs.yml)


This repository holds an Ansible-Molecule driver for Proxmox-VE.

It enables you to dynamically create VM's on latest Proxmox-VE nodes and target them with integration-tests. 

----

## Install

[PyPi](https://pypi.org/project/molecule-pve/)

First, you have to install these ansible-collections:

```bash
ansible-galaxy collection install community.proxmox>=2.0.0
ansible-galaxy collection install oxlorg.molecule_pve

# or
ansible-galaxy collection install git+https://github.com/ansible-collections/community.proxmox.git,2.0.0
ansible-galaxy collection install git+https://github.com/O-X-L/ansible-molecule-pve-utils.git
```

Then you can install the molecule driver itself:

```bash
pip install --upgrade molecule-pve

# or
pip install --upgrade git+https://github.com/O-X-L/ansible-molecule-pve
```

----

## Documentation

[![Docs Uptime](https://status.oxl.at/api/v1/endpoints/1--oxl_ansible-molecule-pve-docs/uptimes/30d/badge.svg)](https://status.oxl.at/endpoints/1--oxl_ansible-molecule-pve-docs)

See: [ansible-molecule-pve.oxl.app](https://ansible-molecule-pve.oxl.app)

----

## Contribute

You are welcome to [report issues/bugs](https://github.com/O-X-L/ansible-molecule-pve-utils/issues) and/or [supply patches/features drafts](https://github.com/O-X-L/ansible-molecule-pve-utils/pulls).

When contributing via PR's, please mention if/how you used AI and if so - how you reviewed/tested those auto-generated changes.

----

## Authors / Credits

This is a fork or the [molecule-proxmox](http://pypi.org/project/molecule-proxmox), which was originally created by [Michael Meffie](https://github.com/meffie).

It was modified and enhanced by [Pascal Rath](https://github.com/superstes).

We decided to create this fork, as the original module is not in a functional state with current default ansible-installations.

So we refactored it to make it work with the currently supported [community.proxmox](https://docs.ansible.com/projects/ansible/latest/collections/community/proxmox/index.html) Ansible-collection.

We also implemented some enhancements:

* async/parallel creation/start/destroy of Test-VMs to speed-up execution
* support form platform-specific `/etc/hosts` entries
* some config-sanity checks

----

## AI Usage

AI is used to speed-up development. All changes are reviewed, logically evaluated and tested manually.
