feat(panos_state_snapshot): allow dict config element for snapshots (#632)

also removed unused `noqa` in eda/logs.py for tox/ruff error in CI

Author: alperenkose

extensions/eda/plugins/event_source/logs.py

@@ -33,7 +33,7 @@
 
 """
 
-# ruff: noqa: UP001, UP010, FA102
+# ruff: noqa: UP001, UP010
 from __future__ import absolute_import, division, print_function
 
 # pylint: disable-next=invalid-name

plugins/modules/panos_state_snapshot.py

@@ -47,9 +47,13 @@
         description:
             - A list of Firewall state areas that we should take a snapshot of. For the details on currently supported list please refer to
               L(package documentation, https://pan.dev/panos/docs/panos-upgrade-assurance/configuration-details/#state-snapshots).
+            - In most of the cases it is enough to specify a snapshot name to run it with default settings.
+              In this case the list element is of type B(str). If additional configuration is required the element is a single element B(dict),
+              where key is the state snapshot name and value contains the snapshot's configuration. For information which snapshot requires additional
+              configuration please refer to L(package documentation, https://pan.dev/panos/docs/panos-upgrade-assurance/configuration-details/#state-snapshots).
             - To capture the actual snapshot data use a register.
         type: list
-        elements: str
+        elements: raw
         default: ["all"]
 """
 
@@ -133,7 +137,7 @@ def main():
         with_classic_provider_spec=True,
         min_panos_upgrade_assurance_version=MIN_PUA_VER,
         argument_spec=dict(
-            state_areas=dict(type="list", default=["all"], elements="str")
+            state_areas=dict(type="list", default=["all"], elements="raw")
         ),
         panorama_error="This is a firewall only module",
     )

pyproject.toml

@@ -20,7 +20,7 @@ pan-os-python = ">=1.8,<2.0"
 xmltodict = ">=0.12.0,<0.15.0"
 aiohttp = ">=3.8.4,<4.0"
 dpath = ">=2.1.5,<3.0"
-panos-upgrade-assurance = ">=1.0,<2.0"
+panos-upgrade-assurance = ">=1.4,<2.0"
 
 [tool.poetry.dev-dependencies]
 black = ">=22.3.0"

requirements.txt

@@ -1,5 +1,5 @@
 aiohttp>=3.8.4,<4.0 ; python_version >= "3.10" and python_version < "4.0"
 dpath>=2.1.5,<3.0 ; python_version >= "3.10" and python_version < "4.0"
 pan-os-python>=1.8,<2.0 ; python_version >= "3.10" and python_version < "4.0"
-panos-upgrade-assurance>=1.0,<2.0 ; python_version >= "3.10" and python_version < "4.0"
+panos-upgrade-assurance>=1.4,<2.0 ; python_version >= "3.10" and python_version < "4.0"
 xmltodict>=0.12.0,<0.15.0 ; python_version >= "3.10" and python_version < "4.0"