molecule-libvirt-ng 1.0.0__tar.gz

molecule_libvirt_ng-1.0.0/.flake8

@@ -0,0 +1,8 @@
+[flake8]
+# do not add excludes for files in repo
+exclude = .venv/,.tox/,dist/,build/,.eggs/
+format = pylint
+# E203: https://github.com/python/black/issues/315
+ignore = E741,W503,W504,H,E501,E203
+# 88 is official black default:
+max-line-length = 88

molecule_libvirt_ng-1.0.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @ssbarnea @jamesregis

molecule_libvirt_ng-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  pypi:
+    name: Publish to PyPI registry
+    environment: release
+    runs-on: ubuntu-latest
+
+    env:
+      FORCE_COLOR: 1
+      PY_COLORS: 1
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: python3 -m pip install --user build twine
+      - name: Check out src from Git
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Build dists
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

molecule_libvirt_ng-1.0.0/.github/workflows/tox.yml

@@ -0,0 +1,51 @@
+name: tox
+
+on:
+  push:
+    branches:
+      - "main"
+    tags-ignore:
+      - "**"
+  pull_request:
+
+jobs:
+  build:
+    name: ${{ matrix.tox_env }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - tox_env: lint
+            python-version: "3.12"
+          - tox_env: py310
+            python-version: "3.10"
+          - tox_env: py311
+            python-version: "3.11"
+          - tox_env: py312
+            python-version: "3.12"
+          - tox_env: py313
+            python-version: "3.13"
+          - tox_env: packaging
+            python-version: "3.12"
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libvirt-dev pkg-config
+      - name: Install dependencies
+        run: |
+          python -m pip install -U pip
+          pip install tox
+      - name: Run tox
+        env:
+          TOX_ENV: ${{ matrix.tox_env }}
+        run: tox -e "$TOX_ENV"

molecule_libvirt_ng-1.0.0/.gitignore

@@ -0,0 +1,129 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/

molecule_libvirt_ng-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+---
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks.git
+    rev: v5.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: mixed-line-ending
+      - id: check-byte-order-marker
+      - id: check-executables-have-shebangs
+      - id: check-merge-conflict
+      - id: debug-statements
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.35.1
+    hooks:
+      - id: yamllint
+        files: \.(yaml|yml)$
+        types: [file, yaml]
+        entry: yamllint --strict
+  - repo: https://github.com/codespell-project/codespell.git
+    rev: v2.4.1
+    hooks:
+      - id: codespell

molecule_libvirt_ng-1.0.0/.yamllint

@@ -0,0 +1,19 @@
+extends: default
+ignore: |
+  .tox
+
+rules:
+  braces:
+    max-spaces-inside: 1
+    level: error
+  brackets:
+    max-spaces-inside: 1
+    level: error
+  comments:
+    min-spaces-from-content: 1
+  comments-indentation: disable
+  document-start: disable
+  line-length: disable
+  octal-values:
+    forbid-implicit-octal: true
+    forbid-explicit-octal: true

molecule_libvirt_ng-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 PyContribs
+
+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.

molecule_libvirt_ng-1.0.0/PKG-INFO

@@ -0,0 +1,222 @@
+Metadata-Version: 2.4
+Name: molecule-libvirt-ng
+Version: 1.0.0
+Summary: libvirt Molecule Plugin :: run molecule tests on libvirt
+Author-email: Ansible by Red Hat <info@ansible.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/codanael/molecule-libvirt
+Project-URL: Bug Tracker, https://github.com/codanael/molecule-libvirt/issues
+Project-URL: Source Code, https://github.com/codanael/molecule-libvirt
+Keywords: ansible,roles,testing,molecule,plugin,libvirt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: molecule>=24.2.0
+Requires-Dist: pyyaml>=5.1
+Requires-Dist: jmespath
+Requires-Dist: lxml
+Requires-Dist: netaddr
+Requires-Dist: pycdlib
+Provides-Extra: test
+Requires-Dist: molecule[test]; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+***********************
+Molecule libvirt Plugin
+***********************
+
+.. image:: https://badge.fury.io/py/molecule-libvirt.svg
+   :target: https://badge.fury.io/py/molecule-libvirt
+   :alt: PyPI Package
+
+.. image:: https://zuul-ci.org/gated.svg
+   :target: https://dashboard.zuul.ansible.com/t/ansible/builds?project=ansible-community/molecule
+
+.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+   :target: https://github.com/python/black
+   :alt: Python Black Code Style
+
+.. image:: https://img.shields.io/badge/Code%20of%20Conduct-Ansible-silver.svg
+   :target: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
+   :alt: Ansible Code of Conduct
+
+.. image:: https://img.shields.io/badge/Mailing%20lists-Ansible-orange.svg
+   :target: https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information
+   :alt: Ansible mailing lists
+
+.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
+   :target: LICENSE
+   :alt: Repository License
+
+Molecule libvirt is designed to allow use of libvirt for provisioning test
+resources.
+
+Please note that this driver is currently in its early stage of development,
+do not even try to install or use it until this message is removed.
+
+.. _quickstart:
+
+Quickstart
+==========
+
+Installation
+------------
+.. code-block:: bash
+
+   pip install molecule-libvirt
+
+Create a scenario
+-----------------
+
+With a new role
+^^^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   molecule init role -d libvirt my-role
+
+This will create a new folder *my-role* containing a bare-bone generated
+role like you would do with ``ansible-galaxy init`` command.
+
+It will also contain a molecule folder with a default scenario
+using the libvirt driver (using ansible community.libvirt collection).
+
+Install the collection using:
+
+``ansible-galaxy install -r test_requirements.yml``.
+
+Example
+-------
+This is a `molecule.yml` example file
+
+.. code-block:: yaml
+
+  dependency:
+  name: galaxy
+  driver:
+    name: libvirt
+  platforms:
+    - name: instance-1
+      cpu: 1
+      cpu_model: "qemu64"
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      disk_size: "10G"
+      ssh_port: 22
+      memory_size: "1" # in GB
+    - name: instance-2
+      memory: "1"
+      cpus: 1
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      libvirt_host: "server.home.lan"
+      libvirt_user: "james"
+      bridge_name: "bridge0"
+    - name: instance-3
+      memory: "1"
+      cpus: 1
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      libvirt_host: "server.home.lan"
+      libvirt_user: "james"
+      bridge_name: "bridge0"
+  provisioner:
+    name: ansible
+  verifier:
+    name: ansible
+
+Optional parameters
+-------------------
+
+``molecule_bridge``: existing bridge on local host. Can be useful if you
+want to set network interface name created for molecule.
+default value is: **molecule-br0**.
+
+``molecule_network_cidr``: ip address range that should be bind to molecule
+virtual network.
+default value is: **10.10.10.0/24**.
+
+``qemu_user``: qemu process user. On RHEL like system qemu user is **qemu**.
+On Debian like, qemu user is **libvirt-qemu**.
+default value is: **qemu**.
+
+``cpu_model``: specifies CPU model requested by the guest virtual machine.
+default is : **qemu64**.
+
+``arch``: specifying the CPU architecture to virtualization. default is
+**x86_64**.
+
+``timezone``: vm's timezone. default is **America/Toronto**.
+
+``bridge_name``: existing bridge on remote host. This bridge should allow VM
+being reachable with an ip address.
+
+``libvirt_host`` and ``libvirt_user``: remote host parameters. **libvirt_user**
+should belongs to *libvirt* group.
+
+Once set, you will have to run:
+
+.. code-block:: bash
+
+   molecule test
+
+
+Documentation
+=============
+
+Read the documentation and more at https://molecule.readthedocs.io/.
+
+.. _get-involved:
+
+Get Involved
+============
+
+* Join us in the ``#ansible-molecule`` channel on `Freenode`_.
+* Join the discussion in `molecule-users Forum`_.
+* Join the community working group by checking the `wiki`_.
+* Want to know about releases, subscribe to `ansible-announce list`_.
+* For the full list of Ansible email Lists, IRC channels see the
+  `communication page`_.
+
+.. _`Freenode`: https://freenode.net
+.. _`molecule-users Forum`: https://groups.google.com/forum/#!forum/molecule-users
+.. _`wiki`: https://github.com/ansible/community/wiki/Molecule
+.. _`ansible-announce list`: https://groups.google.com/group/ansible-announce
+.. _`communication page`: https://docs.ansible.com/ansible/latest/community/communication.html
+
+.. _authors:
+
+Authors
+=======
+
+* James Regis
+* Gaëtan Trellu
+* Gariele Cerami
+* Sorin Sbarnea
+
+.. _license:
+
+License
+=======
+
+The `MIT`_ License.
+
+.. _`MIT`: https://github.com/ansible/molecule/blob/master/LICENSE
+
+The logo is licensed under the `Creative Commons NoDerivatives 4.0 License`_.
+
+If you have some other use in mind, contact us.
+
+.. _`Creative Commons NoDerivatives 4.0 License`: https://creativecommons.org/licenses/by-nd/4.0/

molecule_libvirt_ng-1.0.0/README.rst

@@ -0,0 +1,184 @@
+***********************
+Molecule libvirt Plugin
+***********************
+
+.. image:: https://badge.fury.io/py/molecule-libvirt.svg
+   :target: https://badge.fury.io/py/molecule-libvirt
+   :alt: PyPI Package
+
+.. image:: https://zuul-ci.org/gated.svg
+   :target: https://dashboard.zuul.ansible.com/t/ansible/builds?project=ansible-community/molecule
+
+.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+   :target: https://github.com/python/black
+   :alt: Python Black Code Style
+
+.. image:: https://img.shields.io/badge/Code%20of%20Conduct-Ansible-silver.svg
+   :target: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
+   :alt: Ansible Code of Conduct
+
+.. image:: https://img.shields.io/badge/Mailing%20lists-Ansible-orange.svg
+   :target: https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information
+   :alt: Ansible mailing lists
+
+.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
+   :target: LICENSE
+   :alt: Repository License
+
+Molecule libvirt is designed to allow use of libvirt for provisioning test
+resources.
+
+Please note that this driver is currently in its early stage of development,
+do not even try to install or use it until this message is removed.
+
+.. _quickstart:
+
+Quickstart
+==========
+
+Installation
+------------
+.. code-block:: bash
+
+   pip install molecule-libvirt
+
+Create a scenario
+-----------------
+
+With a new role
+^^^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   molecule init role -d libvirt my-role
+
+This will create a new folder *my-role* containing a bare-bone generated
+role like you would do with ``ansible-galaxy init`` command.
+
+It will also contain a molecule folder with a default scenario
+using the libvirt driver (using ansible community.libvirt collection).
+
+Install the collection using:
+
+``ansible-galaxy install -r test_requirements.yml``.
+
+Example
+-------
+This is a `molecule.yml` example file
+
+.. code-block:: yaml
+
+  dependency:
+  name: galaxy
+  driver:
+    name: libvirt
+  platforms:
+    - name: instance-1
+      cpu: 1
+      cpu_model: "qemu64"
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      disk_size: "10G"
+      ssh_port: 22
+      memory_size: "1" # in GB
+    - name: instance-2
+      memory: "1"
+      cpus: 1
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      libvirt_host: "server.home.lan"
+      libvirt_user: "james"
+      bridge_name: "bridge0"
+    - name: instance-3
+      memory: "1"
+      cpus: 1
+      image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
+      libvirt_host: "server.home.lan"
+      libvirt_user: "james"
+      bridge_name: "bridge0"
+  provisioner:
+    name: ansible
+  verifier:
+    name: ansible
+
+Optional parameters
+-------------------
+
+``molecule_bridge``: existing bridge on local host. Can be useful if you
+want to set network interface name created for molecule.
+default value is: **molecule-br0**.
+
+``molecule_network_cidr``: ip address range that should be bind to molecule
+virtual network.
+default value is: **10.10.10.0/24**.
+
+``qemu_user``: qemu process user. On RHEL like system qemu user is **qemu**.
+On Debian like, qemu user is **libvirt-qemu**.
+default value is: **qemu**.
+
+``cpu_model``: specifies CPU model requested by the guest virtual machine.
+default is : **qemu64**.
+
+``arch``: specifying the CPU architecture to virtualization. default is
+**x86_64**.
+
+``timezone``: vm's timezone. default is **America/Toronto**.
+
+``bridge_name``: existing bridge on remote host. This bridge should allow VM
+being reachable with an ip address.
+
+``libvirt_host`` and ``libvirt_user``: remote host parameters. **libvirt_user**
+should belongs to *libvirt* group.
+
+Once set, you will have to run:
+
+.. code-block:: bash
+
+   molecule test
+
+
+Documentation
+=============
+
+Read the documentation and more at https://molecule.readthedocs.io/.
+
+.. _get-involved:
+
+Get Involved
+============
+
+* Join us in the ``#ansible-molecule`` channel on `Freenode`_.
+* Join the discussion in `molecule-users Forum`_.
+* Join the community working group by checking the `wiki`_.
+* Want to know about releases, subscribe to `ansible-announce list`_.
+* For the full list of Ansible email Lists, IRC channels see the
+  `communication page`_.
+
+.. _`Freenode`: https://freenode.net
+.. _`molecule-users Forum`: https://groups.google.com/forum/#!forum/molecule-users
+.. _`wiki`: https://github.com/ansible/community/wiki/Molecule
+.. _`ansible-announce list`: https://groups.google.com/group/ansible-announce
+.. _`communication page`: https://docs.ansible.com/ansible/latest/community/communication.html
+
+.. _authors:
+
+Authors
+=======
+
+* James Regis
+* Gaëtan Trellu
+* Gariele Cerami
+* Sorin Sbarnea
+
+.. _license:
+
+License
+=======
+
+The `MIT`_ License.
+
+.. _`MIT`: https://github.com/ansible/molecule/blob/master/LICENSE
+
+The logo is licensed under the `Creative Commons NoDerivatives 4.0 License`_.
+
+If you have some other use in mind, contact us.
+
+.. _`Creative Commons NoDerivatives 4.0 License`: https://creativecommons.org/licenses/by-nd/4.0/