more lazy load & stubs for __init__

Author: penguinolog

exec_helpers/__init__.py

@@ -21,15 +21,6 @@
 import typing
 import warnings
 
-# Local Implementation
-from .exceptions import CalledProcessError
-from .exceptions import ExecCalledProcessError
-from .exceptions import ExecHelperError
-from .exceptions import ExecHelperNoKillError
-from .exceptions import ExecHelperTimeoutError
-from .exceptions import ParallelCallExceptionsError
-from .exceptions import ParallelCallProcessError
-
 try:
     # Local Implementation
     from ._version import version as __version__
@@ -38,13 +29,6 @@
 
 # noinspection PyUnresolvedReferences
 __all__ = (
-    "ExecHelperError",
-    "ExecCalledProcessError",
-    "CalledProcessError",
-    "ParallelCallExceptionsError",
-    "ParallelCallProcessError",
-    "ExecHelperNoKillError",
-    "ExecHelperTimeoutError",
     # pylint: disable=undefined-all-variable
     # lazy load
     # API
@@ -59,13 +43,26 @@
     "SSHAuth",
     "SSHConfig",
     "HostsSSHConfigs",
+    # Exceptions
+    "exceptions",
+    "ExecHelperError",
+    "ExecCalledProcessError",
+    "CalledProcessError",
+    "ParallelCallExceptionsError",
+    "ParallelCallProcessError",
+    "ExecHelperNoKillError",
+    "ExecHelperTimeoutError",
     # deprecated
     "ParallelCallExceptions",
 )
 
 __locals: typing.Dict[str, typing.Any] = locals()  # use mutable access for pure lazy loading
 
-__lazy_load_modules: typing.Sequence[str] = ("async_api",)
+__lazy_load_modules: typing.Sequence[str] = (
+    "async_api",
+    "exceptions",
+    "exec_result",
+)
 
 __lazy_load_parent_modules: typing.Dict[str, str] = {
     "HostsSSHConfigs": "_ssh_helpers",
@@ -78,6 +75,14 @@
     "ExecResult": "exec_result",
     "ExecHelper": "api",
     "mask_command": "_helpers",
+    # Exceptions
+    "ExecHelperError": "exceptions",
+    "ExecCalledProcessError": "exceptions",
+    "CalledProcessError": "exceptions",
+    "ParallelCallExceptionsError": "exceptions",
+    "ParallelCallProcessError": "exceptions",
+    "ExecHelperNoKillError": "exceptions",
+    "ExecHelperTimeoutError": "exceptions",
     "ParallelCallExceptions": "exceptions",
 }
 

exec_helpers/__init__.pyi

@@ -0,0 +1,90 @@
+#    Copyright 2018 - 2021 Alexey Stepanov aka penguinolog.
+
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+
+#         http://www.apache.org/licenses/LICENSE-2.0
+
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+"""Execution helpers for simplified usage of subprocess and ssh."""
+
+from __future__ import annotations
+
+# Standard Library
+import typing
+
+# Local Implementation
+from . import async_api
+from ._helpers import mask_command
+from ._ssh_helpers import HostsSSHConfigs
+from ._ssh_helpers import SSHConfig
+from .api import ExecHelper
+from .exceptions import CalledProcessError
+from .exceptions import ExecCalledProcessError
+from .exceptions import ExecHelperError
+from .exceptions import ExecHelperNoKillError
+from .exceptions import ExecHelperTimeoutError
+from .exceptions import ParallelCallExceptions
+from .exceptions import ParallelCallExceptionsError
+from .exceptions import ParallelCallProcessError
+from .exec_result import ExecResult
+from .proc_enums import ExitCodes
+from .ssh import SSHClient
+from .ssh_auth import SSHAuth
+from .subprocess import Subprocess  # nosec  # Expected
+
+try:
+    # Local Implementation
+    from ._version import version as __version__
+except ImportError:
+    pass
+
+# noinspection PyUnresolvedReferences
+__all__ = (
+    # pylint: disable=undefined-all-variable
+    # lazy load
+    # API
+    "async_api",
+    "ExitCodes",
+    "ExecResult",
+    "ExecHelper",
+    "mask_command",
+    # Expensive
+    "Subprocess",
+    "SSHClient",
+    "SSHAuth",
+    "SSHConfig",
+    "HostsSSHConfigs",
+    # Exceptions
+    "ExecHelperError",
+    "ExecCalledProcessError",
+    "CalledProcessError",
+    "ParallelCallExceptionsError",
+    "ParallelCallProcessError",
+    "ExecHelperNoKillError",
+    "ExecHelperTimeoutError",
+    # deprecated
+    "ParallelCallExceptions",
+)
+
+_deprecated: typing.Dict[str, str] = ...
+
+def __getattr__(name: str) -> typing.Any:
+    """Get attributes lazy.
+
+    :return: attribute by name
+    :raises AttributeError: attribute is not defined for lazy load
+    """
+
+__author__: str = ...
+__author_email__: str = ...
+__maintainers__: typing.Dict[str, str] = ...
+__url__: str = ...
+__description__: str = ...
+__license__: str = ...

exec_helpers/async_api/__init__.pyi

@@ -0,0 +1,46 @@
+#    Copyright 2018 - 2021 Alexey Stepanov aka penguinolog.
+
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+
+#         http://www.apache.org/licenses/LICENSE-2.0
+
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+"""Execution helpers for simplified usage of subprocess. Async version.
+
+.. versionadded:: 3.0.0
+"""
+
+# noinspection PyUnresolvedReferences
+__all__ = (
+    # pylint: disable=undefined-all-variable
+    # lazy load
+    # API
+    "ExecHelper",
+    "ExecResult",
+    # Expensive
+    "Subprocess",
+)
+
+# Standard Library
+import typing
+
+# Local Implementation
+from .api import ExecHelper
+from .exec_result import ExecResult
+from .subprocess import Subprocess  # nosec  # Expected
+
+_deprecated: typing.Dict[str, str] = ...
+
+def __getattr__(name: str) -> typing.Any:
+    """Get attributes lazy.
+
+    :return: attribute by name
+    :raises AttributeError: attribute is not defined for lazy load
+    """