holado 0.13.22__py3-none-any.whl

holado_core/common/exceptions/element_exception.py

@@ -0,0 +1,28 @@
+
+#################################################
+# 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 builtins import super
+from holado_core.common.exceptions.functional_exception import FunctionalException
+
+class ElementNotFoundException(FunctionalException):
+    def __init__(self, message = None):
+        super().__init__(message)
+
+class NoSuchElementException(ElementNotFoundException):
+    def __init__(self, message = None):
+        super().__init__(message)
+
+class TooManyElementsException(ElementNotFoundException):
+    def __init__(self, message = None):
+        super().__init__(message)
+

holado_core/common/exceptions/exceptions.py

@@ -0,0 +1,24 @@
+
+#################################################
+# 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.
+#################################################
+
+
+
+class Exceptions(object):
+    @classmethod
+    def exception_message(cls, exc):
+        if hasattr(exc, 'message'):
+            return exc.message
+        else:
+            return repr(exc)
+        
+        

holado_core/common/exceptions/functional_exception.py

@@ -0,0 +1,21 @@
+
+#################################################
+# 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 builtins import super
+from holado_core.common.exceptions.holado_exception import HAException
+
+
+class FunctionalException(HAException):
+    def __init__(self, message = None):
+        super().__init__(message)
+

holado_core/common/exceptions/holado_exception.py

@@ -0,0 +1,25 @@
+
+#################################################
+# 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 builtins import super
+
+class HAException(Exception):
+    def __init__(self, message = None):
+        super().__init__(message)
+        
+        self.__message = message
+        
+    @property
+    def message(self):
+        return self.__message
+

holado_core/common/exceptions/technical_exception.py

@@ -0,0 +1,27 @@
+
+#################################################
+# 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 builtins import super
+from holado_core.common.exceptions.holado_exception import HAException
+
+
+class TechnicalException(HAException):
+    def __init__(self, message = None):
+        super().__init__(message)
+
+class TimeoutTechnicalException(TechnicalException):
+    def __init__(self, message = None):
+        super().__init__(message)
+
+
+

holado_core/common/exceptions/timeout_exception.py

@@ -0,0 +1,20 @@
+
+#################################################
+# 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 builtins import super
+from holado_core.common.exceptions.functional_exception import FunctionalException
+
+class TimeoutException(FunctionalException):
+    def __init__(self, message = None):
+        super().__init__(message)
+

holado_core/common/exceptions/verify_exception.py

@@ -0,0 +1,20 @@
+
+#################################################
+# 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 builtins import super
+from holado_core.common.exceptions.functional_exception import FunctionalException
+
+class VerifyException(FunctionalException):
+    def __init__(self, message = None):
+        super().__init__(message)
+

holado_core/common/finders/after_in_tree_finder.py

@@ -0,0 +1,87 @@
+#################################################
+# 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_core.common.exceptions.technical_exception import TechnicalException
+import logging
+from holado_core.common.finders.tools.find_context import ContainerFindContext
+from holado_core.common.finders.tools.find_parameters import FindParameters
+from holado_core.common.finders.tools.enums import FindType
+from holado_core.common.finders.tree_finder import TreeFinder
+from holado_core.common.tools.tools import Tools
+
+logger = logging.getLogger(__name__)
+
+
+class AfterInTreeFinder(TreeFinder):
+    """ Finder that searches through tree an element after given one.
+    It goes through parents, and for each parent, look in children after the child coming from if element is found.
+    The element is searched using given finder from each possible child.
+    """
+    
+    def __init__(self, finder_element, description=None):
+        super().__init__(description)
+        self.find_type = FindType.Custom
+        
+        self.__finder_element = finder_element
+    
+    def _find_all_container(self, find_context:ContainerFindContext, find_parameters:FindParameters):
+        if Tools.do_log(logger, logging.DEBUG):
+            logger.debug(f"FinderHtmlAfterInTree[{self.element_description}]._find_all_container begin  It should be replaced by another find method for performance reasons")
+
+        res = []
+        sub_find_parameters = find_parameters.get_next_level(False)
+        
+        current_context = find_context
+        while len(res) == 0:
+            # Find parent
+            parent = self._find_parent(current_context, sub_find_parameters)
+            if parent is None:
+                # Root parent is reached, stop searching
+                break
+            
+            # Get children
+            children = self._find_children(current_context, sub_find_parameters, parent)
+            
+            # Get index in children
+            index_in_children = children.index(current_context.container)
+            if index_in_children < 0:
+                raise TechnicalException("Unable to find element in children of parent")
+            
+            # Search through each possible child
+            for index in range(index_in_children + 1, len(children)):
+                child = children[index]
+                
+                # Check child
+                try:
+                    if self.__finder_element.is_valid_input(child, current_context, sub_find_parameters):
+                        self._add_candidate(res, child)
+                        continue
+                except NotImplementedError:
+                    # check this child is not relevant, continue code
+                    pass
+                
+                # Check in child
+                res_child = self.__finder_element.find_all_in(child, find_context=current_context, find_parameters=sub_find_parameters)
+                if len(res_child) > 0:
+                    self._add_candidates(res, res_child)
+                    continue
+            
+            # Prepare next loop
+            current_context = current_context.withContainer(parent)
+        
+        return res
+    
+    
+    
+    
+    
+    

holado_core/common/finders/element_finder.py

@@ -0,0 +1,60 @@
+#################################################
+# 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 timeit import default_timer as timer
+from holado_core.common.finders.finder import Finder
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class ElementFinder(Finder):
+    """ Generic finder of elements.
+    """
+    
+    def __init__(self, description=None):
+        super().__init__(description)
+    
+    def _build_result_element(self, res, find_context, find_parameters, element_description=None):
+        super()._build_result_element(res, find_context, find_parameters)
+        
+        if element_description is not None and len(element_description) > 0:
+            res.description = element_description
+        elif self.element_description is not None:
+            res.description = self.element_description
+            
+        return res
+    
+    def _build_result_list(self, res, find_context, find_parameters, element_description=None):
+        for el in res:
+            self._build_result_element(el, find_context, find_parameters, element_description)
+        return res
+    
+    def is_valid_input(self, element, find_context, find_parameters):
+        return self.is_valid_element(element, find_context, find_parameters)
+    
+    def is_valid_output(self, element, find_context, find_parameters):
+        return self.is_valid_element(element, find_context, find_parameters)
+    
+    def is_valid_element(self, element, find_context, find_parameters):
+        """
+        Return if element is valid according this finder.
+        @param element Element to validate
+        @param find_context Find context
+        @param find_parameters Find parameters
+        @return True if element is valid according this finder
+        """
+        raise NotImplementedError(f"Unimplemented is_valid_element since inconsistent for [{self.finder_description}]")
+    
+    
+    
+    

holado_core/common/finders/else_finder.py

@@ -0,0 +1,105 @@
+#################################################
+# 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_core.common.finders.finder import Finder
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado_core.common.exceptions.element_exception import NoSuchElementException
+from holado.holado_config import Config
+import logging
+from holado_core.common.tools.tools import Tools
+
+logger = logging.getLogger(__name__)
+
+
+class ElseFinder(Finder):
+    """ Finder that search using multiple finder.
+    All referenced finders are executed, and all results are merged.
+    """
+    
+    def __init__(self, finder=None, finder_else=None, description=None):
+        super().__init__(description)
+        self.__finders = []
+        
+        if finder is not None:
+            self.__finders.append(finder)
+        if finder_else is not None:
+            self.__finders.append(finder_else)
+    
+    @property
+    def finders(self):
+        return self.__finders
+    
+    def set_next_finder(self, finder):
+        """
+        Set next else finder.
+        @param finder A finder
+        """
+        self.__finders.append(finder)
+
+    def set_next_finders(self, other_finder):
+        """
+        @param other_finder Other ElseFinder to merge with
+        """
+        for finder in other_finder.finders:
+            self.set_next_finder(finder)
+
+    def _find_all(self, find_context, find_parameters):
+        context = self.update_context(find_context)
+        parameters = self.update_parameters(find_parameters)
+        
+        res = []
+        exc_previous = None
+        sub_find_parameters = parameters.get_next_level()
+        
+        # Prepare analyze time spent
+        if parameters.analyze_time_spent:
+            start = Tools.timer_s()
+
+        for index, finder in enumerate(self.__finders):
+            try:
+                if Tools.do_log(logger, logging.TRACE):  # @UndefinedVariable
+                    logger.trace(f"{self._get_indent_string_level(parameters)}[ElseFinder({self.element_description})[{index}]:{finder.element_description}] begin")
+                beg = Tools.timer_s()
+                
+                try:
+                    res = finder.find_all(context, sub_find_parameters)
+                except NoSuchElementException as exc:
+                    if exc_previous is None:
+                        exc_previous = exc
+                
+                end = Tools.timer_s()
+                if Tools.do_log(logger, logging.TRACE):  # @UndefinedVariable
+                    logger.trace(f"{self._get_indent_string_level(parameters)}[ElseFinder({self.element_description})[{index}]:{finder.element_description}] end ({end-beg} s)")
+                
+                if len(res) > 0:
+                    break
+            except TechnicalException as exc:
+                raise TechnicalException(f"[ElseFinder({self.element_description})[{index}]:{finder.element_description}] {exc.message}") from exc
+        
+        # Analyze time spent
+        if parameters.analyze_time_spent:
+            duration = Tools.timer_s() - start
+            if duration > Config.threshold_warn_time_spent_s:
+                logger.warning(f"ElseFinder[{self.element_description}].findAll end (took {duration} s)     ->  {len(res)} elements")
+
+        if len(res) == 0 and exc_previous is not None:
+            Tools.raise_same_exception_type(exc_previous, f"Unable to find {self.element_description} in {find_context.get_find_type_container_description_prefix()}{find_context.get_input_complete_description_and_details()}")
+        return res
+
+    def is_valid_input(self, container, find_context, find_parameters):
+        return self._is_valid_input_in(self.__finders, container, find_context, find_parameters)
+    
+    def is_valid_output(self, element, find_context, find_parameters):
+        return self._is_valid_output_in(self.__finders, element, find_context, find_parameters)
+
+    
+