[PR #11222/c7f6a28d backport][stable-12] Add basic typing for module_utils (#11243)

Add basic typing for module_utils (#11222)

* Add basic typing for module_utils.

* Apply some suggestions.



* Make pass again.

* Add more types as suggested.

* Normalize extra imports.

* Add more type hints.

* Improve typing.

* Add changelog fragment.

* Reduce changelog.

* Apply suggestions from code review.



* Fix typo.

* Cleanup.

* Improve types and make type checking happy.

* Let's see whether older Pythons barf on this.

* Revert "Let's see whether older Pythons barf on this."

This reverts commit 9973af3dbe.

* Add noqa.

---------


(cherry picked from commit c7f6a28d89)

Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>

plugins/module_utils/utm_utils.py

@@ -12,18 +12,19 @@
 from __future__ import annotations
 
 import json
+import typing as t
 
 from ansible.module_utils.basic import AnsibleModule
 from ansible.module_utils.urls import fetch_url
 
 
 class UTMModuleConfigurationError(Exception):
-    def __init__(self, msg, **args):
+    def __init__(self, msg: str, **args):
         super().__init__(self, msg)
         self.msg = msg
         self.module_fail_args = args
 
-    def do_fail(self, module):
+    def do_fail(self, module: AnsibleModule) -> t.NoReturn:
         module.fail_json(msg=self.msg, other=self.module_fail_args)
 
 
@@ -75,7 +76,7 @@ class UTMModule(AnsibleModule):
 
 
 class UTM:
-    def __init__(self, module, endpoint, change_relevant_keys, info_only=False):
+    def __init__(self, module: UTMModule, endpoint, change_relevant_keys, info_only=False):
         """
         Initialize UTM Class
         :param module: The Ansible module