rpa-suite 0.9.3__tar.gz → 1.0.0__tar.gz

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa_suite
-Version: 0.9.3
+Version: 1.0.0
 Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
 Author: Camilo Costa de Carvalho
 Author-email: camilo.carvalho@triasoftware.com.br
@@ -22,6 +22,7 @@ License-File: LICENSE
 Requires-Dist: loguru
 Requires-Dist: colorama
 Requires-Dist: email_validator
+Requires-Dist: colorlog
 
 ![RPA Suite](https://raw.githubusercontent.com/CamiloCCarvalho/rpa_suite/3e1ccd0acad654916466f03c2b8f166dc8d360d4/logo-rpa-suite.svg)
 
@@ -126,6 +127,7 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - colorama
 - loguru
 - email-validator
+- colorlog
   
 ## Estrutura do módulo
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
@@ -141,7 +143,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **counter** - Funções para contagem de arquivos
         - **temp_dir** - Funções para diretórios temporários
     - **log**
-        - **loggin** - Funções decoradoras com log de execução das funções
+        - **logger** - Objeto de log, cria diretório/arquivo de log integrado aos prints
         - **printer** - Funções print personalizados (alerta, erro, sucesso, informativo)
     - **regex**
         - **list_from_text** - Funções para gerar listas, dividindo texto usando padrão regex
@@ -150,7 +152,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Funções para validação/varredura (strings, substrings, palavras)
 
 ## Release
-Versão: **Alpha 0.9.3**
+Versão: **Beta 1.0.0**
 
 Lançamento: *20/02/2024*
 

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/README.md

@@ -101,6 +101,7 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - colorama
 - loguru
 - email-validator
+- colorlog
   
 ## Estrutura do módulo
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
@@ -116,7 +117,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **counter** - Funções para contagem de arquivos
         - **temp_dir** - Funções para diretórios temporários
     - **log**
-        - **loggin** - Funções decoradoras com log de execução das funções
+        - **logger** - Objeto de log, cria diretório/arquivo de log integrado aos prints
         - **printer** - Funções print personalizados (alerta, erro, sucesso, informativo)
     - **regex**
         - **list_from_text** - Funções para gerar listas, dividindo texto usando padrão regex
@@ -125,7 +126,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Funções para validação/varredura (strings, substrings, palavras)
 
 ## Release
-Versão: **Alpha 0.9.3**
+Versão: **Beta 1.0.0**
 
 Lançamento: *20/02/2024*
 

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/clock/exec_at.py

@@ -8,7 +8,7 @@ def exec_at_hour(
                 fn_to_exec: Callable[..., Any],
                 *args,
                 **kwargs,
-                ) -> dict:
+                ) -> dict[str, bool]:
     
     """
     Timed function, executes the function at the specified time, by ``default`` it executes at runtime, optionally you can choose the time for execution.
@@ -65,35 +65,18 @@ def exec_at_hour(
     minutes: str
     moment_now: str
     
-    # Preprocessing
-    run = True
-    now = dt.now()
-    hours = str(now.hour) if now.hour > 10 else f"0{now.hour}"
-    minutes = str(now.minute) if now.minute > 10 else f"0{now.minute}"
-    moment_now = f'{hours}:{minutes}'
-    
-    if hour_to_exec == None:
+    try:
+        # Preprocessing
+        run = True
+        now = dt.now()
+        hours = str(now.hour) if now.hour > 10 else f"0{now.hour}"
+        minutes = str(now.minute) if now.minute > 10 else f"0{now.minute}"
+        moment_now = f'{hours}:{minutes}'
         
-        # Process
-        while run:
-            try:
-                fn_to_exec(*args, **kwargs)
-                run = False
-                result['tried'] = not run
-                result['success'] = True
-                success_print(f'{fn_to_exec.__name__}: Successfully executed!')
-                break
-                
-            except Exception as e:
-                run = False
-                result['tried'] = not run
-                result['success'] = False
-                error_print(f'An error occurred that prevented the function from executing: {fn_to_exec.__name__} correctly. Error: {str(e)}')
-                break
-    else:
-        # Executes the function call only at the time provided in the argument.
-        while run:
-            if moment_now == hour_to_exec:
+        if hour_to_exec == None:
+            
+            # Process
+            while run:
                 try:
                     fn_to_exec(*args, **kwargs)
                     run = False
@@ -108,11 +91,35 @@ def exec_at_hour(
                     result['success'] = False
                     error_print(f'An error occurred that prevented the function from executing: {fn_to_exec.__name__} correctly. Error: {str(e)}')
                     break
-            else:
-                time.sleep(30)
-                now = dt.now()
-                hours = str(now.hour) if now.hour > 10 else f"0{now.hour}"
-                minutes = str(now.minute) if now.minute > 10 else f"0{now.minute}"
-                moment_now = f'{hours}:{minutes}'
+        else:
+            # Executes the function call only at the time provided in the argument.
+            while run:
+                if moment_now == hour_to_exec:
+                    try:
+                        fn_to_exec(*args, **kwargs)
+                        run = False
+                        result['tried'] = not run
+                        result['success'] = True
+                        success_print(f'{fn_to_exec.__name__}: Successfully executed!')
+                        break
+                        
+                    except Exception as e:
+                        run = False
+                        result['tried'] = not run
+                        result['success'] = False
+                        error_print(f'An error occurred that prevented the function from executing: {fn_to_exec.__name__} correctly. Error: {str(e)}')
+                        break
+                else:
+                    time.sleep(30)
+                    now = dt.now()
+                    hours = str(now.hour) if now.hour > 10 else f"0{now.hour}"
+                    minutes = str(now.minute) if now.minute > 10 else f"0{now.minute}"
+                    moment_now = f'{hours}:{minutes}'
 
-    return result
+        return result
+    
+    except Exception as e:
+        
+        result['success'] = False
+        error_print(f'An error occurred on function from executing: {fn_to_exec.__name__}. Error: {str(e)}')
+        return result

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/clock/waiter.py

@@ -7,7 +7,7 @@ def wait_for_exec(
                 fn_to_exec: Callable[..., Any],
                 *args,
                 **kwargs
-                ) -> dict:
+                ) -> dict[str, bool]:
     
     """
     Timer function, wait for a value in ``seconds`` to execute the function of the argument.
@@ -74,7 +74,7 @@ def exec_and_wait(
                 fn_to_exec: Callable[..., Any],
                 *args,
                 **kwargs
-                ) -> dict:
+                ) -> dict[str, bool]:
     
     """
     Timer function, executes a function and waits for the time in ``seconds``

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/date/date.py

@@ -1,9 +1,10 @@
 import datetime as dt
+from typing import Optional as Op
+from typing import Tuple
 from rpa_suite.log.printer import error_print
 
 
-        
-def get_hms() -> tuple:
+def get_hms() -> Tuple[Op[str], Op[str], Op[str]]:
     
     """
     Function to return hour, minute and second. The return is in the form of a tuple with strings being able to store and use the values individually.
@@ -63,10 +64,14 @@ def get_hms() -> tuple:
                 hours[1:]
                 
         return hours, minutes, seconds
+    
     except Exception as e:
-        return error_print(f'Unable to capture the time. Error: {str(e)}')
 
-def get_dma() -> tuple:
+        error_print(f'Unable to capture the time. Error: {str(e)}')
+        return None, None, None
+
+
+def get_dma() -> Tuple[Op[str], Op[str], Op[str]]:
     """
     Function to return day, month and year. The return is in the form of a tuple with strings being able to store and use the values individually.
     
@@ -112,4 +117,6 @@ def get_dma() -> tuple:
         return day_got, month_got, year_got
     
     except Exception as e:
-        return error_print(f'Unable to capture the time. Error: {str(e)}')
+
+        error_print(f'Unable to capture the time. Error: {str(e)}')
+        return None, None, None

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/email/sender_smtp.py

@@ -122,6 +122,7 @@ def send_email(
             
     # Add Attachment
     if attachments:
+        result['qt_attach'] = 0
         result['attchament'] = True
         for path_to_attach in attachments:
             file_name = os.path.basename(path_to_attach)
@@ -170,7 +171,7 @@ def send_email(
         server_by_smtp.quit()
         result['success'] = True
         success_print(f'Email(s) Sent!')
-        
+
 
     except smtplib.SMTPException as e:
         result['success'] = False

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/file/counter.py

@@ -1,53 +1,53 @@
 import os
+from typing import Dict, List, Union
 from rpa_suite.log.printer import error_print, success_print
 
+
 def count_files(
-                dir_to_count: list[str], 
-                type_extension: str = '*'
-                ) -> dict:
-    
+    dir_to_count: List[str], 
+    type_extension: str = '*'
+) -> Dict[str, Union[bool, int]]:
+
     """
     Function responsible for counting files within a folder, considers subfolders to do the count, searches by file type, being all files by default. \n
-    
+
     Parameters:
     ----------
     ``dir_to_count: list`` - should be a list, accepts more than one path to count files.
     ``type_extension: str`` - should be a string with the format/extension of the type of file you want to be searched for counting, if empty by default will be used ``*`` which will count all files.
 
-    
     Return:
     ----------
     >>> type:dict
         * 'success': bool - represents if the action was performed successfully
         * 'qt': int - number that represents the quantity of files that were counted
-        
+
     Description: pt-br
     ----------
     Função responsavel por fazer a contagem de arquivos dentro de uma pasta, considera subpastas para fazer a contagem, busca por tipo de arquivo, sendo todos arquivos por default. \n
-    
+
     Parametros:
     ----------
     ``dir_to_count: list`` - deve ser uma lista, aceita mais de um caminho para contar arquivos.
     ``type_extension: str`` - deve ser uma string com o formato/extensão do tipo de arquivo que deseja ser buscado para contagem, se vazio por default sera usado ``*`` que contará todos arquivos.
 
-    
     Retorno:
     ----------
     >>> type:dict
         * 'success': bool - representa se ação foi realizada com sucesso
         * 'qt': int - numero que representa a quantidade de arquivos que foram contados
     """
-    
+
     # Local Variables
     result: dict = {
         'success': bool,
         'qt': int
     }
-    
+
     # Preprocessing
-    result['qt'] = 0
     result['success'] = False
-    
+    result['qt'] = 0
+
     # Process
     try:
         for dir in dir_to_count:
@@ -57,9 +57,10 @@ def count_files(
                         result['qt'] += 1
         result['success'] = True
         success_print(f'Function: {count_files.__name__} counted {result["qt"]} files.')
-        
+
     except Exception as e:
         result['success'] = False
         error_print(f'Error when trying to count files! Error: {str(e)}')
-        
-    return result
+
+    finally:
+        return result

rpa_suite-1.0.0/rpa_suite/log/__create_log_dir.py

@@ -0,0 +1,81 @@
+import os
+from typing import Union
+from rpa_suite.log.printer import error_print, alert_print, success_print
+
+
+def _create_log_dir(path_to_create: str = 'default', name_log_dir: str='logs') -> dict[str, Union[bool, str, None]]:
+
+    """
+    Function responsible for creating a logger directory to work with files ``.log``. \n
+
+    Parameters:
+    ----------
+    ``path_to_create: str`` - should be a string with the full path pointing to the folder where the logger 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_log_dir: str`` - should be a string representing the name of the logger 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 de logger para trabalhar com arquivos de log. \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_log_dir: str`` - deve ser uma string representando o nome do diretório de logger 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_log_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}'
+
+            success_print(f"Diretório:'{full_path}' foi criado com sucesso.")
+
+        except FileExistsError:
+            result['success'] = False
+            result['path_created'] = full_path
+            # alert_print(f"Diretório:'{full_path}' já existe.")
+
+        except PermissionError:
+            result['success'] = False
+            result['path_created'] = None
+            alert_print(f"Permissão negada: não é possível criar o diretório '{full_path}'.")
+
+    except Exception as e:
+        result['success'] = False
+        result['path_created'] = None
+        error_print(f'Error capturing current path to create logger directory! Error: {str(e)}')
+        
+    finally:
+        return result

rpa_suite-1.0.0/rpa_suite/log/_variables.py

@@ -0,0 +1,8 @@
+from logging import FileHandler, StreamHandler
+from typing import Optional
+
+# Variável global para o manipulador de arquivo
+file_handler: Optional[FileHandler] = None
+
+# Variável global para o manipulador de stream stdout/stdin/buffer
+stream_handler: Optional[StreamHandler] = None

rpa_suite-1.0.0/rpa_suite/log/functions_logger.py

@@ -0,0 +1,94 @@
+import logging
+from .logger import file_handler
+from rpa_suite.log.printer import error_print, success_print
+
+
+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.
+    """
+
+    try:
+        global file_handler
+        file_handler.stream.write(f'\n{msg_start_loggin}\n')
+        success_print(f'{msg_start_loggin}')
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.debug(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.info(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.info(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.warning(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.error(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {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:
+        logging.critical(msg)
+
+    except Exception as e:
+        error_print(f'Erro durante a função: {log_critical.__name__}! Error: {str(e)}')

rpa_suite-0.9.3/rpa_suite/log/loggin.py → rpa_suite-1.0.0/rpa_suite/log/log_decorator.py

@@ -4,32 +4,32 @@ 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-1.0.0/rpa_suite/log/logger.py

@@ -0,0 +1,111 @@
+import logging
+from logging import CRITICAL, ERROR, WARNING, INFO, DEBUG
+from logging import FileHandler, StreamHandler, Filter
+from colorlog import ColoredFormatter
+from typing import Optional as Op
+from ._variables import file_handler, stream_handler
+from .__create_log_dir import _create_log_dir
+from rpa_suite.log.printer import error_print
+
+
+class Filters(Filter):
+
+    word_filter: Op[list[str]]
+
+    def filter(self, record):
+
+        if len(self.word_filter) > 0:
+
+            for words in self.word_filter:
+
+
+                string_words: list[str] = [str(word) for word in words]
+                """print(words)
+                print(type(words))
+                print(string_words)
+                print(type(string_words))
+                input()"""
+                for word in string_words:
+                    if word in record.msg:
+                        record.msg = 'Log Alterado devido a palavra Filtrada!'
+                        return True
+
+        return True
+
+
+def config_logger(name_app:str = '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) -> Op[FileHandler]:
+
+    """
+    Function responsible for create a object logger with fileHandler and streamHandler
+    """
+
+    global file_handler, stream_handler
+
+    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']
+
+
+        # configuração de objetos logger
+        file_handler = FileHandler(
+            filename=fr'{path_dir}\{name_file_log}.log',
+            mode='a',
+            encoding='utf-8'
+        )
+        stream_handler = StreamHandler()
+
+        # Crie um formatador
+        formatter = ColoredFormatter(
+            "%(log_color)s%(levelname)s ->%(reset)s %(log_color)s%(message)s%(reset)s",
+            datefmt=None,
+            reset=True,
+            log_colors={
+                'DEBUG':    'cyan',
+                'INFO':     'green',
+                'WARNING':  'yellow',
+                'ERROR':    'red',
+                'CRITICAL': 'red',
+            },
+            force_color=True
+        )
+        stream_handler.setFormatter(formatter)
+
+        # ATRIBUIÇÕES
+        new_filter: Op[Filters] = None
+        if filter_words is not None:
+            new_filter: Filters = Filters()
+            new_filter.word_filter = [filter_words]
+
+        if new_filter is not None:
+            file_handler.addFilter(new_filter)
+
+        file_handler.setLevel(DEBUG)
+        
+        # Obtenha o logger
+        logger = logging.getLogger(__name__)
+
+        # Adicione o manipulador de stream ao logger
+        logger.addHandler(stream_handler)
+
+        # terminando de inplementar configuração para o logger
+        FORMAT = '%(levelname)s!%(asctime)s: %(message)s'
+        logging.basicConfig(
+            level=DEBUG, # level from stream_handler
+            #format='%(levelname)s - %(asctime)s - %(message)s',
+            format=FORMAT,
+            handlers=[file_handler, stream_handler],
+            datefmt='%d.%m.%y %H:%M',
+        )
+        return file_handler
+
+    except Exception as e:
+
+        error_print(f'Houve um erro durante a execução da função: {config_logger.__name__}! Error: {str(e)}.')
+        return None

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/log/printer.py

@@ -1,4 +1,4 @@
-from colorama import Fore, Back, Style
+from colorama import Fore
 
 # Windows bash colors
 class Colors():
@@ -18,29 +18,30 @@ class Colors():
 def success_print(string_text: str, color=Colors.green, ending="\n") -> None:
     """
     Print that indicates ``SUCCESS``. Customized with the color Green \n
-    
+
     Return:
     ----------
         >>> type:None
-        
+
     pt-br
     ----------
     Print  que indica ``SUCESSO``. Personalizado com a cor Verde \n
-    
+
     Retorno:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending) 
+    print(f'{color} {string_text} {Colors.default}', end=ending) 
+
 
 def alert_print(string_text: str, color=Colors.yellow, ending="\n") -> None:
     """
     Print that indicates ``ALERT``. Customized with the color Yellow \n
-    
+
     Return:
     ----------
         >>> type:None
-    
+
     pt-br
     ----------
     Print que indica ``ALERTA``. Personalizado com a cor Amarelo \n
@@ -48,16 +49,17 @@ def alert_print(string_text: str, color=Colors.yellow, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending) 
+    print(f'{color} {string_text} {Colors.default}', end=ending) 
+
 
 def info_print(string_text: str, color=Colors.cyan, ending="\n") -> None:
     """
     Print that indicates ``INFORMATION``. Customized with the color Cyan \n
-    
+
     Return:
     ----------
         >>> type:None
-        
+
     pt-br
     ----------
     Print que indica ``INFORMATIVO``. Personalizado com a cor Ciano \n
@@ -65,16 +67,17 @@ def info_print(string_text: str, color=Colors.cyan, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending) 
+    print(f'{color} {string_text} {Colors.default}', end=ending) 
+
 
 def error_print(string_text: str, color=Colors.red, ending="\n") -> None:
     """
     Print that indicates ``ERROR``. Customized with the color Red \n
-    
+
     Return:
     ----------
         >>> type:None
-        
+
     pt-br
     ----------
     Print que indica ``ERRO``. Personalizado com a cor Vermelho \n
@@ -82,16 +85,17 @@ def error_print(string_text: str, color=Colors.red, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending) 
+    print(f'{color} {string_text} {Colors.default}', end=ending) 
+
 
 def magenta_print(string_text: str, color=Colors.magenta, ending="\n") -> None:
     """
     Print customized with the color Magenta \n
-    
+
     Return:
     ----------
         >>> type:None
-    
+
     pt-br
     ----------
     Print personalizado com a cor Magenta \n
@@ -99,16 +103,17 @@ def magenta_print(string_text: str, color=Colors.magenta, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending) 
+    print(f'{color} {string_text} {Colors.default}', end=ending) 
+
 
 def blue_print(string_text: str, color=Colors.blue, ending="\n") -> None:
     """
     Print customized with the color Blue \n
-    
+
     Return:
     ----------
         >>> type:None
-    
+
     pt-br
     ----------
     Print personalizado com a cor Azul \n
@@ -116,7 +121,8 @@ def blue_print(string_text: str, color=Colors.blue, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending)
+    print(f'{color} {string_text} {Colors.default}', end=ending)
+
 
 def print_call_fn(string_text: str, color=Colors.call_fn, ending="\n") -> None:
     """
@@ -125,7 +131,7 @@ def print_call_fn(string_text: str, color=Colors.call_fn, ending="\n") -> None:
     Return:
     ----------
         >>> type:None
-    
+
     pt-br
     ----------
     Print personalizado para log de chamada de função. \n
@@ -134,7 +140,8 @@ def print_call_fn(string_text: str, color=Colors.call_fn, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending)
+    print(f'{color} {string_text} {Colors.default}', end=ending)
+
 
 def print_retur_fn(string_text: str, color=Colors.retur_fn, ending="\n") -> None:
     """
@@ -143,7 +150,7 @@ def print_retur_fn(string_text: str, color=Colors.retur_fn, ending="\n") -> None
     Return:
     ----------
         >>> type:None
-    
+
     pt-br
     ----------
     Print personalizado para log de chamada de função. \n
@@ -152,4 +159,4 @@ def print_retur_fn(string_text: str, color=Colors.retur_fn, ending="\n") -> None
     ----------
         >>> type:None
     """
-    return print(f'{color} {string_text} {Colors.default}', end=ending)
+    print(f'{color} {string_text} {Colors.default}', end=ending)

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/regex/list_from_text.py

@@ -3,9 +3,10 @@ from typing import Any
 from rpa_suite.log.printer import error_print, success_print
 
 def create_list_using_regex(origin_text: str, division_pattern: str) -> list[str] | Any:
+
     """
     Function responsible for searching in a string ``origin_text`` a pattern ``division_pattern`` and dividing the original text into substrings generating a list of strings, also does the cleaning and treatment to keep the list with the original strings, but divided
-    
+
     Return:
     ----------
     A list of strings divided by the pattern used in the argument passed as a parameter.
@@ -13,11 +14,12 @@ def create_list_using_regex(origin_text: str, division_pattern: str) -> list[str
     Description: pt-br
     ----------
     Função responsável por buscar em  um texto de leitura humana uma string ``origin_text`` por um padrão ``division_pattern`` e dividir o texto original em substrings gerando uma lista de strings, também faz a limpeza e tratamento para manter a lista com as strings originais, porem dividas
-    
+
     Retorno:
     ----------
     Uma lista de strings dividas pelo padrão utilizada no argumento passado como parametro.
     """
+
     try:
         # creates a delimiter and uses it to split the string based on the pattern
         text_with_delim = re.sub(division_pattern, r'\1<DELIMITADOR>', origin_text)
@@ -33,11 +35,11 @@ def create_list_using_regex(origin_text: str, division_pattern: str) -> list[str
         # Removes the delimiter \n both left and right from each element of the list
         messages_striped = [msg.strip() for i, msg in enumerate(messages)]
         messages_lstriped = [msg.lstrip() for msg in messages_striped]
-        
+
         # Removes the delimiter that has been placed between punctuation within the same pattern.
         messages_final = [msg.replace('\n', ' ') for msg in messages_lstriped]
         success_print(f'List generated successfully!')
         return messages_final
-            
+
     except Exception as e:
-        return error_print(f"Error when trying to create list using pattern-match (regex). Error: {str(e)}")
+        error_print(f"Error when trying to create list using pattern-match (regex). Error: {str(e)}")

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite/suite.py

@@ -1,72 +1,84 @@
+
 """MODULE CLOCK"""
 from .clock.waiter import wait_for_exec, exec_and_wait
 from .clock.exec_at import exec_at_hour
 
+
 """MODULE DATE"""
 from .date.date import get_hms, get_dma
 
+
 """MODULE EMAIL"""
 from .email.sender_smtp import send_email
 
+
 """MODULE FILE"""
 from .file.counter import count_files
 from .file.temp_dir import create_temp_dir, delete_temp_dir
 
+
 """MODULE LOG"""
 # from .log.loggin import logging_decorator
 from .log.printer import alert_print, success_print, error_print, info_print, print_call_fn, print_retur_fn, magenta_print, blue_print
 
+from .log.logger import config_logger
+from .log.functions_logger import log_start_run_debug, log_debug, log_info, log_warning, log_error, log_critical 
+
+
 """MODULE REGEX"""
 from .regex.list_from_text import create_list_using_regex
 
+
 """MODULE VALIDATE"""
 from .validate.mail_validator import valid_emails
 from .validate.string_validator import search_in
 
+
 class Rpa_suite():
+
     """
     The ``Rpa_suite`` class is a generic representation of the modules, with the aim of centralizing all submodules for access through an instance of this representational Object. It contains variables pointed to the functions of the submodules present in the rpa-site.
-    
+
     Call
     ----------
     When calling the maintainer file of this class, an instance of this object will be invoked to be used or reused through another variable
-    
+
     Objective
     ----------
     Flexibility being able to call each submodule individually or by importing the representational object of all submodules.
-    
+
     Description: pt-br
     ----------
     Classe ``Rpa_suite`` é uma representação genérica do dos módulos, com objetivo de centralizar todos submódulos para acesso através de uma instância deste Objeto representacional. Ele contem variaveis apontadas para as funções dos submódulos presentes no rpa-site.
-    
+
     Chamada
     ----------
     Ao chamar o arquivo mantenedor desta classe, sera invocada uma instancia deste objeto para poder ser utilziado ou reutilizado através de outra variável
-    
+
     Objetivo
     ----------
     Flexibilidade podendo chamar cada submódulo de forma individual ou fazendo a importação do objeto representacional de todos submódulos.
     """
-    
+
     # clock
     wait_for_exec = wait_for_exec
     exec_and_wait = exec_and_wait
     exec_at_hour = exec_at_hour
-    
+
     # date
     get_hms = get_hms
     get_dma = get_dma
-    
+
     # email
     send_email = send_email
-    
+
     # file
     count_files = count_files
     create_temp_dir = create_temp_dir
     delete_temp_dir = delete_temp_dir
     #clear_temp_dir = clear_temp_dir
-    
-    # log
+
+    # log - printer
     alert_print = alert_print
     success_print = success_print
     error_print = error_print
@@ -76,18 +88,31 @@ class Rpa_suite():
     magenta_print = magenta_print
     blue_print = blue_print
     
+    # log - logger with file and prints
+    config_logger = config_logger
+    log_start_run_debug = log_start_run_debug
+    log_debug = log_debug
+    log_info = log_info
+    log_warning = log_warning
+    log_error = log_error
+    log_critical = log_critical
+
     # regex
     create_list_using_regex = create_list_using_regex
-    
+
     # validate
     valid_emails = valid_emails
     search_in = search_in
-    
+
 # Create a instance of Rpa_suite
 
 
 # Define function to return this instance
-def invoke():
+def invoke() -> Rpa_suite:
+
+    """
+    Function responsible for return a object Rpa_suite with access all modules by .name_module or use 'from rpa_suite import suite' to >>> suite.functions_avaliable()
+    """
+
     suite = Rpa_suite()
     return suite
-

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa-suite
-Version: 0.9.3
+Version: 1.0.0
 Summary: Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.
 Author: Camilo Costa de Carvalho
 Author-email: camilo.carvalho@triasoftware.com.br
@@ -22,6 +22,7 @@ License-File: LICENSE
 Requires-Dist: loguru
 Requires-Dist: colorama
 Requires-Dist: email_validator
+Requires-Dist: colorlog
 
 ![RPA Suite](https://raw.githubusercontent.com/CamiloCCarvalho/rpa_suite/3e1ccd0acad654916466f03c2b8f166dc8d360d4/logo-rpa-suite.svg)
 
@@ -126,6 +127,7 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - colorama
 - loguru
 - email-validator
+- colorlog
   
 ## Estrutura do módulo
 O módulo principal do rpa-suite é dividido em categorias. Cada categoria contém módulos com funções destinadas a cada tipo de tarefa
@@ -141,7 +143,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **counter** - Funções para contagem de arquivos
         - **temp_dir** - Funções para diretórios temporários
     - **log**
-        - **loggin** - Funções decoradoras com log de execução das funções
+        - **logger** - Objeto de log, cria diretório/arquivo de log integrado aos prints
         - **printer** - Funções print personalizados (alerta, erro, sucesso, informativo)
     - **regex**
         - **list_from_text** - Funções para gerar listas, dividindo texto usando padrão regex
@@ -150,7 +152,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Funções para validação/varredura (strings, substrings, palavras)
 
 ## Release
-Versão: **Alpha 0.9.3**
+Versão: **Beta 1.0.0**
 
 Lançamento: *20/02/2024*
 

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite.egg-info/SOURCES.txt

@@ -19,8 +19,12 @@ rpa_suite/email/sender_smtp.py
 rpa_suite/file/__init__.py
 rpa_suite/file/counter.py
 rpa_suite/file/temp_dir.py
+rpa_suite/log/__create_log_dir.py
 rpa_suite/log/__init__.py
-rpa_suite/log/loggin.py
+rpa_suite/log/_variables.py
+rpa_suite/log/functions_logger.py
+rpa_suite/log/log_decorator.py
+rpa_suite/log/logger.py
 rpa_suite/log/printer.py
 rpa_suite/regex/__init__.py
 rpa_suite/regex/list_from_text.py

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/rpa_suite.egg-info/requires.txt

@@ -1,3 +1,4 @@
 loguru
 colorama
 email_validator
+colorlog

{rpa_suite-0.9.3 → rpa_suite-1.0.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='0.9.3',
+    version='1.0.0',
     packages=find_packages(),
     description='Conjunto de ferramentas essenciais para Automação RPA com Python, que facilitam o dia a dia de desenvolvimento.',
     long_description_content_type='text/markdown',
@@ -24,5 +24,5 @@ setup(
         'Topic :: Software Development :: Libraries :: Python Modules'
     ],
     keywords='basic-tools, email-tools, email-validation, file-tools, simple-functions, rpa-tools, rpa-functions, Tools, Rpa, Automation, RPA, Automação, Python, Ferramentas de RPA, Automação de Processos, Biblioteca Python para RPA',
-    install_requires=['loguru', 'colorama', 'email_validator'],
+    install_requires=['loguru', 'colorama', 'email_validator', 'colorlog'],
 )