rpa-suite 1.3.4__py3-none-any.whl → 1.3.6__py3-none-any.whl

rpa_suite/file/screen_shot.py

@@ -1,91 +0,0 @@
-# /screen_shot.py
-
-import os, time
-from datetime import datetime
-from rpa_suite.log.printer import error_print, success_print
-from .__create_ss_dir import __create_ss_dir
-from colorama import Fore
-
-
-
-def screen_shot(path_dir:str = None, file_name: str = 'screenshot', save_with_date: bool = True, delay: int = 1, use_default_path_and_name: bool = True, name_ss_dir:str = None, display_message: bool = False) -> str | None:
-
-    """
-    Function responsible for create a dir for screenshot, and file screenshot and save this in dir to create, if dir exists save it on original dir. By default uses date on file name. \n
-
-    Parameters:
-    ----------
-    ``file_path: str`` - should be a string, not have a default path.
-    ``file_name: str`` - should be a string, by default name is `screenshot`.
-    ``save_with_date: bool`` - should be a boolean, by default `True` save namefile with date `foo_dd_mm_yyyy-hh_mm_ss.png`.
-    ``delay: int`` - should be a int, by default 1 (represents seconds).
-
-    Return:
-    ----------
-    >>> type:str
-        * 'screenshot_path': str - represents the absulute path created for this file
-
-    Description: pt-br
-    ----------
-    Função responsável por criar um diretório para captura de tela, e arquivo de captura de tela e salvar isso no diretório a ser criado, se o diretório existir, salve-o no diretório original. Por padrão, usa a data no nome do arquivo.
-
-    Parâmetros:
-    ----------
-    ``file_path: str`` - deve ser uma string, não tem um caminho padrão.
-    ``file_name: str`` - deve ser uma string, por padrão o nome é `screenshot`.
-    ``save_with_date: bool`` - deve ser um booleano, por padrão `True` salva o nome do arquivo com a data `foo_dd_mm_yyyy-hh_mm_ss.png`.
-    ``delay: int`` - deve ser um int, por padrão 1 representado em segundo(s).
-    
-    Retorno:
-    ----------
-    >>> tipo: str
-        * 'screenshot_path': str - representa o caminho absoluto do arquivo criado
-    """
-
-    # proccess
-    try:
-        
-        try:
-            import pyautogui
-            import pyscreeze
-            
-        except ImportError:
-            raise ImportError(f"\nThe libraries ‘pyautogui’ and ‘Pillow’ are necessary to use this module. {Fore.YELLOW}Please install them with: ‘pip install pyautogui pillow‘{Fore.WHITE}")
-        
-        time.sleep(delay)
-
-        if not use_default_path_and_name:
-            result_tryed: dict = __create_ss_dir(path_dir, name_ss_dir)
-            path_dir = result_tryed['path_created']
-        else:
-            if path_dir == None and name_ss_dir == None:
-                result_tryed: dict = __create_ss_dir()
-                path_dir = result_tryed['path_created']
-
-        
-        if save_with_date: # use date on file name
-            image = pyautogui.screenshot()
-            file_name = f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
-            path_file_screenshoted = os.path.join(path_dir, file_name)
-            
-            image.save(path_file_screenshoted)
-            if display_message:
-                success_print(path_file_screenshoted)
-            
-            return path_file_screenshoted
-        
-        else: # not use date on file name
-            image = pyautogui.screenshot()
-            file_name = f'{file_name}.png'
-            path_file_screenshoted = os.path.join(path_dir, file_name)
-            
-            image.save(path_file_screenshoted)
-            if display_message:
-                success_print(path_file_screenshoted)
-                
-            return path_file_screenshoted
-    
-    except Exception as e:
-
-        error_print(f'Error to execute function:{screen_shot.__name__}! Error: {str(e)}')
-        return None

rpa_suite/file/temp_dir.py

@@ -1,176 +0,0 @@
-# /temp_dir.py
-
-import os, shutil
-from typing import Union
-from rpa_suite.log.printer import error_print, alert_print, success_print
-
-
-def create_temp_dir(path_to_create: str = 'default', name_temp_dir: str='temp', display_message: bool = False) -> dict[str, Union[bool, str, None]]:
-
-    """
-    Function responsible for creating a temporary directory to work with files and etc. \n
-
-    Parameters:
-    ----------
-    ``path_to_create: str`` - should be a string with the full path pointing to the folder where the temporary folder should be created, if it is empty the ``default`` value will be used which will create a folder in the current directory where the file containing this function was called.
-
-    ``name_temp_dir: str`` - should be a string representing the name of the temporary directory to be created. If it is empty, the ``temp`` value will be used as the default directory name.
-
-    Return:
-    ----------
-    >>> type:dict
-        * 'success': bool - represents case the action was performed successfully
-        * 'path_created': str - path of the directory that was created on the process
-        
-    Description: pt-br
-    ----------
-    Função responsavel por criar diretório temporário para trabalhar com arquivos e etc. \n
-
-    Parametros:
-    ----------
-    ``path_to_create: str`` - deve ser uma string com o path completo apontando para a pasta onde deve ser criada a pasta temporaria, se estiver vazio sera usado valor ``default`` que criará pasta no diretório atual onde o arquivo contendo esta função foi chamada.
-
-    ``name_temp_dir: str`` - deve ser uma string representando o nome do diretório temporário a ser criado. Se estiver vazio, o valor ``temp`` será usado como o nome padrão do diretório.
-
-    Retorno:
-    ----------
-    >>> type:dict
-        * 'success': bool - representa se ação foi realizada com sucesso
-        * 'path_created': str - path do diretório que foi criado no processo
-    """
-    
-    # Local Variables
-    result: dict = {
-        'success': bool,
-        'path_created': str,
-    }
-    
-    try:
-        # by 'default', defines path to local script execution path
-        if path_to_create == 'default':
-            path_to_create: str = os.getcwd()
-
-        # Build path to new dir
-        full_path: str = os.path.join(path_to_create, name_temp_dir)
-
-        # Create dir in this block
-        try:
-
-            # Successefully created
-            os.makedirs(full_path, exist_ok=False)
-
-            result['success'] = True
-            result['path_created'] = fr'{full_path}'
-
-            if display_message:
-                success_print(f"Dir:'{full_path}' Created!")
-
-        except FileExistsError:
-            result['success'] = False
-            result['path_created'] = None
-            alert_print(f"Dir:'{full_path}' already exists.")
-
-        except PermissionError:
-            result['success'] = False
-            result['path_created'] = None
-            alert_print(f"Permission Denied: Not Able to create dir:'{full_path}'.")
-
-    except Exception as e:
-        result['success'] = False
-        result['path_created'] = None
-        error_print(f'Error capturing current path to create temporary directory! Error: {str(e)}')
-        
-    finally:
-        return result
-
-
-def delete_temp_dir(path_to_delete: str = 'default', name_temp_dir: str='temp', delete_files: bool = False, display_message: bool = False) -> dict[str, Union[bool, str, None]]:
-
-    """
-    Function responsible for deleting a temporary directory. \n
-    
-    Parameters:
-    ----------
-    ``path_to_delete: str`` - should be a string with the full path pointing to the folder where the temporary folder should be deleted, if it is empty the ``default`` value will be used which will delete a folder in the current directory where the file containing this function was called.
-
-    ``name_temp_dir: str`` - should be a string representing the name of the temporary directory to be deleted. If it is empty, the ``temp`` value will be used as the default directory name.
-
-    ``delete_files: bool`` - should be a boolean indicating whether to delete files in the directory. If it is False, files in the directory will not be deleted.
-
-    Return:
-    ----------
-    >>> type:dict
-        * 'success': bool - represents case the action was performed successfully
-        * 'path_deleted': str - path of the directory that was deleted on the process
-        
-    Description: pt-br
-    ----------
-    Função responsavel por deletar diretório temporário. \n
-
-    Parametros:
-    ----------
-    ``path_to_delete: str`` - deve ser uma string com o path completo apontando para a pasta onde deve ser deletada a pasta temporaria, se estiver vazio sera usado valor ``default`` que deletará pasta no diretório atual onde o arquivo contendo esta função foi chamada.
-
-    ``name_temp_dir: str`` - deve ser uma string representando o nome do diretório temporário a ser deletado. Se estiver vazio, o valor ``temp`` será usado como o nome padrão do diretório.
-
-    ``delete_files: bool`` - deve ser um booleano indicando se deve deletar arquivos no diretório. Se for False, arquivos no diretório não serão deletados.
-
-    Retorno:
-    ----------
-    >>> type:dict
-        * 'success': bool - representa se ação foi realizada com sucesso
-        * 'path_deleted': str - path do diretório que foi deletado no processo
-    """
-
-    # Local Variables
-    result: dict = {
-        'success': bool,
-        'path_deleted': str,
-    }
-
-    try:
-        # by 'default', defines path to local script execution path
-        if path_to_delete == 'default':
-            path_to_delete: str = os.getcwd()
-
-        # Build path to new dir
-        full_path: str = os.path.join(path_to_delete, name_temp_dir)
-
-        # Delete dir in this block
-        try:
-
-            # Check if directory exists
-            if os.path.exists(full_path):
-
-                # Check if delete_files is True
-                if delete_files:
-                    # Delete all files in the directory
-                    shutil.rmtree(full_path)
-
-                else:
-                    # Delete the directory only
-                    os.rmdir(full_path)
-
-                result['success'] = True
-                result['path_deleted'] = fr'{full_path}'
-
-                if display_message:
-                    success_print(f"Dir:'{full_path}' Deleted!")
-                    
-            else:
-                result['success'] = False
-                result['path_deleted'] = None
-                alert_print(f"Dir:'{full_path}' Don't exists.")
-
-        except PermissionError:
-            result['success'] = False
-            result['path_deleted'] = None
-            alert_print(f"Permission Denied: Not Able to delete dir: '{full_path}'.")
-
-    except Exception as e:
-        result['success'] = False
-        result['path_deleted'] = None
-        error_print(f'Error capturing current path to delete temporary directory! Error: {str(e)}')
-        
-    finally:
-        return result

rpa_suite/log/__init__.py

@@ -1 +0,0 @@
-# /__init__.py

rpa_suite/log/functions_logger_uru.py

@@ -1,172 +0,0 @@
-# /functions_logger_uru.py
-
-from loguru import logger
-from rpa_suite.log.printer import error_print, alert_print
-import inspect, os
-
-def log_start_run_debug(msg_start_loggin: str) -> None: # represent start application
-
-    """
-    Function responsable to generate ``start run log level debug``, in file and print on terminal the same log captured on this call.
-    """
-
-    file_h: False
-
-    try:
-
-        from .logger_uru import config_logger
-        file_h = config_logger()
-
-    except Exception as e:
-
-        error_print(f'To use log_start_run_debug you need instance file_handler using file "logger_uru" on one file in your project! Error: {str(e)}')
-
-    try:
-        try:
-            if file_h:
-                with open(file_h, 'a') as f:
-                    f.write('\n')
-
-        except Exception as e:
-            alert_print(f"Don't able to break_row for initial log!")
-
-        # logger.debug(f'{msg_start_loggin}')
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincule o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).debug(f'{msg_start_loggin}')
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_start_run_debug.__name__}! Error: {str(e)}')
-
-
-def log_debug(msg) -> None:
-
-    """
-    Function responsable to generate log level ``debug``, in file and print on terminal the same log captured on this call.
-    """
-
-    try:
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtem o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combina o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincula o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).debug(msg)
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_debug.__name__}! Error: {str(e)}')
-
-def log_info(msg) -> None:
-
-    """
-    Function responsable to generate log level ``info``, in file and print on terminal the same log captured on this call.
-    """
-
-    try:
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtem o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combina o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincula o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).info(msg)
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_info.__name__}! Error: {str(e)}')
-
-def log_warning(msg) -> None:
-
-    """
-    Function responsable to generate log level ``warning``, in file and print on terminal the same log captured on this call.
-    """
-
-    try:
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincule o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).warning(msg)
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_warning.__name__}! Error: {str(e)}')
-
-
-def log_error(msg) -> None:
-
-    """
-    Function responsable to generate log level ``error``, in file and print on terminal the same log captured on this call.
-    """
-
-    try:
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincule o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).error(msg)
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_error.__name__}! Error: {str(e)}')
-
-
-def log_critical(msg) -> None:
-
-    """
-    Function responsable to generate log level ``critical``, in file and print on terminal the same log captured on this call.
-    """
-
-    try:
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Vincule o nome do arquivo e a linha à mensagem de log
-        logger.bind(filename=filename, lineno=lineno).critical(msg)
-
-    except Exception as e:
-        error_print(f'Error to execute function:{log_critical.__name__}! Error: {str(e)}')

rpa_suite/log/log_decorator.py

@@ -1,37 +0,0 @@
-# /log_decorator.py
-
-from typing import Callable
-from loguru import logger
-
-def logging_decorator(
-                    fn: Callable
-                    ) -> Callable:
-
-    """
-    Function responsible for displaying log message in the console for functions that are called. \n
-    Displays function name, and the result of the function in case of return, without return returns None.
-
-    Return:
-    ----------
-    A ``wrapper`` function with python decoration ``@logger.catch`` that received:
-        * ``*args and **kwargs`` in the call parameters as an argument to result in the Log.
-
-    Description: pt-br
-    ----------
-    Função responsavel por exibir mensagem de log no console para funções que são chamadas. \n
-    Exibe nome da função, e o resultado da função em caso de retorno, sem retorno devolve None.
-
-    Retorno:
-    ----------
-    Uma função ``wrapper`` com decoração ``@logger.catch`` do python que recebeu:
-        * ``*args e **kwargs`` nos parametros de chamada como argumento para resultar no Log.
-    """
-
-    @logger.catch
-    def wrapper(*args, **kwargs):
-        logger.info('Function Called: {}', fn.__name__)
-        result = fn(*args, **kwargs)
-        logger.info('Function {} returned: {}', fn.__name__, result)
-        return result
-
-    return wrapper

rpa_suite/log/logger_uru.py

@@ -1,110 +0,0 @@
-# /logger_uru.py
-
-from typing import Optional as Op
-from .__create_log_dir import _create_log_dir
-from rpa_suite.log.printer import error_print
-from loguru import logger
-import sys, os, inspect
-
-class Filters:
-    word_filter: Op[list[str]]
-
-    def __call__(self, record):
-
-        if len(self.word_filter) > 0:
-
-            for words in self.word_filter:
-
-                string_words: list[str] = [str(word) for word in words]
-
-                for word in string_words:
-                    if word in record["message"]:
-                        record["message"] = 'Log with filtered words!'
-                        return True
-
-        return True
-
-
-class CustomHandler:
-    def __init__(self, formatter):
-        self.formatter = formatter
-
-    def write(self, message):
-        frame = inspect.currentframe().f_back.f_back
-        log_msg = self.formatter.format(message, frame)
-        sys.stderr.write(log_msg)
-
-
-class CustomFormatter:
-    def format(self, record):
-
-        frame = inspect.currentframe().f_back
-        full_path_filename = frame.f_code.co_filename
-
-        # Obtenha o nome do arquivo e o nome da pasta
-        filename = os.path.basename(full_path_filename)
-        foldername = os.path.basename(os.path.dirname(full_path_filename))
-
-        # Combine o nome da pasta e o nome do arquivo
-        filename = os.path.join(foldername, filename)
-        lineno = frame.f_lineno
-
-        # Formate a mensagem de log TERMINAL
-        format_string = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <level>{message}</level>\n"
-
-        log_msg = format_string.format(
-            time=record["time"],
-            level=record["level"].name,
-            filename=filename,
-            lineno=lineno,
-            message=record["message"]
-        )
-        return log_msg
-
-def config_logger(path_dir:str = None, name_log_dir:str = None, name_file_log: str = 'log', use_default_path_and_name: bool = True, filter_words: list[str] = None):
-
-    """
-    Function responsible for create a object logger with fileHandler and streamHandler
-    """
-
-    try:
-
-        if not use_default_path_and_name:
-            result_tryed: dict = _create_log_dir(path_dir, name_log_dir)
-            path_dir = result_tryed['path_created']
-        else:
-            if path_dir == None and name_log_dir == None:
-                result_tryed: dict = _create_log_dir()
-                path_dir = result_tryed['path_created']
-
-
-        # ATRIBUIÇÕES
-        new_filter: Op[Filters] = None
-        if filter_words is not None:
-            new_filter: Filters = Filters()
-            new_filter.word_filter = [filter_words]
-
-
-        # configuração de objetos logger
-        file_handler = fr'{path_dir}\{name_file_log}.log'
-        logger.remove()
-
-        # Formate a mensagem de log FILE
-        log_format: str = "<green>{time:DD.MM.YY.HH:mm}</green> <level>{level: <8}</level> <green>{extra[filename]}</green>:{extra[lineno]: <4} <level>{message}</level>"
-
-
-        formatter = CustomFormatter()
-        if new_filter is not None:
-            logger.add(file_handler, filter=new_filter, level="DEBUG", format=log_format)
-        else:
-            logger.add(file_handler, level="DEBUG", format=log_format)
-
-        # Adicione sys.stderr como um manipulador
-        logger.add(sys.stderr, level="DEBUG", format=formatter.format)
-
-        return file_handler
-
-    except Exception as e:
-
-        error_print(f'Error to execute function:{config_logger.__name__}! Error: {str(e)}.')
-        return None

rpa_suite/regex/__init__.py

@@ -1 +0,0 @@
-# /__init__.py

rpa_suite/regex/pattern_in_text.py

@@ -1,58 +0,0 @@
-# /pattern_in_text.py
-
-import re
-from rpa_suite.log.printer import error_print, success_print
-
-
-def check_pattern_in_text(origin_text: str,
-                        pattern_to_search: str, 
-                        case_sensitive: bool = True,
-                        display_message: bool = False) -> bool:
-
-    """
-    Function responsible for searching in a string ``origin_text`` a pattern ``pattern_to_search`` and returning True if the pattern is found, otherwise False. ``case_sensitive`` used for exact cases or cases with diferencce upper and lower cases
-
-    Return:
-    ----------
-    A boolean indicating whether the pattern was found in the text.
-
-    Description: pt-br
-    ----------
-    Função responsável por buscar em um texto de leitura humana uma string ``origin_text`` por um padrão ``pattern_to_search`` e retornar True se o padrão for encontrado, caso contrário, False. ``case_sensitive`` usado para casos exatos ou casos com diferença entre caixa alta e baixa nos caracteres.
-
-    Retorno:
-    ----------
-    Um booleano indicando se o padrão foi encontrado no texto.
-    """
-
-    try:
-
-        if case_sensitive:
-            
-            # Check if the pattern is found in the text
-            if re.search(pattern_to_search, origin_text):
-                if display_message: success_print(f'Pattern found successfully!')
-                return True
-            
-            else:
-                if display_message: success_print(f'Pattern not found.')
-                return False
-        else:
-            
-            # normalize text to search without case sensitive
-            origin_text = origin_text.lower()
-            pattern_to_search = pattern_to_search.lower()
-            
-            # Check if the pattern is found in the text
-            if re.search(pattern_to_search, origin_text):
-                if display_message: success_print(f'Pattern found successfully!')
-                return True
-            
-            else:
-                if display_message: success_print(f'Pattern not found.')
-                return False
-            
-    except Exception as e:
-        
-        error_print(f"Error when trying to check pattern in text. Error: {str(e)}")
-        return False

rpa_suite/validate/__init__.py

@@ -1 +0,0 @@
-# /__init__.py