holado 0.2.3__tar.gz → 0.2.5__tar.gz

{holado-0.2.3 → holado-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holado
-Version: 0.2.3
+Version: 0.2.5
 Summary: HolAdo framework
 Project-URL: Homepage, https://gitlab.com/holado_framework/python
 Project-URL: Issues, https://gitlab.com/holado_framework/python/-/issues

holado-0.2.5/packaging/VERSION

@@ -0,0 +1 @@
+0.2.5

{holado-0.2.3 → holado-0.2.5}/src/holado/__init__.py

@@ -27,7 +27,7 @@ except:
     with_behave = False
 
 logger = None
-
+__initialized = False
 
 def __initialize_holado_loggers():
     global logger
@@ -38,27 +38,29 @@ def __initialize_holado_loggers():
     
     
     
-def _initialize_logging(initialize_logging=True, logging_config_file=None, log_level=None, log_on_console=False, log_in_file=True):
+def _initialize_logging(use_holado_logger=True, logging_config_file_path=None, log_level=None, log_on_console=False, log_in_file=True):
     # print_imported_modules("[initialize]")
     import holado_logging
     # print_imported_modules("[after import holado_logging]")
 
     # Configure logging module
-    holado_logging.configure(initialize_logging=initialize_logging, log_level=log_level)
+    holado_logging.configure(use_holado_logger=use_holado_logger, logging_config_file_path=logging_config_file_path, log_level=log_level, log_on_console=log_on_console, log_in_file=log_in_file)
     # print_imported_modules("[after import holado_logging]")
 
     # Initialize holado loggers
     __initialize_holado_loggers()
     
-    # Register LogManager in SessionContext
-    holado_logging.register()
-    
-    # Configure log manager
+    # Create session context
     from holado.common.context.session_context import SessionContext
-    SessionContext.instance().log_manager.on_console = log_on_console
-    SessionContext.instance().log_manager.in_file = log_in_file
-    if logging_config_file is not None:
-        SessionContext.instance().log_manager.set_config_file_path(logging_config_file, update_default_level=False)
+    if SessionContext.has_instance():
+        from holado_core.common.exceptions.technical_exception import TechnicalException
+        raise TechnicalException(f"Session context was initialized to early (before logging configuration)")
+    SessionContext.instance()
+    
+    # Initialize log manager and register it in session context
+    holado_logging.initialize_and_register()
+    
+    # Set whole logging configuration
     SessionContext.instance().log_manager.set_config()
     
 def change_logging_config(log_level=None, log_on_console=False, log_in_file=True):
@@ -67,52 +69,81 @@ def change_logging_config(log_level=None, log_on_console=False, log_in_file=True
     SessionContext.instance().log_manager.on_console = log_on_console
     SessionContext.instance().log_manager.in_file = log_in_file
     SessionContext.instance().log_manager.set_config()
-    
-def initialize(TSessionContext=None, initialize_logging=True, logging_config_file=None, 
+
+
+def initialize_minimal():
+    # initialize(TSessionContext=None, use_holado_logger=False, logging_config_file_path=None,
+    #            log_level=None, log_on_console=True, log_in_file=False,
+    #            session_kwargs={'with_session_path':False}, 
+    #            garbage_collector_periodicity=None)
+    initialize(TSessionContext=None, use_holado_logger=True, logging_config_file_path=None,
+               log_level=None, log_on_console=True, log_in_file=False,
+               garbage_collector_periodicity=None)
+
+def initialize(TSessionContext=None, use_holado_logger=True, logging_config_file_path=None, 
                log_level=None, log_on_console=False, log_in_file=True, session_kwargs=None,
                garbage_collector_periodicity=default_value):
+    global __initialized
+    if __initialized:
+        from holado_core.common.exceptions.technical_exception import TechnicalException
+        raise TechnicalException(f"HolAdo was already initialized")
+    
     from holado_core.common.tools.tools import Tools
     
     if session_kwargs is None:
         session_kwargs = {}
     with_session_path = session_kwargs.get("with_session_path", True)
     
+    # Reset session context before initializing logging
+    # Note: Session context must not be created before logging initialization
+    from holado.common.context.session_context import SessionContext
+    SessionContext._reset_instance()
     if TSessionContext is not None:
         if isinstance(TSessionContext, str):
             module_name, class_type = TSessionContext.rsplit('.', maxsplit=1)
             module = importlib.import_module(module_name)
             TSessionContext = getattr(module, class_type)
-
-        from holado.common.context.session_context import SessionContext
+        
         SessionContext.TSessionContext = TSessionContext
     
     # Initialize logging
-    _initialize_logging(initialize_logging=initialize_logging, logging_config_file=logging_config_file,
+    _initialize_logging(use_holado_logger=use_holado_logger, logging_config_file_path=logging_config_file_path,
                         log_level=log_level, log_on_console=log_on_console, log_in_file=log_in_file and with_session_path)
     if Tools.do_log(logger, logging.DEBUG):
         logger.debug("Configured logging")
     
     if Tools.do_log(logger, logging.DEBUG):
         logger.debug("Importing HolAdo modules")
-    import_modules(get_holado_module_names())
+    _import_modules(get_holado_module_names())
     
-    initialize_session_context(session_kwargs)
+    _initialize_session_context(session_kwargs)
     
     # Initialize garbage collector
     if garbage_collector_periodicity is not None:
         GcManager.collect_periodically(garbage_collector_periodicity)
         logger.debug(f"Garbage collector is disabled, and collects are automatically done in a dedicated thread (periodicity: {GcManager.get_collect_periodicity()} s)")
     
-def initialize_for_script(TSessionContext=None, initialize_logging=True, logging_config_file=None, log_level=logging.WARNING, log_on_console=True, log_in_file=False, session_kwargs=None):
+    if with_behave:
+        # Register default behave parameter types
+        #TODO: make step tools a service
+        from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+        BehaveStepTools.register_default_types()
+    
+    __initialized = True
+    
+def initialize_for_script(TSessionContext=None, use_holado_logger=True, logging_config_file_path=None, 
+                          log_level=logging.WARNING, log_on_console=True, log_in_file=False, session_kwargs=None,
+                          garbage_collector_periodicity=None):
     if session_kwargs is None:
         session_kwargs={'with_session_path':log_in_file, 'raise_if_not_exist':False}
         
-    initialize(TSessionContext=TSessionContext, initialize_logging=initialize_logging, logging_config_file=logging_config_file, 
+    initialize(TSessionContext=TSessionContext, use_holado_logger=use_holado_logger, logging_config_file_path=logging_config_file_path, 
                log_level=log_level, log_on_console=log_on_console, log_in_file=log_in_file,
-               session_kwargs=session_kwargs )
+               session_kwargs=session_kwargs,
+               garbage_collector_periodicity=garbage_collector_periodicity )
     
     
-def initialize_session_context(session_kwargs=None):
+def _initialize_session_context(session_kwargs=None):
     from holado_core.common.tools.tools import Tools
     
     if Tools.do_log(logger, logging.DEBUG):
@@ -138,7 +169,7 @@ def get_holado_module_names():
     lp = sorted(os.listdir(get_holado_src_path()))
     return [name for name in lp if name.startswith("holado_") and name not in ['holado_logging']]
 
-def import_modules(module_names):
+def _import_modules(module_names):
     from holado_core.common.tools.tools import Tools
     
     imported_modules = __import_modules(module_names)
@@ -265,3 +296,10 @@ def print_imported_modules(prefix):
     # print(f"{prefix} globals modules: {globals_modules}")
     
     
+
+# Process minimal initialization of HolAdo
+# Note: Currently, initialization can be done only once, thus minimal initialization is commented.
+#       As a consequence, the call of an initialize method is mandatory
+# initialize_minimal()
+
+

{holado-0.2.3 → holado-0.2.5}/src/holado/common/context/service_manager.py

@@ -170,13 +170,21 @@ class ServiceManager(object):
         return context.get_object(name)
     
     def add_context_property(self, name, context_type, raise_if_service_exist=None):
-        if raise_if_service_exist is None or raise_if_service_exist:
-            self.__verify_service_doesnt_exist(name, context_type, raise_if_service_exist)
+        # Note: next lines are commented, to allow to set again the service in context type
+        # if raise_if_service_exist is None or raise_if_service_exist:
+        #     self.__verify_service_doesnt_exist(name, context_type, raise_if_service_exist)
+        if hasattr(context_type, name):
+            logger.debug(f"Set again the property '{name}' in context type {context_type}")
         
         @property
         def context_service_property(self_context):
             return self._get_context_service(name, self_context)
         setattr(context_type, name, context_service_property)
+        
+        @property
+        def context_has_service_property(self_context):
+            return self_context.has_object(name)
+        setattr(context_type, 'has_' + name, context_has_service_property)
     
     def add_shortcut_property_to_context_service(self, name, dst_type, context_type, raise_if_service_exist=None):
         from holado_multitask.multiprocessing.context.process_context import ProcessContext

{holado-0.2.3 → holado-0.2.5}/src/holado/common/context/session_context.py

@@ -18,6 +18,7 @@ import os.path
 from holado.common.context.context import Context
 from holado_core.common.tools.tools import Tools
 import threading
+from holado.common.handlers.enums import ObjectStates
 
 
 logger = logging
@@ -32,16 +33,37 @@ class SessionContext(Context):
     
     # Singleton management
     __instance = None
+    __is_resetting_instance = False
     
     @staticmethod
     def instance() -> TSessionContext:
+        # Note: If session context istance is under reset, consider it is already None
+        if SessionContext.__is_resetting_instance:
+            return None
+        
         if SessionContext.__instance is None:
             SessionContext.__instance = SessionContext.TSessionContext()
-            # print(f"Created session context of type {SessionContext.TSessionContext}")
+            logger.debug(f"Created session context of type {SessionContext.TSessionContext}")
+            # logging.log(45, f"Created session context of type {SessionContext.TSessionContext}")
             # import traceback
-            # print("".join(traceback.format_list(traceback.extract_stack())))
+            # logging.log(45, "".join(traceback.format_list(traceback.extract_stack())))
         return SessionContext.__instance
     
+    @staticmethod
+    def has_instance() -> bool:
+        if SessionContext.__is_resetting_instance:
+            return False
+        else:
+            return SessionContext.__instance is not None
+    
+    @staticmethod
+    def _reset_instance():
+        if SessionContext.__instance is not None:
+            logger.debug(f"Resetting session context")
+            SessionContext.__is_resetting_instance = True
+            SessionContext.__instance = None
+            SessionContext.__is_resetting_instance = False
+            logger.debug(f"Reset of session context")
     
     def __init__(self, name="Session"):
         super().__init__(name)
@@ -55,12 +77,27 @@ class SessionContext(Context):
         self.__multitask_lock = threading.RLock()
         self.__multitask_step_lock = threading.RLock()
         
+    def __del__(self):
+        # Note: Override Object.__del__ since it supposes that SessionContext is initialized, whereas SessionContext is deleting
+        try:
+            if self.object_state in [ObjectStates.Deleting, ObjectStates.Deleted]:
+                return
+    
+            self.delete_object()
+        except Exception as exc:
+            if "Python is likely shutting down" in str(exc):
+                # Simply return
+                return
+            else:
+                raise exc
+    
     def _delete_object(self):
-        logger.info(f"Delete session context - Interrupting and unregistering all threads...")
         # if Tools.do_log(logger, logging.DEBUG):
         #     logger.debug("Interrupting and unregistering all threads for scenario [{}]".format(scenario.name))
-        self.threads_manager.interrupt_all_threads(scope="Session")
-        self.threads_manager.unregister_all_threads(scope="Session", keep_alive=False)
+        if self.has_threads_manager:
+            logger.info(f"Delete session context - Interrupting and unregistering all threads...")
+            self.threads_manager.interrupt_all_threads(scope="Session")
+            self.threads_manager.unregister_all_threads(scope="Session", keep_alive=False)
         
         # Delete session context
         logger.info(f"Delete session context - Deleting context objects...")
@@ -76,11 +113,6 @@ class SessionContext(Context):
             
         self.__with_session_path = session_kwargs.get("with_session_path", True)
         
-        # Register default behave parameter types
-        #TODO: make step tools a service
-        from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
-        BehaveStepTools.register_default_types()
-        
         # Create this thread context
         self.multitask_manager.get_thread_context()
     
@@ -122,14 +154,13 @@ class SessionContext(Context):
             name = "session_{}".format(datetime.now().strftime("%Y-%m-%d_%H-%M-%S"))
             report_path = self.path_manager.get_reports_path(name)
             logger.info(f"Reports location: {report_path}")
-            # print(f"Reports location: {report_path}")
+            print(f"Reports location: {report_path}")
         self.report_manager.new_session(report_path)
             
         # Logging configuration
         if self.with_session_path and SessionContext.instance().log_manager.in_file:
             log_filename = os.path.join(report_path, "logs", "report.log")
             self.path_manager.makedirs(log_filename)
-            SessionContext.instance().log_manager.on_console = False
             SessionContext.instance().log_manager.set_root_log_file(log_filename)
             SessionContext.instance().log_manager.set_config()
     

{holado-0.2.3 → holado-0.2.5}/src/holado/common/handlers/object.py

@@ -66,15 +66,23 @@ class DeleteableObject(Object):
     
     def __del__(self):
         try:
-            from holado_multitask.multithreading.functionthreaded import FunctionThreaded
-            
             if self.object_state in [ObjectStates.Deleting, ObjectStates.Deleted]:
                 return
             
-            # Note: Garbage collector default mecanism is incompatible with custom object finalizers (cf GcManager.Method __del__ is called by garbage collector. This call can be done in any thread at any moment.
-            if GcManager.is_collect_threaded():
+            if logger.isEnabledFor(logging.DEBUG):
+                logger.debug(f"Deleting object of ID {id(self)} and type {type(self)}")
+            if logger.isEnabledFor(logging.TRACE):  # @UndefinedVariable
+                import traceback
+                logger.trace("".join(traceback.format_list(traceback.extract_stack())))
+            
+            # Notes: 
+            #   - Garbage collector default mecanism is incompatible with custom object finalizers (cf GcManager.Method __del__ is called by garbage collector. This call can be done in any thread at any moment.
+            #   - When SessionContext is under deletion, delete any object by thread is not possible
+            from holado.common.context.session_context import SessionContext
+            if GcManager.is_collect_threaded() or isinstance(self, SessionContext.TSessionContext) or not SessionContext.has_instance():
                 self.__delete()
             else:
+                from holado_multitask.multithreading.functionthreaded import FunctionThreaded
                 func = FunctionThreaded(self.__delete, name=f"delete object '{self.name}'", register_thread=False)
                 func.start()
                 func.join(timeout=30, raise_if_still_alive=False)   # timeout of 30s to limit deadlock impact ; raise to False since exceptions are omitted in gc collect context

{holado-0.2.3 → holado-0.2.5}/src/holado/holado_config.py

@@ -16,6 +16,7 @@ class Config(object):
     """HolAdo project configuration"""
 
     # Timeouts
+    session_timeout_seconds = 7 * 24 * 3600     # Session timeout is by default to 7 days
     timeout_seconds = 240            # Default timeout
     join_timeout_seconds = 1800      # Long timeout used when a join should stop without deadlock. When this timeout is reached, a TimeoutTechnicalException is raised
 

holado-0.2.5/src/holado_ais/ais/ais_messages.py

@@ -0,0 +1,204 @@
+
+#################################################
+# 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_core.common.exceptions.technical_exception import TechnicalException
+from holado_value.common.tables.value_table_manager import ValueTableManager
+from holado_value.common.tables.converters.value_table_converter import ValueTableConverter
+from typing import Union
+from holado_core.common.tables.table_with_header import TableWithHeader
+from holado_core.common.tools.string_tools import StrTools
+from holado_binary.ipc.binary import Binary
+from holado_core.common.tools.tools import Tools
+from holado_python.standard_library.typing import Typing
+import copy
+
+logger = logging.getLogger(__name__)
+
+try:
+    import pyais
+    from bitarray import bitarray
+    from holado_ais.ais.patch_pyais import HATagBlock, HA_ais_to_nmea_0183
+    with_pyais = True
+    
+    # Patch pyais with some fixes
+    import holado_ais.ais.patch_pyais  # @UnusedImport
+except Exception as exc:
+    if Tools.do_log(logger, logging.DEBUG):
+        logger.debug(f"AIS is not available. Initialization failed on error: {exc}")
+    with_pyais = False
+
+
+
+class AISMessages(object):
+    
+    @classmethod
+    def is_available(cls):
+        return with_pyais
+    
+    if with_pyais:
+        
+        def __init__(self):
+            self.__tag_block_group_id = 0
+        
+        def default_message_data(self, msg_type:int):
+            """Return default data values for required data by pyais but not functionnaly required.
+            It is useful when generating custom messages, for example for tests.
+            """
+            return {}
+        
+        def new_message_as_bitarray_bytes(self, msg_type:int, data:Union[dict,TableWithHeader]):
+            msg = self.new_message(msg_type, data)
+            res = self.convert_message_to_bytes(msg)
+            return res
+        
+        def new_message(self, msg_type:int, data:Union[dict,TableWithHeader]):
+            if isinstance(data, TableWithHeader):
+                data = self.__convert_table_to_dict(data)
+            if not isinstance(data, dict):
+                raise TechnicalException(f"Unexpected data type '{Typing.get_object_class_fullname(data)}'")
+            
+            message_type = self.__get_message_type(msg_type)
+            res = message_type.create(**data)
+            return res
+    
+        def decode(self, *args, encoded_msg=None, parts_separator=b'\n'):
+            if encoded_msg is not None:
+                if isinstance(encoded_msg, str):
+                    encoded_bytes = encoded_msg.encode("utf-8")
+                elif isinstance(encoded_msg, bytes):
+                    encoded_bytes = encoded_msg
+                else:
+                    raise TechnicalException(f"Parameter 'encoded_msg' must be of type str or bytes")
+                args = encoded_bytes.split(parts_separator)
+            return pyais.decode(*args, error_if_checksum_invalid=True)
+        
+        def decode_message(self, msg_type:int, bit_array:Union[str,bitarray]):
+            if isinstance(bit_array, str):
+                if StrTools.is_hex(bit_array) and not StrTools.is_bitarray(bit_array):
+                    bit_array = Binary.convert_hex_str_to_bin_str(bit_array)
+                bit_array = bitarray(bit_array)
+            if not isinstance(bit_array, bitarray):
+                raise TechnicalException(f"Bad parameter 'bit_array' (accepted types: bitarray, str)")
+                
+            message_type = self.__get_message_type(msg_type)
+            return message_type.from_bitarray(bit_array)
+        
+        def encode_raw_payload(self, payload_hex: str, tag_block: HATagBlock = None, with_tag_block=True, talker_id: str = "AIVDM", **kwargs):
+            from pyais.util import encode_ascii_6
+            
+            payload_bitarray = bitarray()
+            payload_bitarray.frombytes(bytes.fromhex(payload_hex))
+            payload_ascii6, fill_bits = encode_ascii_6(payload_bitarray)
+            
+            seq_id = kwargs.pop('seq_id') if 'seq_id' in kwargs else self.__tag_block_group_id % 10
+            radio_channel = kwargs['radio_channel'] if 'radio_channel' in kwargs else 'A'
+            group_id = kwargs.pop('group_id') if 'group_id' in kwargs else None
+            
+            sentences = HA_ais_to_nmea_0183(payload_ascii6, talker_id, radio_channel, fill_bits, seq_id)
+            return self.__encode_add_tag_block(sentences, tag_block, with_tag_block=with_tag_block, group_id=group_id)
+            
+        def encode(self, data, tag_block: HATagBlock = None, with_tag_block=True, talker_id: str = "AIVDM", **kwargs):
+            if isinstance(data, pyais.messages.Payload):
+                return self.encode_msg(data, tag_block=tag_block, with_tag_block=with_tag_block, talker_id=talker_id, **kwargs)
+            elif isinstance(data, dict):
+                return self.encode_data(data, tag_block=tag_block, with_tag_block=with_tag_block, talker_id=talker_id, **kwargs)
+            elif isinstance(data, TableWithHeader):
+                return self.encode_table(data, tag_block=tag_block, with_tag_block=with_tag_block, talker_id=talker_id, **kwargs)
+            else:
+                raise TechnicalException(f"Unexpected data type '{Typing.get_object_class_fullname(data)}'")
+        
+        def encode_msg(self, msg, tag_block: HATagBlock = None, with_tag_block=True, talker_id: str = "AIVDM", **kwargs):
+            if not isinstance(msg, pyais.messages.Payload):
+                raise TechnicalException(f"Parameter 'msg' is not an AIS message (obtained type: {Typing.get_object_class_fullname(msg)})")
+            
+            seq_id = kwargs.pop('seq_id') if 'seq_id' in kwargs else self.__tag_block_group_id % 10
+            group_id = kwargs.pop('group_id') if 'group_id' in kwargs else None
+            
+            sentences = pyais.encode_msg(msg, seq_id=seq_id, talker_id=talker_id, **kwargs)
+            return self.__encode_add_tag_block(sentences, tag_block, with_tag_block=with_tag_block, group_id=group_id)
+        
+        def encode_data(self, data, tag_block: HATagBlock = None, with_tag_block=True, talker_id: str = "AIVDM", **kwargs):
+            if not isinstance(data, dict):
+                raise TechnicalException(f"Parameter 'data' is not a dict (obtained type: {Typing.get_object_class_fullname(data)})")
+            
+            seq_id = kwargs.pop('seq_id') if 'seq_id' in kwargs else self.__tag_block_group_id % 10
+            group_id = kwargs.pop('group_id') if 'group_id' in kwargs else None
+            
+            sentences = pyais.encode_dict(data, seq_id=seq_id, talker_id=talker_id, **kwargs)
+            return self.__encode_add_tag_block(sentences, tag_block, with_tag_block=with_tag_block, group_id=group_id)
+        
+        def encode_table(self, table, tag_block: HATagBlock = None, with_tag_block=True, talker_id: str = "AIVDM", **kwargs):
+            data = self.__convert_table_to_dict(table)
+            return self.encode_data(data, tag_block=tag_block, with_tag_block=with_tag_block, talker_id=talker_id, **kwargs)
+        
+        def __encode_add_tag_block(self, encoded_sentences, tag_block: HATagBlock = None, with_tag_block=True, group_id=None):
+            from pyais.messages import TagBlockGroup
+            
+            if not with_tag_block:
+                return encoded_sentences
+            
+            res = []
+            nb_sentences = len(encoded_sentences)
+            if nb_sentences > 1 and group_id is None:
+                group_id = self.__tag_block_group_id
+                # Increment group_id for next message needing a group_id
+                self.__new_tag_block_group_id()
+            elif nb_sentences == 1:
+                # No group tag block is needed
+                group_id = None
+            
+            for index, sentence in enumerate(encoded_sentences):
+                sentence_tag_block = copy.deepcopy(tag_block) if index == 0 else None
+                if group_id is not None:
+                    if sentence_tag_block is None:
+                        sentence_tag_block = HATagBlock()
+                    sentence_tag_block._group = TagBlockGroup(msg_id=index+1, total=nb_sentences, group_id=group_id)
+                
+                if sentence_tag_block is not None:
+                    res.append('\\' + sentence_tag_block.to_raw().decode() + '\\' + sentence)
+                else:
+                    res.append(sentence)
+            
+            return res
+        
+        def __new_tag_block_group_id(self):
+            self.__tag_block_group_id += 1
+            if self.__tag_block_group_id > 9999:
+                self.__tag_block_group_id = 0
+            return self.__tag_block_group_id
+        
+        def convert_message_to_binary_str(self, msg):
+            return msg.to_bitarray().to01()
+        
+        def convert_message_to_bytes(self, msg):
+            return msg.to_bitarray().tobytes()
+        
+        def __get_message_type(self, msg_type:int):
+            import importlib
+            module = importlib.import_module('pyais.messages')
+            res = getattr(module, f"MessageType{msg_type}")
+            return res
+            
+        def __convert_table_to_dict(self, table):
+            if not ValueTableManager.is_table_with_header(table):
+                raise TechnicalException(f"Parameter 'table' is not a table with header (obtained type: {Typing.get_object_class_fullname(table)})")
+            
+            if ValueTableManager.verify_table_is_name_value_table(table, raise_exception=False):
+                res = ValueTableConverter.convert_name_value_table_2_dict(table)
+            else:
+                res = ValueTableConverter.convert_table_with_header_to_dict(table)
+            return res
+        
+    
+    

{holado-0.2.3 → holado-0.2.5}/src/holado_core/common/tools/path_manager.py

@@ -122,10 +122,14 @@ class PathManager(object):
         else:
             os.replace(src, dst)
     
+    def get_user_home_path(self):
+        import pathlib
+        return str(pathlib.Path.home())
+    
     def get_local_resources_path(self, name=None):
-        base_path = os.getenv('HOLADO_TEST_LOCAL_RESOURCES_BASEDIR')
+        base_path = os.getenv('HOLADO_LOCAL_RESOURCES_BASEDIR')
         if base_path is None:
-            raise Exception("Missing environment variable HOLADO_TEST_LOCAL_RESOURCES_BASEDIR with HolAdo local resources base path")
+            base_path = os.path.join(self.get_user_home_path(), '.holado', 'resources')
         
         if name is not None:
             return os.path.join(base_path, name)
@@ -133,9 +137,9 @@ class PathManager(object):
             return base_path
     
     def get_reports_path(self, name=None):
-        base_path = os.getenv('HOLADO_TEST_OUTPUT_BASEDIR')
+        base_path = os.getenv('HOLADO_OUTPUT_BASEDIR')
         if base_path is None:
-            raise Exception("Missing environment variable HOLADO_TEST_OUTPUT_BASEDIR with HolAdo output base path")
+            base_path = os.path.join(self.get_user_home_path(), '.holado', 'output')
         
         if name is not None:
             return os.path.join(base_path, "reports", name)

holado-0.2.5/src/holado_examples/scripts/script_custom_initialization.py

@@ -0,0 +1,16 @@
+import holado
+
+
+# Initialize HolAdo with default behaviours and custom parameters
+
+holado.initialize_for_script(log_on_console=True, log_in_file=True)
+
+import logging
+logging.print("After 'holado.initialize_for_script(log_on_console=True, log_in_file=True)', HolAdo is initialized for scripts with:")
+logging.print("  - add logging levels 'trace' and 'print'")
+logging.print("  - do logs on console and in file")
+logging.print("  - a default session context is initialialized with all available HolAdo services")
+logging.print("  - a session folder is created that will contains at least log files")
+logging.print("  - launch garbage collector periodically (without specifying garbage_collector_periodicity, default periodicity is 10 s)")
+
+

holado-0.2.5/src/holado_examples/scripts/script_minimal_initialization.py

@@ -0,0 +1,23 @@
+import holado
+
+
+# Minimal HolAdo initialization for scripts
+holado.initialize_for_script()
+
+import logging
+logging.print("After 'holado.initialize_for_script()', HolAdo is initialized minimally for scripts with:")
+logging.print("  - add logging levels 'trace' and 'print'")
+logging.print("  - do logs on console but not in file")
+logging.print("  - a default session context is initialialized with all available HolAdo services")
+logging.print("  - no session folder is created")
+
+
+# Launch manually garbage collector periodically
+from holado.common.tools.gc_manager import GcManager
+from holado.common.handlers.undefined import default_value
+GcManager.collect_periodically(collect_periodicity=default_value) 
+logging.print("After 'GcManager.collect_periodically(collect_periodicity=default_value)', garbage collector is launched periodically (with default periodicity that is 10 s)")
+
+
+
+

holado-0.2.5/src/holado_examples/tests/behave/testing_solution/__main__.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+
+
+# This main is only needed to debug behave execution (and thus testing solution) with breakpoints
+
+import re
+import sys
+
+from behave.__main__ import main
+
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())