ae-core 0.3.76__tar.gz → 0.3.78__tar.gz

{ae_core-0.3.76 → ae_core-0.3.78}/LICENSE.md

@@ -1,4 +1,4 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.58 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.59 -->
 ### GNU GENERAL PUBLIC LICENSE
 
 Version 3, 29 June 2007

{ae_core-0.3.76/ae_core.egg-info → ae_core-0.3.78}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ae_core
-Version: 0.3.76
+Version: 0.3.78
 Summary: ae namespace module portion core: application core constants, helper functions and base classes
 Home-page: https://gitlab.com/ae-group/ae_core
 Author: AndiEcker
@@ -67,15 +67,15 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.100 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.21 -->
-# core 0.3.76
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.101 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.22 -->
+# core 0.3.78
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_core/develop?logo=python)](
     https://gitlab.com/ae-group/ae_core)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.76?logo=python)](
-    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.76)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.78?logo=python)](
+    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.78)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_core)](
     https://pypi.org/project/ae-core/#history)
 

{ae_core-0.3.76 → ae_core-0.3.78}/README.md

@@ -1,12 +1,12 @@
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.100 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.21 -->
-# core 0.3.76
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.101 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.22 -->
+# core 0.3.78
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_core/develop?logo=python)](
     https://gitlab.com/ae-group/ae_core)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.76?logo=python)](
-    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.76)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.78?logo=python)](
+    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.78)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_core)](
     https://pypi.org/project/ae-core/#history)
 

{ae_core-0.3.76 → ae_core-0.3.78}/ae/core.py

@@ -218,6 +218,7 @@ application code.
 .. _debug-level-constants:
 
 """
+# pylint: disable=too-many-lines
 import datetime
 import faulthandler
 import logging
@@ -230,7 +231,7 @@ import traceback
 import weakref
 
 from io import StringIO
-from typing import Any, Callable, Dict, List, Optional, TextIO, Tuple, Union, cast
+from typing import Any, Callable, Optional, TextIO, Union, cast
 
 from ae.base import (                                                                                   # type: ignore
     BUILD_CONFIG_FILE, DATE_TIME_ISO, DEF_ENCODE_ERRORS, PY_EXT, PY_INIT, PY_MAIN,
@@ -242,7 +243,7 @@ from ae.paths import (
 from ae.updater import check_all                                                                        # type: ignore
 
 
-__version__ = '0.3.76'
+__version__ = '0.3.78'
 
 
 # package and permissions handling defaults for all platforms and frameworks
@@ -268,7 +269,7 @@ if os_platform == 'android':  # pragma: no cover
     from android.permissions import request_permissions, Permission     # type: ignore # pylint: disable=import-error
     from jnius import autoclass                                         # type: ignore
 
-    def request_app_permissions(callback: Optional[Callable[[List[Permission], List[bool]], None]] = None):
+    def request_app_permissions(callback: Optional[Callable[[list[Permission], list[bool]], None]] = None):
         """ request app/service permissions on Android OS.
 
         :param callback:        optional callback receiving two list arguments with identical length,
@@ -321,11 +322,13 @@ DEBUG_LEVEL_DISABLED: int = 0       #: lowest debug level - only display logging
 DEBUG_LEVEL_ENABLED: int = 1        #: minimum debugging info - display logging levels WARNING or higher.
 DEBUG_LEVEL_VERBOSE: int = 2        #: verbose debug info - display logging levels INFO/DEBUG or higher.
 
-DEBUG_LEVELS: Dict[int, str] = {DEBUG_LEVEL_DISABLED: 'disabled', DEBUG_LEVEL_ENABLED: 'enabled',
+DEBUG_LEVELS: dict[int, str] = {DEBUG_LEVEL_DISABLED: 'disabled',
+                                DEBUG_LEVEL_ENABLED: 'enabled',
                                 DEBUG_LEVEL_VERBOSE: 'verbose'}
 """ numeric ids and names of all supported debug levels. """
 
-LOGGING_LEVELS: Dict[int, int] = {DEBUG_LEVEL_DISABLED: logging.WARNING, DEBUG_LEVEL_ENABLED: logging.INFO,
+LOGGING_LEVELS: dict[int, int] = {DEBUG_LEVEL_DISABLED: logging.WARNING,
+                                  DEBUG_LEVEL_ENABLED: logging.INFO,
                                   DEBUG_LEVEL_VERBOSE: logging.DEBUG}
 """ association between ae debug levels and python logging levels. """
 
@@ -367,6 +370,13 @@ def logger_late_init():
         _LOGGER = logging.getLogger(__name__)           # reset (_LOGGER = None) done in _unregister_app_instance()
 
 
+def logger_shutdown():
+    """ reset logger and logging module. """
+    global _LOGGER                                      # pylint: disable=global-statement
+    _LOGGER = None
+    logging.shutdown()
+
+
 _MULTI_THREADING_ACTIVATED: bool = False                #: flag if threading is used in your application
 
 
@@ -382,6 +392,7 @@ def _deactivate_multi_threading():
     _MULTI_THREADING_ACTIVATED = False
 
 
+# pylint: disable=too-many-arguments,too-many-branches,too-many-locals,too-many-statements
 def print_out(*objects, sep: str = " ", end: str = "\n", file: Optional[TextIO] = None, flush: bool = False,
               encode_errors_def: str = DEF_ENCODE_ERRORS, logger: Optional['logging.Logger'] = None,
               app: Optional['AppBase'] = None, **kwargs):
@@ -427,6 +438,7 @@ def print_out(*objects, sep: str = " ", end: str = "\n", file: Optional[TextIO]
     else:
         app = main_app
 
+    # pylint: disable=too-many-boolean-expressions
     if processing:
         file = ori_std_out
     elif logger is not None and file is None and (
@@ -477,6 +489,42 @@ def print_out(*objects, sep: str = " ", end: str = "\n", file: Optional[TextIO]
             break
 
 
+def debug_out(*objects, **kwargs):
+    """ print out if debug mode is enabled. if app instance is available, then use :meth:`AppBase.debug_out` instead.
+
+    :param objects:             see argument description of :meth:`AppBase.debug_out`.
+    :param kwargs:              see argument description of :meth:`AppBase.debug_out`.
+    """
+    getattr(main_app_instance(), 'debug_out', print_out)(*objects, **kwargs)
+
+
+def verbose_out(*objects, **kwargs):
+    """ print out if verbose debug mode is enabled. if app instance is available, then use :meth:`AppBase.verbose_out`.
+
+    :param objects:             see argument description of :meth:`AppBase.verbose_out`.
+    :param kwargs:              see argument description of :meth:`AppBase.verbose_out`.
+    """
+    getattr(main_app_instance(), 'verbose_out', print_out)(*objects, **kwargs)
+
+
+def is_debug() -> bool:
+    """ determine if the debug level of the main app instance is set/enabled.
+
+    :return:                    True if the debugging of the main app instance is enabled or if the app main instance
+                                did not get registered, else False (main app instance exists, but no debugging enabled).
+    """
+    return getattr(main_app_instance(), 'debug', True)
+
+
+def is_verbose() -> bool:
+    """ determine if the verbose debug level of the main app instance is set/enabled.
+
+    :return:                    True if the debugging of the main app instance is enabled or if the app main instance
+                                did not get registered, else False (main app exists, but no verbose debugging enabled).
+    """
+    return getattr(main_app_instance(), 'verbose', True)
+
+
 APP_KEY_SEP: str = '@'      #: separator character used in :attr:`~AppBase.app_key` of :class:`AppBase` instance
 
 # had to use type comment because the following line is throwing an error in the Sphinx docs make:
@@ -505,7 +553,7 @@ def main_app_instance() -> Optional['AppBase']:
         return _APP_INSTANCES.get(_MAIN_APP_INST_KEY)
 
 
-def registered_app_names() -> List[str]:
+def registered_app_names() -> list[str]:
     """ determine the app names of all registered/running applications. """
     with app_inst_lock:
         return [app.app_name for app in _APP_INSTANCES.values()]
@@ -541,8 +589,7 @@ def _unregister_app_instance(app_key: str) -> Optional['AppBase']:
     :return:                    removed :class:`AppBase` instance.
     """
     with app_inst_lock:
-        global _LOGGER                                  # pylint: disable=global-statement
-        _LOGGER = None
+        logger_shutdown()
 
         global _MAIN_APP_INST_KEY                       # pylint: disable=global-statement
         app = _APP_INSTANCES.pop(app_key, None)
@@ -563,7 +610,7 @@ def _shut_down_sub_app_instances(timeout: Optional[float] = None):
                                 acquisition of the threading locks of :data:`the ae log file <log_file_lock>` and the
                                 :data:`app instances <app_inst_lock>`.
     """
-    aqc_kwargs: Dict[str, Any] = ({'blocking': False} if timeout is None else {'timeout': timeout})
+    aqc_kwargs: dict[str, Any] = ({'blocking': False} if timeout is None else {'timeout': timeout})
     blocked = app_inst_lock.acquire(**aqc_kwargs)           # pylint: disable=consider-using-with
     for app in reversed(list(_APP_INSTANCES.values())):     # list() because the weak ref dict gets changed in the loop
         if not app.is_main:
@@ -591,7 +638,7 @@ class _PrintingReplicator:
         :param any_str:         string or bytes to output.
         """
         message = any_str.decode() if isinstance(any_str, bytes) else any_str
-        app_streams: List[Tuple[Optional[AppBase], TextIO]] = []
+        app_streams: list[tuple[Optional[AppBase], TextIO]] = []
         with log_file_lock, app_inst_lock:
             for app in list(_APP_INSTANCES.values()):
                 stream = app.log_file_check(app.active_log_stream)  # check if log rotation or buf-to-file-switch needed
@@ -649,7 +696,7 @@ def _join_app_threads(timeout: Optional[float] = None):
     _deactivate_multi_threading()
 
 
-class AppBase:
+class AppBase:  # pylint: disable=too-many-instance-attributes
     """ provides easy logging and debugging for your application.
 
     most applications only need a single instance of this class; apps with threads could create separate instances
@@ -693,9 +740,10 @@ class AppBase:
     _log_file_name: str = ""                        #: log file name
     _log_with_timestamp: Union[bool, str] = False   #: True of strftime format string to enable timestamp
     _nul_std_out: Optional[TextIO] = None           #: logging null stream
-    py_log_params: Dict[str, Any] = {}              #: dict of config parameters for py logging
+    py_log_params: dict[str, Any] = {}              #: dict of config parameters for py logging
     _shut_down: bool = False                        #: True if this app instance got shut down already
 
+    # pylint: disable=too-many-arguments,too-many-positional-arguments
     def __init__(self, app_title: str = '', app_name: str = '', app_version: str = '', sys_env_id: str = '',
                  debug_level: int = DEBUG_LEVEL_VERBOSE, multi_threading: bool = False, suppress_stdout: bool = False):
         """ initialize a new :class:`AppBase` instance.
@@ -749,7 +797,7 @@ class AppBase:
             else:                                                                           # pragma: no cover
                 self.vpo(f"AppBase.__init__() upgrade check skipped because {app_path=} != {cwd_path=}")
 
-    def _init_path_placeholders(self):
+    def _init_path_placeholders(self):  # pylint: disable=too-many-locals
         """ correct app_name/main_app_name, the related path placeholders and ensure write access for some of them. """
         # correct app name guess, init by :mod:`ae.paths` (main app from ("", 'pyTstConsAppKey', '_jb_pytest_runner'))
         PATH_PLACEHOLDERS['main_app_name'] = PATH_PLACEHOLDERS['app_name'] = app_name = self.app_name
@@ -881,7 +929,8 @@ class AppBase:
 
         return None
 
-    def init_logging(self, py_logging_params: Optional[Dict[str, Any]] = None, log_file_name: str = "",
+    # pylint: disable=too-many-arguments,too-many-positional-arguments
+    def init_logging(self, py_logging_params: Optional[dict[str, Any]] = None, log_file_name: str = "",
                      log_file_size_max: float = LOG_FILE_MAX_SIZE, log_with_timestamp: Union[bool, str] = False,
                      disable_buffering: bool = False):
         """ initialize the logging system.
@@ -1000,7 +1049,7 @@ class AppBase:
         :param kwargs:          all the other supported kwargs of this method are documented
                                 :func:`at the print_out() function of this module <print_out>`.
 
-        this method has an alias named :meth:`.po`
+        .. hint:: this method has an alias named :meth:`.po`
         """
         if file is None and main_app_instance() is not self:    # self.is_main==True when main_app_instance() is None
             with log_file_lock:
@@ -1013,23 +1062,16 @@ class AppBase:
 
     po = print_out          #: alias of method :meth:`.print_out`
 
-    def debug_out(self, *objects, minimum_debug_level: int = DEBUG_LEVEL_ENABLED, **kwargs):
-        """ special debug version of :func:`builtin print() function <print>`.
-
-        this method will print out the passed objects only if the :attr:`current debug level
-        <.core.AppBase.debug_level>` of this app instance is higher than the value passed into the
-        :paramref:`~debug_out.minimum_debug_level` argument. in this case the print-out will be
-        delegated onto the :meth:`~.print_out`.
+    def debug_out(self, *objects, **kwargs):
+        """ print objects if :attr:`the current debug level <.core.AppBase.debug_level>`of this app instance is enabled.
 
         :param objects:             objects to be printed out.
-        :param minimum_debug_level: minimum debug level to print the passed objects.
         :param kwargs:              all the supported kwargs of this method are documented at the
-                                    :func:`print_out() function <core.print_out>` of the :mod:`~ae.core` module
-                                    (including the :paramref:`~.print_out.file` argument).
+                                    :func:`print_out() function <core.print_out>`.
 
-        this method has an alias named :meth:`.dpo`.
+        .. hint:: this method has an alias named :meth:`.dpo`.
         """
-        if self.debug_level >= minimum_debug_level:
+        if self.debug_level >= DEBUG_LEVEL_ENABLED:
             self.po(*objects, **kwargs)
 
     dpo = debug_out         #: alias of method :meth:`.debug_out`
@@ -1043,7 +1085,7 @@ class AppBase:
                                 supported kwargs of this method are documented at the
                                 :func:`print_out() function <~ae.core.print_out>` of the :mod:`~.core` module.
 
-        this method has an alias named :meth:`.vpo`.
+        .. hint:: this method has an alias named :meth:`.vpo`.
         """
         if self.debug_level >= DEBUG_LEVEL_VERBOSE:
             self.po(*objects, **kwargs)
@@ -1061,11 +1103,13 @@ class AppBase:
         """
         if self._shut_down:
             return
-        aqc_kwargs: Dict[str, Any] = {'blocking': False} if timeout is None else {'timeout': timeout}
+        aqc_kwargs: dict[str, Any] = {'blocking': False} if timeout is None else {'timeout': timeout}
         is_main_app_instance = main_app_instance() is self      # self.is_main==True when main_app_instance() is None
         force = is_main_app_instance and exit_code              # prevent deadlock on app error exit/shutdown
 
         if exit_code is not None:
+            if not 0 <= exit_code <= 255:
+                self.po(f"  ### extended exit code {exit_code}! most shells only get 8 bits(0..255)=={exit_code % 256}")
             self.po(f"##### {'forced ' if force else ''}shutdown of {self.app_name} with {exit_code=}", logger=_LOGGER)
 
         # pylint: disable-next=consider-using-with
@@ -1119,7 +1163,9 @@ class AppBase:
                 else:
                     # pylint: disable-next=unspecified-encoding, consider-using-with
                     std_out = self._nul_std_out = open(os.devnull, 'w')
+                # noinspection PyInvalidCast
                 sys.stdout = cast(TextIO, _PrintingReplicator(sys_out_obj=std_out))
+                # noinspection PyInvalidCast
                 sys.stderr = cast(TextIO, _PrintingReplicator(sys_out_obj=ori_std_err))
         else:
             if is_main_app_instance:

{ae_core-0.3.76 → ae_core-0.3.78/ae_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ae_core
-Version: 0.3.76
+Version: 0.3.78
 Summary: ae namespace module portion core: application core constants, helper functions and base classes
 Home-page: https://gitlab.com/ae-group/ae_core
 Author: AndiEcker
@@ -67,15 +67,15 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.100 -->
-<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.21 -->
-# core 0.3.76
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.101 -->
+<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.22 -->
+# core 0.3.78
 
 [![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_core/develop?logo=python)](
     https://gitlab.com/ae-group/ae_core)
 [![LatestPyPIrelease](
-    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.76?logo=python)](
-    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.76)
+    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.78?logo=python)](
+    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.78)
 [![PyPIVersions](https://img.shields.io/pypi/v/ae_core)](
     https://pypi.org/project/ae-core/#history)
 

{ae_core-0.3.76 → ae_core-0.3.78}/pyproject.toml

@@ -1,4 +1,4 @@
-# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.58
+# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.59
 [build-system]
 requires = ["setuptools>=42", "wheel"]
 build-backend = "setuptools.build_meta"

{ae_core-0.3.76 → ae_core-0.3.78}/setup.py

@@ -1,4 +1,4 @@
-# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.58
+# THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.project_tpls v0.3.59
 """ setup of ae namespace module portion core: application core constants, helper functions and base classes. """
 # noinspection PyUnresolvedReferences
 import sys
@@ -23,15 +23,15 @@ setup_kwargs = {
     'install_requires': ['ae_base', 'ae_paths', 'ae_updater'],
     'keywords': ['configuration', 'development', 'environment', 'productivity'],
     'license': 'GPL-3.0-or-later',
-    'long_description': ('<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.100 -->\n'
- '<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.21 -->\n'
- '# core 0.3.76\n'
+    'long_description': ('<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project ae.ae v0.3.101 -->\n'
+ '<!-- THIS FILE IS EXCLUSIVELY MAINTAINED by the project aedev.namespace_root_tpls v0.3.22 -->\n'
+ '# core 0.3.78\n'
  '\n'
  '[![GitLab develop](https://img.shields.io/gitlab/pipeline/ae-group/ae_core/develop?logo=python)](\n'
  '    https://gitlab.com/ae-group/ae_core)\n'
  '[![LatestPyPIrelease](\n'
- '    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.76?logo=python)](\n'
- '    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.76)\n'
+ '    https://img.shields.io/gitlab/pipeline/ae-group/ae_core/release0.3.78?logo=python)](\n'
+ '    https://gitlab.com/ae-group/ae_core/-/tree/release0.3.78)\n'
  '[![PyPIVersions](https://img.shields.io/pypi/v/ae_core)](\n'
  '    https://pypi.org/project/ae-core/#history)\n'
  '\n'
@@ -108,7 +108,7 @@ setup_kwargs = {
         'Source': 'https://ae.readthedocs.io/en/latest/_modules/ae/core.html'},
     'python_requires': '>=3.9',
     'url': 'https://gitlab.com/ae-group/ae_core',
-    'version': '0.3.76',
+    'version': '0.3.78',
     'zip_safe': True,
 }
 

{ae_core-0.3.76 → ae_core-0.3.78}/tests/test_core.py

@@ -12,23 +12,53 @@ from typing import cast, Any, TextIO
 from unittest.mock import patch
 
 
-from ae.base import DATE_TIME_ISO, force_encoding, norm_path, read_file, write_file
+import ae.paths                 # for patch tests of ae.paths.PATH_PLACEHOLDERS
+import ae.core                  # for patch tests of ae.core.PATH_PLACEHOLDERS
+
+from ae.base import (
+    DATE_TIME_ISO, force_encoding, norm_path, os_path_dirname, os_path_isfile, os_path_splitext, read_file, write_file)
 from ae.paths import PATH_PLACEHOLDERS, placeholder_path, coll_folders, Collector
 # noinspection PyProtectedMember
 from ae.core import (
     APP_KEY_SEP, DEBUG_LEVELS, DEBUG_LEVEL_DISABLED, DEBUG_LEVEL_ENABLED, DEBUG_LEVEL_VERBOSE,
     LOG_FILE_IDX_WIDTH, MAX_NUM_LOG_FILES,
     activate_multi_threading, _deactivate_multi_threading, hide_dup_line_prefix, main_app_instance, print_out,
+    debug_out, verbose_out, is_debug, is_verbose,
     registered_app_names,
     AppBase, _PrintingReplicator)
-import ae.paths                 # for patch tests of ae.paths.PATH_PLACEHOLDERS
-import ae.core                  # for patch tests of ae.core.PATH_PLACEHOLDERS
 
 
 __version__ = '3.6.9dev-test'   # used for automatic app version find tests
 
 
 class TestCoreHelpers:
+    def test_debug_out(self, capsys, restore_app_env):
+        app = AppBase()
+        app.debug_level = DEBUG_LEVEL_VERBOSE
+
+        debug_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' in out
+        assert err == ""
+
+        app.debug_level = DEBUG_LEVEL_ENABLED
+
+        debug_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' in out
+        assert err == ""
+
+        app.debug_level = DEBUG_LEVEL_DISABLED
+
+        debug_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' not in out
+        assert out == ""
+        assert err == ""
+
     def test_hide_dup_line_prefix(self):
         l1 = "<t_s_t>"
         l2 = l1
@@ -39,6 +69,34 @@ class TestCoreHelpers:
         l2 = l1[:3] + l1
         assert hide_dup_line_prefix(l1, l2) == " " * 3 + l1
 
+    def test_is_debug(self, restore_app_env):
+        app = AppBase()
+        app.debug_level = DEBUG_LEVEL_DISABLED
+
+        assert not is_debug()
+
+        app.debug_level = DEBUG_LEVEL_ENABLED
+
+        assert is_debug()
+
+        app.debug_level = DEBUG_LEVEL_VERBOSE
+
+        assert is_debug()
+
+    def test_is_verbose(self, restore_app_env):
+        app = AppBase()
+        app.debug_level = DEBUG_LEVEL_DISABLED
+
+        assert not is_verbose()
+
+        app.debug_level = DEBUG_LEVEL_ENABLED
+
+        assert not is_verbose()
+
+        app.debug_level = DEBUG_LEVEL_VERBOSE
+
+        assert is_verbose()
+
     def test_print_out_basics(self, capsys):
         print_out()
         out, err = capsys.readouterr()
@@ -85,6 +143,34 @@ class TestCoreHelpers:
         assert len(registered_app_names()) == 1
         assert app.app_name == registered_app_names()[0]
 
+    def test_verbose_out(self, capsys, restore_app_env):
+        app = AppBase()
+        app.debug_level = DEBUG_LEVEL_VERBOSE
+
+        verbose_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' in out
+        assert err == ""
+
+        app.debug_level = DEBUG_LEVEL_ENABLED
+
+        verbose_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' not in out
+        assert out == ""
+        assert err == ""
+
+        app.debug_level = DEBUG_LEVEL_DISABLED
+
+        verbose_out('tst console output')
+
+        out, err = capsys.readouterr()
+        assert 'tst console output' not in out
+        assert out == ""
+        assert err == ""
+
 
 class TestPrintingReplicator:
     def test_init(self):
@@ -149,7 +235,7 @@ class TestAeLogging:
             for idx in range(MAX_NUM_LOG_FILES + 9):
                 for line_no in range(16):                   # full loop is creating 1 kB of log entries (16 * 64 bytes)
                     app.po("TestBaseLogEntry{: >26}{: >26}".format(idx, line_no))
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
         finally:
             assert delete_files(log_file, keep_ext=True) == MAX_NUM_LOG_FILES + 1
 
@@ -157,7 +243,7 @@ class TestAeLogging:
         log_file = 'test_ae_cov_log.log'
         valid_log_content = "TestBaseLogEntry"
         invalid_log_content = "NeverAppearInLogFile"
-        fb, ext = os.path.splitext(log_file)    # simulate a left-over log file from the last app run - coverage
+        fb, ext = os_path_splitext(log_file)    # simulate a left-over log file from the last app run - coverage
         idx = 1
         write_file(f"{fb}-{idx:0>{LOG_FILE_IDX_WIDTH}}{ext}",
                    f"log file content to test left-over from last app run{invalid_log_content}")
@@ -167,7 +253,7 @@ class TestAeLogging:
             for idx in range(MAX_NUM_LOG_FILES + 9):
                 for line_no in range(16):                   # full loop is creating 1 kB of log entries (16 * 64 bytes)
                     app.po(f"{valid_log_content}{idx: >26}{line_no: >26}")
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
         finally:
             contents = delete_files(log_file, keep_ext=True, ret_type='contents')
             assert len(contents) == MAX_NUM_LOG_FILES + 1
@@ -187,7 +273,7 @@ class TestAeLogging:
             for idx in range(MAX_NUM_LOG_FILES + 9):
                 for line_no in range(16):
                     app.po("TestBaseLogEntry{: >26}{: >26}".format(idx, line_no))
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
         finally:
             assert delete_files(log_file, keep_ext=True) == MAX_NUM_LOG_FILES + 1
 
@@ -201,7 +287,7 @@ class TestAeLogging:
             for idx in range(MAX_NUM_LOG_FILES + 9):
                 for line_no in range(16):
                     app.po("TestBaseLogEntry{: >26}{: >26}".format(idx, line_no))
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
         finally:
             assert delete_files(log_file, keep_ext=True) == MAX_NUM_LOG_FILES + 1
 
@@ -216,7 +302,7 @@ class TestAeLogging:
             out, err = capsys.readouterr()
             assert out == "" and err == ""
             app.init_logging()      # close the log file
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
             out, err = capsys.readouterr()
             assert out == "" and err == ""
         finally:
@@ -237,7 +323,7 @@ class TestAeLogging:
             out, err = capsys.readouterr()
             assert out == "" and err == ""
             app.init_logging()      # close the log file
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
             out, err = capsys.readouterr()
             assert out == "" and err == ""
         finally:
@@ -251,7 +337,7 @@ class TestAeLogging:
         app.init_logging(log_file_name=log_file)
         with pytest.raises(FileNotFoundError):
             app.log_file_check()     # coverage of callee exception
-        assert not os.path.exists(log_file)
+        assert not os_path_isfile(log_file)
 
     def test_log_file_flush(self, restore_app_env):
         log_file = 'test_ae_base_log_flush.log'
@@ -259,7 +345,7 @@ class TestAeLogging:
             app = AppBase('test_base_log_file_flush')
             app.init_logging(log_file_name=log_file)
             app.log_file_check()
-            assert os.path.exists(log_file)
+            assert os_path_isfile(log_file)
         finally:
             assert delete_files(log_file) == 1
 
@@ -281,8 +367,8 @@ class TestAeLogging:
             # NOT WORKING: capsys.readouterr() returning empty strings
             # out, err = capsys.readouterr()
             # assert out.count(tst_out) == 3 and err == ""
-            assert os.path.exists(mp + log_file)
-            assert os.path.exists(sp + log_file)
+            assert os_path_isfile(mp + log_file)
+            assert os_path_isfile(sp + log_file)
         finally:
             contents = delete_files(sp + log_file, ret_type='contents')
             assert len(contents)
@@ -323,8 +409,8 @@ class TestAeLogging:
             sub.init_logging()          # close the sub-app log file created by sub_thread
             sub_thread.join()
             app.init_logging()          # close the main-app log file
-            assert os.path.exists(sp + log_file)
-            assert os.path.exists(mp + log_file)
+            assert os_path_isfile(sp + log_file)
+            assert os_path_isfile(mp + log_file)
         finally:
             contents = delete_files(sp + log_file, ret_type='contents')
             assert len(contents)
@@ -340,6 +426,7 @@ class TestAeLogging:
     def test_exception_log_file_flush(self, restore_app_env):
         app = AppBase('test_exception_base_log_file_flush')
         # cause/provoke _append_eof_and_flush_file() exceptions for coverage by passing any other non-stream object
+        # noinspection PyInvalidCast
         app._append_eof_and_flush_file(cast(TextIO, None), 'invalid stream')
 
     def test_app_instances_reset2(self):
@@ -350,46 +437,40 @@ class TestPythonLogging:
     """ test python logging module support
     """
     def test_log_init(self, restore_app_env):
-        var_val = dict(version=1,
-                       disable_existing_loggers=False)
+        var_val = {'version': 1,
+                   'disable_existing_loggers': False}
         app = AppBase('log_init')
         app.init_logging(py_logging_params=var_val)
 
         assert app.py_log_params == var_val
 
-        logging.shutdown()
-
     def test_app_instances_reset1(self):
         assert main_app_instance() is None
 
     def test_logging_params_dict_console_from_init(self, restore_app_env):
-        var_val = dict(version=1,
-                       disable_existing_loggers=False,
-                       handlers=dict(console={'class': 'logging.StreamHandler',
-                                              'level': logging.INFO}))
+        var_val = {'version': 1,
+                   'disable_existing_loggers': False,
+                   'handlers': {'console': {'class': 'logging.StreamHandler',
+                                            'level': logging.INFO}}}
         print(str(var_val))
 
         main_app = AppBase('test_python_logging_params_dict_console')
         main_app.init_logging(py_logging_params=var_val)
 
         assert main_app.py_log_params == var_val
-        logging.shutdown()
 
     def test_logging_params_dict_console_from_init_with_log_file(self, restore_app_env):
         log_file = 'tst_py_log_complex.log'
-        entry_prefix = "TST LOG ENTRY "
-
-        var_val = dict(version=1,
-                       disable_existing_loggers=False,
-                       handlers=dict(console={'class': 'logging.handlers.RotatingFileHandler',
-                                              'level': logging.INFO,
-                                              'filename': log_file,
-                                              'maxBytes': 33,
-                                              'backupCount': 63}),
-                       loggers={'root': dict(handlers=['console']),
-                                'ae': dict(handlers=['console']),
-                                'ae.console': dict(handlers=['console'])}
-                       )
+        var_val = {'version': 1,
+                   'disable_existing_loggers': False,
+                   'handlers': {'console': {'class': 'logging.handlers.RotatingFileHandler',
+                                            'level': logging.INFO,
+                                            'filename': log_file,
+                                            'maxBytes': 33,
+                                            'backupCount': 63}},
+                   'loggers': {'root': {'handlers': ['console']},
+                               'ae': {'handlers': ['console']},
+                               'ae.console': {'handlers': ['console']}}}
         print(str(var_val))
 
         cae = AppBase('test_python_logging_params_dict_file', debug_level=DEBUG_LEVEL_DISABLED)
@@ -397,42 +478,24 @@ class TestPythonLogging:
 
         assert cae.py_log_params == var_val
 
-        # logging.shutdown()     TODO: encapsulate with _LOGGER = None into new method reset_logging() and add it to restore_app_env fixture ?!?!?
-
         # empty log file created by logging.config.dictConfig(py_logging_params) in :func:`ae.core.AppBase.init_logging`
         assert delete_files(log_file, ret_type='contents')[0] == ""
 
     def test_logging_params_dict_complex(self, restore_app_env):
-        """ test logging with rotating file handler, first refactored migrated from
-
-        TODO: investigate and fix the 4 commented out asserts in this test method
-        .. which found log_text via `pjm check` pytest in console as well as in pycharm pytest run
-        .. but in this test module (test_core.py) only the pjm/pytest run does not find log_text/log_files at all!
-        .. or shows them accumulated in a later test
-        Strange: a very similar test method did run fine with pjm&pycharm in ae_console/tests/test_console.py (v0.3.63)
-
-        Looks like the problem lies in pytest (previous version done with caplog had also empty .text)
-        .. but also in PyCharm, see:
-
-        * https://stackoverflow.com/questions/59875983
-        * https://github.com/pytest-dev/pytest/issues/3697
-        * https://youtrack.jetbrains.com/issue/PY-48743/Running-Pytest-is-not-showing-logging-output
-
-        """
+        """ test logging with rotating file handler. """
         log_file = 'test_py_log_complex.log'
         entry_prefix = "TEST LOG ENTRY "
 
-        var_val = dict(version=1,
-                       disable_existing_loggers=False,
-                       handlers=dict(console={'class': 'logging.handlers.RotatingFileHandler',
-                                              'level': logging.INFO,
-                                              'filename': log_file,
-                                              'maxBytes': 33,
-                                              'backupCount': 63}),
-                       loggers={'root': dict(handlers=['console']),
-                                'ae': dict(handlers=['console']),
-                                'ae.core': dict(handlers=['console'])}
-                       )
+        var_val = {'version': 1,
+                   'disable_existing_loggers': False,
+                   'handlers': {'console': {'class': 'logging.handlers.RotatingFileHandler',
+                                            'level': logging.INFO,
+                                            'filename': log_file,
+                                            'maxBytes': 33,
+                                            'backupCount': 63}},
+                   'loggers': {'root': {'handlers': ['console']},
+                               'ae': {'handlers': ['console']},
+                               'ae.core': {'handlers': ['console']}}}
         print(str(var_val))
 
         cae = AppBase('test_python_logging_params_dict_file', debug_level=DEBUG_LEVEL_DISABLED)
@@ -503,6 +566,7 @@ class TestPythonLogging:
             logging.shutdown()
             # pjm: assert delete_files(log_file) == 0
             # pycharm: assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
+            assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
 
         try:
             log_text = entry_prefix + "4 error logging"
@@ -511,6 +575,7 @@ class TestPythonLogging:
             logging.shutdown()
             # pjm: assert delete_files(log_file) == 0
             # pycharm: assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
+            assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
 
         # loggers
         try:
@@ -520,6 +585,7 @@ class TestPythonLogging:
             logging.shutdown()
             # pjm: assert delete_files(log_file) == 0
             # pycharm: assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
+            assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
 
         try:
             log_text = entry_prefix + "4 error ae"
@@ -540,15 +606,16 @@ class TestPythonLogging:
         # AppBase.debug_out/.dpo
         sys.argv = ['tl_cdc']  # sys.argv has to be set to allow get_option('debug_level') calls done by debug_out()
         try:
-            log_text = entry_prefix + "5 not logged dpo"
-            cae.dpo(log_text, minimum_debug_level=DEBUG_LEVEL_DISABLED)
+            log_text = entry_prefix + "5 not logged debug_out/dpo"
+            cae.dpo(log_text)
         finally:
             logging.shutdown()
             assert delete_files(log_file) == 0
 
+        # AppBase.print_out/.po
         try:
-            log_text = entry_prefix + "5 dpo"
-            cae.dpo(log_text, minimum_debug_level=DEBUG_LEVEL_DISABLED, logger=ae_cae_logger)
+            log_text = entry_prefix + "5 print_out/po"
+            cae.po(log_text, logger=ae_cae_logger)
         finally:
             logging.shutdown()
             assert delete_files(log_file, ret_type='contents')[0].endswith(log_text + os.linesep)
@@ -579,7 +646,7 @@ class TestAppBase:      # only some basic tests - test coverage is done by :clas
         app = AppBase(title, app_version=ver)
         assert app.app_title == title
         assert app.app_version == ver
-        assert app.app_path == norm_path(os.path.dirname(sys.argv[0]))
+        assert app.app_path == norm_path(os_path_dirname(sys.argv[0]))
 
     def test_app_find_version(self, restore_app_env):
         app = AppBase()
@@ -604,7 +671,7 @@ class TestAppBase:      # only some basic tests - test coverage is done by :clas
 
         _instance = _OtherClass()
         t_args = (1, 2, '3')
-        t_kwargs = dict(a=1, b=2, c='3')
+        t_kwargs = {'a': 1, 'b': 2, 'c': '3'}
         assert app.call_method(_instance._method, *t_args, **t_kwargs) == (_instance, t_args, t_kwargs)
 
     def test_call_method_no_exception_if_not_exists(self, restore_app_env):
@@ -648,6 +715,12 @@ class TestAppBase:      # only some basic tests - test coverage is done by :clas
         setattr(app, 'test_raiser', _raising_ex)
         app.call_method('test_raiser')
 
+    def test_debug_out(self, capsys, restore_app_env):
+        app = AppBase(debug_level=DEBUG_LEVEL_ENABLED)
+        tst = "tsT-debug-out-string"
+        app.debug_out(tst)
+        assert tst in capsys.readouterr()[0]
+
     def test_init_path_placeholders(self, restore_app_env):
         cae = AppBase("test_init_path_placeholders")
 
@@ -781,16 +854,46 @@ class TestAppBase:      # only some basic tests - test coverage is done by :clas
     def test_app_instances_reset2(self):
         assert main_app_instance() is None
 
+    def test_shutdown_none(self, capsys, restore_app_env):
+        app = AppBase(debug_level=DEBUG_LEVEL_DISABLED)
+
+        with patch('ae.core.sys.exit', lambda *args, **kwargs: None):
+            app.shutdown(None)
+
+        out, err = capsys.readouterr()
+        assert out == ""
+        assert err == ""
+
+    def test_shutdown_0(self, capsys, restore_app_env):
+        app = AppBase(debug_level=DEBUG_LEVEL_ENABLED)
+
+        with patch('ae.core.sys.exit', lambda *args, **kwargs: None):
+            app.shutdown()  # exit_code == 0
+
+        out, err = capsys.readouterr()
+        assert 'shutdown of ' in out
+        assert err == ""
+
+    def test_shutdown_1(self, capsys, restore_app_env):
+        app = AppBase(debug_level=DEBUG_LEVEL_VERBOSE)
+
+        with patch('ae.core.sys.exit', lambda *args, **kwargs: None):
+            app.shutdown(1)
+
+        assert 'shutdown of ' in capsys.readouterr()[0]
+
+    def test_shutdown_123456(self, capsys, restore_app_env):
+        app = AppBase()
+
+        with patch('ae.core.sys.exit', lambda *args, **kwargs: None):
+            app.shutdown(123456)    # test warning if exit code is not in 0..255
+
+        assert 'extended exit code' in capsys.readouterr()[0]
+
     def test_verbose(self, capsys, restore_app_env):
         app = AppBase(debug_level=DEBUG_LEVEL_VERBOSE)
         assert app.verbose
 
-    def test_debug_out(self, capsys, restore_app_env):
-        app = AppBase(debug_level=DEBUG_LEVEL_ENABLED)
-        tst = "tsT-debug-out-string"
-        app.debug_out(tst)
-        assert tst in capsys.readouterr()[0]
-
     def test_verbose_out(self, capsys, restore_app_env):
         app = AppBase(debug_level=DEBUG_LEVEL_ENABLED)
         tst = "tsT-debug-miss-string"