holado 0.13.22__py3-none-any.whl

holado_json/ipc/json_types.py

@@ -0,0 +1,183 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+import logging
+import json
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from json.decoder import JSONDecodeError
+import base64
+from holado_python.standard_library.typing import Typing
+from typing import get_args, get_type_hints
+from holado_core.common.handlers.features.resource_by_type import FeatureClassResourceByType
+from holado.common.handlers.undefined import undefined_value
+import inspect
+
+logger = logging.getLogger(__name__)
+
+
+# Define managed json types
+
+class JsonTypes(FeatureClassResourceByType):
+    @classmethod
+    def _get_class_resource_description(cls, plural=False):
+        if plural:
+            return 'json types'
+        else:
+            return 'json type'
+    
+    @classmethod
+    def _new_parents(cls, parents, class_, **kwargs):
+        if parents is None:
+            res = []
+        else:
+            res = list(parents)
+        res.append( (class_, kwargs) )
+        return res
+
+
+# Register default json types
+
+JsonTypes.register_resource_for_type_in_class('primitive', lambda c: c in [int, float, bool, type(None)], None, 
+                   (lambda x: x, lambda x: x, None))
+JsonTypes.register_resource_for_type_in_class('bytes', lambda c: inspect.isclass(c) and issubclass(c, bytes), None, 
+                   (base64.b64decode, base64.b64encode, None))
+
+
+def _to_json_from_str(value):
+    try:
+        return json.loads(value)
+    except JSONDecodeError:
+        return value
+
+JsonTypes.register_resource_for_type_in_class('str', lambda c: inspect.isclass(c) and issubclass(c, str), None, 
+                   (lambda x: x, _to_json_from_str, None))
+
+
+def _from_json_to_Dict(obj_json, class_, _parents=None, converter=None):
+    if not isinstance(obj_json, dict):
+        raise TechnicalException(f"Argument 'obj_json' must be a dict")
+    if converter is None:
+        from holado_json.ipc.json_converter import JsonConverter
+        converter = JsonConverter()
+    
+    # Define key and value types if they are available, else type of of key and value will be used
+    args = get_args(class_)
+    if len(args) > 0:
+        if len(args) != 2:
+            raise TechnicalException(f"Unmanaged convert from json to {Typing.get_class_fullname(class_)}: 2 type arguments are expected (obtained type arguments: {args})")
+        key_type, value_type = args
+    else:
+        # Use object type of each dict key & value
+        key_type, value_type = None, None
+    
+    res = {}
+    for k, v in obj_json.items():
+        key = converter.from_json_to(k, key_type, _parents=JsonTypes._new_parents(_parents, class_, name=k, index=0))
+        value = converter.from_json_to(v, value_type, _parents=JsonTypes._new_parents(_parents, class_, name=k, index=1))
+        res[key] = value
+    
+    return res
+
+def _to_json_from_dict_or_list(value):
+    try:
+        tmp = json.dumps(value)
+        return json.loads(tmp)
+    except JSONDecodeError:
+        return value
+    
+JsonTypes.register_resource_for_type_in_class('Dict', lambda c: inspect.isclass(c) and issubclass(c, dict), None, 
+                   (None, _to_json_from_dict_or_list, _from_json_to_Dict))
+
+
+def _from_json_to_List(obj_json, class_, _parents=None, converter=None):
+    if not isinstance(obj_json, list):
+        raise TechnicalException(f"Argument 'obj_json' must be a list")
+    if converter is None:
+        from holado_json.ipc.json_converter import JsonConverter
+        converter = JsonConverter()
+    
+    element_type = get_args(class_)[0]
+    
+    res = []
+    for index, el in enumerate(obj_json):
+        res_el = converter.from_json_to(el, element_type, _parents=JsonTypes._new_parents(_parents, class_, index=index))
+        res.append(res_el)
+    
+    return res
+
+JsonTypes.register_resource_for_type_in_class('List', lambda c: inspect.isclass(c) and issubclass(c, list), None, 
+                        (None, _to_json_from_dict_or_list, _from_json_to_List))
+
+
+def _from_json_to_NamedTuple(obj_json, class_, _parents=None, converter=None):
+    if not isinstance(obj_json, dict):
+        raise TechnicalException(f"Argument 'obj_json' must be a dict")
+    if converter is None:
+        from holado_json.ipc.json_converter import JsonConverter
+        converter = JsonConverter()
+    
+    kwargs = {}
+    for name, type_ in get_type_hints(class_).items():
+        if name not in obj_json:
+            raise TechnicalException(f"No field '{name}' in json object (existing fields: {list(obj_json.keys())})")
+        value = converter.from_json_to(obj_json[name], type_, _parents=JsonTypes._new_parents(_parents, class_, name=name))
+        kwargs[name] = value
+        
+    return class_(**kwargs)
+
+JsonTypes.register_resource_for_type_in_class('NamedTuple', lambda c: Typing.is_NamedTuple(class_=c), None, 
+                        (None, None, _from_json_to_NamedTuple))
+
+
+def _from_json_to_object(obj_json, class_, _parents=None, converter=None):
+    if not isinstance(obj_json, dict):
+        raise TechnicalException(f"Argument 'obj_json' must be a dict")
+    if converter is None:
+        from holado_json.ipc.json_converter import JsonConverter
+        converter = JsonConverter()
+    
+    res = undefined_value
+    
+    # Try with constructor having all dict keys as arguments
+    try:
+        res = class_(**obj_json)
+    except TypeError as exc:  # @UnusedVariable
+        # logger.print(f"++++++++++ class_(**obj_json): {exc}")
+        pass
+    
+    if res is undefined_value:
+        try:
+            res = class_()
+        except TypeError as exc:  # @UnusedVariable
+            # logger.print(f"++++++++++ class_(): {exc}")
+            pass
+        if res is not undefined_value:
+            for k, v in obj_json.items():
+                if not isinstance(k, str):
+                    raise TechnicalException(f"Failed to set a field in object of type {class_}: a field has name [{k}] that is not a string (from json object: {obj_json})")
+                value = converter.from_json_to(v, None, _parents=JsonTypes._new_parents(_parents, class_, name=k, index=1))
+                if hasattr(res, k):
+                    setattr(res, k, value)
+                else:
+                    raise TechnicalException(f"Failed to set field '{k}' in object of type {class_}: attribute '{k}' doesn't exists")
+    
+    if res is undefined_value:
+        raise TechnicalException(f"Failed to create {class_} instance from json object {obj_json}")
+    return res
+
+JsonTypes.register_resource_for_type_in_class('object', lambda c: inspect.isclass(c) and issubclass(c, object), lambda o: isinstance(o, object) and hasattr(o, '__dict__'), 
+                        (None, lambda x: x.__dict__, _from_json_to_object))
+    
+
+
+

holado_json/tests/behave/steps/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+from .ipc.json_steps import *

holado_json/tests/behave/steps/ipc/json_steps.py

@@ -0,0 +1,131 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+from holado_test.scenario.step_tools import StepTools
+from holado.common.context.session_context import SessionContext
+from holado_test.behave.behave import *  # @UnusedWildImport
+from holado_json.ipc.json import create_name_value_table_from_json,\
+    create_table_with_header_from_json
+import logging
+from holado_value.common.tables.converters.value_table_converter import ValueTableConverter
+from holado_core.common.tools.tools import Tools
+from holado_json.ipc.json_converter import JsonConverter
+from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+
+logger = logging.getLogger(__name__)
+
+
+def __get_scenario_context():
+    return SessionContext.instance().get_scenario_context()
+
+def __get_text_interpreter():
+    return __get_scenario_context().get_text_interpreter()
+
+def __get_variable_manager():
+    return __get_scenario_context().get_variable_manager()
+
+
+@Step(r"(?P<var_name>{Variable}) = convert json (?P<json_value>{Str}) to name/value table")
+def step_impl(context, var_name, json_value):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_value = StepTools.evaluate_scenario_parameter(json_value)
+        
+    res = create_name_value_table_from_json(json_value, recursive=False, uncollapse_list=False)
+
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res.represent(4)}\nsource: {json_value}")
+    __get_variable_manager().register_variable(var_name, res)
+
+
+@Step(r"(?P<var_name>{Variable}) = convert json (?P<json_value>{Str}) to name/value table with names uncollapsed")
+def step_impl(context, var_name, json_value):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_value = StepTools.evaluate_scenario_parameter(json_value)
+        
+    res = create_name_value_table_from_json(json_value, recursive=True, uncollapse_list=False)
+
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res.represent(4)}\nsource: {json_value}")
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = convert json (?P<json_value>{Str}) to name/value table with names and list uncollapsed")
+def step_impl(context, var_name, json_value):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_value = StepTools.evaluate_scenario_parameter(json_value)
+        
+    res = create_name_value_table_from_json(json_value, recursive=True, uncollapse_list=True)
+
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res.represent(4)}\nsource: {json_value}")
+    __get_variable_manager().register_variable(var_name, res)
+
+
+@Step(r"(?P<var_name>{Variable}) = convert json (?P<json_object>{Str}) to table with names as columns recursively")
+def step_impl(context, var_name, json_object):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_object = StepTools.evaluate_scenario_parameter(json_object)
+    
+    res = create_table_with_header_from_json(json_object, recursive=True, uncollapse_list=False)
+
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res.represent(4)}\nsource: {json_object}")
+    __get_variable_manager().register_variable(var_name, res)
+
+
+@Step(r"(?P<var_name>{Variable}) = convert json (?P<json_object>{Str}) to table with names as columns")
+def step_impl(context, var_name, json_object):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_object = StepTools.evaluate_scenario_parameter(json_object)
+    
+    res = create_table_with_header_from_json(json_object, recursive=False, uncollapse_list=False)
+    
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res.represent(4)}\nsource: {json_object}")
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = convert text (?P<json_text>{Str}) to json")
+def step_impl(context, var_name, json_text):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_text = StepTools.evaluate_scenario_parameter(json_text)
+    
+    if isinstance(json_text, bytes):
+        json_text = json_text.decode('utf-8')
+    
+    converter = JsonConverter()
+    json_object = converter.to_json(json_text)
+    
+    __get_variable_manager().register_variable(var_name, json_object)
+    
+@Step(r"(?P<var_name>{Variable}) = json object")
+def step_impl(context, var_name):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    json_text = BehaveStepTools.get_step_multiline_text(context)
+    
+    converter = JsonConverter()
+    json_object = converter.to_json(json_text)
+    
+    __get_variable_manager().register_variable(var_name, json_object)
+    
+@Step(r"(?P<var_name>{Variable}) = convert name/value table (?P<table_varname>{Variable}) to json")
+def step_impl(context, var_name, table_varname):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    table = StepTools.evaluate_variable_value(table_varname)
+        
+    res = ValueTableConverter.convert_name_value_table_2_json_object(table)
+
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"Convertion result:\n{res}\nsource: {table.represent(4)}")
+    __get_variable_manager().register_variable(var_name, res)
+

holado_keycloak/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+

holado_keycloak/tests/behave/steps/__init__.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+from .tools.keycloak_client_steps import *

holado_keycloak/tests/behave/steps/tools/keycloak_client_steps.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+from holado.common.context.session_context import SessionContext
+from holado_test.behave.behave import *  # @UnusedWildImport
+from holado_keycloak.tools.keycloak.keycloak_client import KeycloakClient
+import logging
+from holado_core.common.exceptions.functional_exception import FunctionalException
+from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+from holado_value.common.tables.converters.value_table_converter import ValueTableConverter
+from holado_test.scenario.step_tools import StepTools
+
+logger = logging.getLogger(__name__)
+
+
+def __get_session_context():
+    return SessionContext.instance()
+
+def __get_scenario_context():
+    return __get_session_context().get_scenario_context()
+
+def __get_text_interpreter():
+    return __get_scenario_context().get_text_interpreter()
+
+def __get_variable_manager():
+    return __get_scenario_context().get_variable_manager()
+
+
+
+
+@Given(r"(?P<var_name>{Variable}) = token from Keycloak server")
+def step_impl(context, var_name):
+    var_name = StepTools.evaluate_variable_name(var_name)
+    table = BehaveStepTools.convert_step_table_2_value_table_with_header(context.table)
+    params = ValueTableConverter.convert_name_value_table_2_dict(table)
+    
+    client = KeycloakClient()
+    if 'username' in params and 'password' in params:
+        res = client.get_token_by_grant_type_password(**params)
+    elif 'refresh_token' in params:
+        res = client.get_token_by_grant_type_refresh_token(**params)
+    else:
+        raise FunctionalException(f"Unable to get token with given parameters.\nAllowed methods: by password (parameters 'username' and 'password'), by refresh (parameter 'refresh_token')\nReceived parameters: {params}")
+    
+    __get_variable_manager().register_variable(var_name, res)
+    
+    
+@Given(r"logout from Keycloak server")
+def step_impl(context):
+    table = BehaveStepTools.convert_step_table_2_value_table_with_header(context.table)
+    params = ValueTableConverter.convert_name_value_table_2_dict(table)
+    
+    client = KeycloakClient()
+    
+    if 'refresh_token' in params:
+        client.logout_by_refresh_token(**params)
+    # NOTE: As described in client, this method should work but doesn't, that's why it it commented
+    # elif 'token' in params:
+    #     client.logout_by_token(**params)
+    else:
+        raise FunctionalException(f"Unable to logout with given parameters.\nAllowed methods: by token (parameter 'token')\nReceived parameters: {params}")    

holado_keycloak/tools/keycloak/keycloak_client.py

@@ -0,0 +1,90 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+import logging
+import json
+from holado_core.common.exceptions.functional_exception import FunctionalException
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado_system.system.command.command import Command, CommandStates
+
+
+logger = logging.getLogger(__name__)
+
+class KeycloakClient(object):
+    
+    def get_token_by_grant_type_password(self, server_url, realm_name, client_id, client_secret, username, password):
+        cmd = f"curl --location --request POST '{server_url}/auth/realms/{realm_name}/protocol/openid-connect/token' \
+                    --header 'Content-Type: application/x-www-form-urlencoded' \
+                    --data-urlencode 'client_id={client_id}' \
+                    --data-urlencode 'client_secret={client_secret}' \
+                    --data-urlencode 'grant_type=password' \
+                    --data-urlencode 'username={username}' \
+                    --data-urlencode 'password={password}'"
+        command = Command(cmd, do_log_output=True, do_raise_on_stderr=False)
+        command.start()
+        command.join()
+        
+        if command.state is not CommandStates.Success:
+            raise TechnicalException(f"Error while executing token command [{cmd}] : [{command.stderr}]")
+        if command.stdout is not None and 'error' in command.stdout.lower():
+            raise FunctionalException(f"Error while getting token for {{server '{server_url}', realm '{realm_name}', client id '{client_id}', username '{username}'}}:\n{command.stdout}")
+        
+        return json.loads(command.stdout)
+    
+    def get_token_by_grant_type_refresh_token(self, server_url, realm_name, client_id, client_secret, refresh_token):
+        cmd = f"curl --location --request POST '{server_url}/auth/realms/{realm_name}/protocol/openid-connect/token' \
+                    --header 'Content-Type: application/x-www-form-urlencoded' \
+                    --data-urlencode 'client_id={client_id}' \
+                    --data-urlencode 'client_secret={client_secret}' \
+                    --data-urlencode 'grant_type=refresh_token' \
+                    --data-urlencode 'refresh_token={refresh_token}'"
+        command = Command(cmd, do_log_output=True, do_raise_on_stderr=False)
+        command.start()
+        command.join()
+        
+        if command.state is not CommandStates.Success:
+            raise TechnicalException(f"Error while executing token command [{cmd}] : [{command.stderr}]")
+        if command.stdout is not None and 'error' in command.stdout.lower():
+            raise FunctionalException(f"Error while getting token for {{server '{server_url}', realm '{realm_name}', client id '{client_id}', refresh_token '{refresh_token}'}}:\n{command.stdout}")
+        
+        return json.loads(command.stdout)
+    
+    # NOTE: This method doesn't work whereas it should according to documentation. Use instead logout_by_client.
+    # def logout_by_token(self, server_url, realm_name, token):
+    #     cmd = f"curl --location --request POST '{server_url}/auth/realms/{realm_name}/protocol/openid-connect/logout' \
+    #                 --header 'Content-Type: application/x-www-form-urlencoded' \
+    #                 --data-urlencode 'id_token_hint={token}'"
+    #     command = Command(cmd, do_log_output=True, do_raise_on_stderr=False)
+    #     command.start()
+    #     command.join()
+    #    
+    #     if command.state is not CommandStates.Success:
+    #         raise TechnicalException(f"Error while executing logout command [{cmd}] : [{command.stderr}]")
+    #     if command.stdout is not None and 'error' in command.stdout.lower():
+    #         raise FunctionalException(f"Error while logging out user for {{server '{server_url}', realm '{realm_name}', id_token_hint '{token}'}}:\n{command.stdout}")
+    
+    def logout_by_refresh_token(self, server_url, realm_name, client_id, client_secret, refresh_token):
+        cmd = f"curl --location --request POST '{server_url}/auth/realms/{realm_name}/protocol/openid-connect/logout' \
+                    --header 'Content-Type: application/x-www-form-urlencoded' \
+                    --data-urlencode 'client_id={client_id}' \
+                    --data-urlencode 'client_secret={client_secret}' \
+                    --data-urlencode 'refresh_token={refresh_token}'"
+        command = Command(cmd, do_log_output=True, do_raise_on_stderr=False)
+        command.start()
+        command.join()
+        
+        if command.state is not CommandStates.Success:
+            raise TechnicalException(f"Error while executing logout command [{cmd}] : [{command.stderr}]")
+        if command.stdout is not None and 'error' in command.stdout.lower():
+            raise FunctionalException(f"Error while logging out user for {{server '{server_url}', realm '{realm_name}', client id '{client_id}', refresh_token '{refresh_token}'}}:\n{command.stdout}")
+        

holado_logging/__init__.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+
+
+
+def dependencies():
+    return None
+
+
+
+def configure(use_holado_logger=True, logging_config_file_path=None, log_level=None, log_time_in_utc=None, log_on_console=False, log_in_file=True):
+    from holado_logging.common.logging.log_config import LogConfig
+    LogConfig.configure(use_holado_logger=use_holado_logger, config_file_path=logging_config_file_path, 
+                        log_level=log_level, log_time_in_utc=log_time_in_utc, log_on_console=log_on_console, log_in_file=log_in_file)
+    
+def initialize_and_register():
+    from holado.common.context.session_context import SessionContext
+    from holado_logging.common.logging.log_manager import LogManager
+    
+    log_manager = LogManager()
+    log_manager.configure()
+    log_manager.initialize()
+    
+    SessionContext.instance().services.register_service_instance("log_manager", log_manager, SessionContext.instance(), 
+                                                                 raise_if_service_exist=False, raise_if_object_exist=False)
+

holado_logging/common/logging/holado_logger.py

@@ -0,0 +1,71 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+import logging
+from holado.common.handlers.undefined import default_value
+
+logger = logging.getLogger(__name__)
+
+
+class HALogger(logging.Logger):
+    default_message_size_limit = None
+    
+    def __init__(self, name, level=logging.NOTSET):
+        super().__init__(name, level)
+    
+    def _log(self, level, msg, args, exc_info=None, extra=None, stack_info=False, stacklevel=1, msg_size_limit=default_value):
+        # def find_handlers(logger_):
+        #     index = 0
+        #     while len(logger_.handlers) == 0:
+        #         if logger_.parent is not None:
+        #             logger_ = logger_.parent
+        #             index += 1
+        #         else:
+        #             break
+        #     return index, logger_.handlers
+        # print(f"-------------- {id(self)} | {self.name} | {level}/{self.getEffectiveLevel()} | {msg} | {find_handlers(self)=} | {self.filters=}")
+        try:
+            from holado_core.common.tools.tools import Tools
+        except ImportError as exc:
+            if "Python is likely shutting down" in str(exc):
+                return
+            else:
+                raise exc
+        
+        if msg_size_limit is default_value:
+            msg_size_limit = HALogger.default_message_size_limit
+        msg_to_log = Tools.truncate_text(msg, msg_size_limit)
+            
+        logging.Logger._log(self, level, msg_to_log, args, exc_info=exc_info, extra=extra, stack_info=stack_info, stacklevel=stacklevel)
+    
+    # def setLevel(self, level)->None:
+    #     logger.print(f"Change logger {self} level to {level}")
+    #     logging.Logger.setLevel(self, level)
+    
+class HARootLogger(HALogger):
+    """
+    Implementation is a copy of logging.RootLogger
+    """
+    def __init__(self, level):
+        """
+        Initialize the logger with the name "root".
+        """
+        super().__init__("root", level)
+
+    def __reduce__(self):
+        return logging.getLogger, ()
+
+
+
+
+