Add type hints and type checking (#885)

* Enable basic type checking.

* Fix first errors.

* Add changelog fragment.

* Add types to module_utils and plugin_utils (without module backends).

* Add typing hints for acme_* modules.

* Add typing to X.509 certificate modules, and add more helpers.

* Add typing to remaining module backends.

* Add typing for action, filter, and lookup plugins.

* Bump ansible-core 2.19 beta requirement for typing.

* Add more typing definitions.

* Add typing to some unit tests.

plugins/modules/openssl_publickey_info.py

@@ -152,6 +152,7 @@ public_data:
       returned: When RV(type=DSA) or RV(type=ECC)
 """
 
+import typing as t
 
 from ansible.module_utils.basic import AnsibleModule
 from ansible_collections.community.crypto.plugins.module_utils.crypto.basic import (
@@ -163,7 +164,7 @@ from ansible_collections.community.crypto.plugins.module_utils.crypto.module_bac
 )
 
 
-def main():
+def main() -> t.NoReturn:
     module = AnsibleModule(
         argument_spec=dict(
             path=dict(type="path"),
@@ -191,7 +192,7 @@ def main():
                 data = f.read()
         except (IOError, OSError) as e:
             module.fail_json(
-                msg=f"Error while reading public key file from disk: {e}", **result
+                msg=f"Error while reading public key file from disk: {e}", **result  # type: ignore
             )
 
     module_backend = select_backend(module, data)
@@ -201,7 +202,7 @@ def main():
         module.exit_json(**result)
     except PublicKeyParseError as exc:
         result.update(exc.result)
-        module.fail_json(msg=exc.error_message, **result)
+        module.fail_json(msg=exc.error_message, **result)  # type: ignore
     except OpenSSLObjectError as exc:
         module.fail_json(msg=str(exc))