feature: integrate pytest-molecule plugin

.config/requirements.in

@@ -1,2 +1,3 @@
 coverage
 pytest>=6,<8.0.0
+

.config/requirements.txt

@@ -1,17 +1,23 @@
 #
-# This file is autogenerated by pip-compile with Python 3.7
+# This file is autogenerated by pip-compile with Python 3.9
 # by the following command:
 #
 #    pip-compile --extra=docs --extra=test --no-annotate --output-file=.config/requirements.txt --resolver=backtracking --strip-extras --unsafe-package=ruamel-yaml-clib pyproject.toml
 #
+ansible-core==2.15.0
 attrs==22.2.0
+cffi==1.15.1
 coverage==7.2.2
+cryptography==40.0.2
 exceptiongroup==1.1.1
-importlib-metadata==6.6.0
+importlib-resources==5.0.7
 iniconfig==2.0.0
+jinja2==3.1.2
+markupsafe==2.1.2
 packaging==23.0
 pluggy==1.0.0
+pycparser==2.21
 pytest==7.2.2
+pyyaml==6.0
+resolvelib==1.0.1
 tomli==2.0.1
-typing-extensions==4.5.0
-zipp==3.15.0

.vscode/settings.json

@@ -2,12 +2,13 @@
   "[python]": {
     "editor.codeActionsOnSave": {
       "source.organizeImports": true
-    }
+    },
+    "editor.defaultFormatter": "ms-python.black-formatter"
   },
   "editor.formatOnSave": true,
   "isort.check": false,
   "prettier.enable": false,
-  "python.formatting.provider": "black",
+  "python.formatting.provider": "none",
   "python.linting.flake8Enabled": true,
   "python.linting.mypyEnabled": true,
   "python.linting.pylintEnabled": true,

molecule/default/INSTALL.rst

@@ -0,0 +1,15 @@
+***********************************
+Delegated driver installation guide
+***********************************
+
+Requirements
+============
+
+This driver is delegated to the developer.  Up to the developer to implement
+requirements.
+
+Install
+=======
+
+This driver is delegated to the developer.  Up to the developer to implement
+requirements.

molecule/default/converge.yml

@@ -0,0 +1,8 @@
+---
+- name: Converge
+  hosts: all
+  gather_facts: false
+  tasks:
+    - name: "Include pytest-ansible"
+      ansible.builtin.include_role:
+        name: "pytest-ansible"

molecule/default/create.yml

@@ -0,0 +1,36 @@
+---
+- name: Create
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  tasks:
+    # TODO: Developer must implement and populate 'server' variable
+
+    - when: server.changed | default(false) | bool
+      block:
+        - name: Populate instance config dict
+          ansible.builtin.set_fact:
+            instance_conf_dict:
+              {
+                "instance": "{{ }}",
+                "address": "{{ }}",
+                "user": "{{ }}",
+                "port": "{{ }}",
+                "identity_file": "{{ }}",
+              }
+          with_items: "{{ server.results }}"
+          register: instance_config_dict
+
+        - name: Convert instance config dict to a list
+          ansible.builtin.set_fact:
+            instance_conf: "{{ instance_config_dict.results | map(attribute='ansible_facts.instance_conf_dict') | list }}"
+
+        - name: Dump instance config
+          ansible.builtin.copy:
+            content: |
+              # Molecule managed
+
+              {{ instance_conf | to_json | from_json | to_yaml }}
+            dest: "{{ molecule_instance_config }}"
+            mode: 0600

molecule/default/destroy.yml

@@ -0,0 +1,24 @@
+---
+- name: Destroy
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  tasks:
+    # Developer must implement.
+
+    # Mandatory configuration for Molecule to function.
+
+    - name: Populate instance config
+      ansible.builtin.set_fact:
+        instance_conf: {}
+
+    - name: Dump instance config
+      ansible.builtin.copy:
+        content: |
+          # Molecule managed
+
+          {{ instance_conf | to_json | from_json | to_yaml }}
+        dest: "{{ molecule_instance_config }}"
+        mode: 0600
+      when: server.changed | default(false) | bool

molecule/default/molecule.yml

@@ -0,0 +1,32 @@
+---
+dependency:
+  name: galaxy
+  state: present
+
+driver:
+  name: delegated
+
+platforms:
+  - name: instance
+
+verifier:
+  name: ansible
+
+provisioner:
+  name: ansible
+  log: true
+  config_options:
+    defaults:
+      interpreter_python: auto
+      verbosity: 1
+
+scenario:
+  name: test_scenario
+  test_sequence:
+    - lint
+    - dependency
+    - syntax
+    - create
+    - prepare
+    - converge
+    - verify

molecule/default/verify.yml

@@ -0,0 +1,10 @@
+---
+# This is an example playbook to execute Ansible tests.
+
+- name: Verify
+  hosts: all
+  gather_facts: false
+  tasks:
+    - name: Example assertion
+      ansible.builtin.assert:
+        that: true

pyproject.toml

@@ -90,6 +90,7 @@ disable = [
   "too-many-branches",
   "too-many-locals",
   "too-many-statements",
+  "too-few-public-methods",
   "unexpected-keyword-arg",
   "unused-argument",
   "invalid-name",