rpa-suite 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl

rpa_suite/__init__.py

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

rpa_suite/clock/__init__.py

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

rpa_suite/clock/exec_at.py

@@ -1,3 +1,5 @@
+# /exec_at.py
+
 import time
 from typing import Callable, Any
 from datetime import datetime as dt

rpa_suite/clock/scheduler.py

@@ -1,3 +1,5 @@
+# /scheduler.py
+
 import schedule
 import time
 import subprocess

rpa_suite/clock/waiter.py

@@ -1,3 +1,5 @@
+# /waiter.py
+
 import time
 from typing import Callable, Any
 from rpa_suite.log.printer import error_print, success_print

rpa_suite/date/__init__.py

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

rpa_suite/date/date.py

@@ -1,3 +1,5 @@
+# /date.py
+
 import datetime as dt
 from typing import Optional as Op
 from typing import Tuple

rpa_suite/email/__init__.py

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

rpa_suite/email/sender_smtp.py

@@ -1,3 +1,5 @@
+# /sender_smtp.py
+
 import smtplib, os
 from email.mime.image import MIMEImage
 from email.mime.multipart import MIMEMultipart

rpa_suite/file/__init__.py

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

rpa_suite/file/counter.py

@@ -1,3 +1,5 @@
+# /counter.py
+
 import os
 from typing import Dict, List, Union
 from rpa_suite.log.printer import error_print, success_print

rpa_suite/file/screen_shot.py

@@ -0,0 +1,82 @@
+# /screen_shot.py
+
+import os, time
+from datetime import datetime
+from rpa_suite import suite as rpa
+
+
+try:
+    import pyautogui
+    import pyscreeze
+    
+except ImportError:
+    raise ImportError(" The ‘pyautogui’, ‘Pillow’, and ‘PyScreeze’ libraries are necessary to use this module. Please install them with ‘pip install pyautogui pillow pyscreeze’.")
+
+
+def screen_shot(file_path: str, file_name: str = 'screenshot', save_with_date: bool = True, delay: int = 1) -> 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:
+        
+        time.sleep(delay)
+        if not os.path.exists(file_path):
+
+            # if dir not exists create it
+            try:
+                os.makedirs(file_path)
+                rpa.success_print(f"Diretório criado com sucesso em: '{file_path}'!")
+
+            except OSError as e:
+                rpa.error_print(f"Falha ao criar o diretório em: '{file_path}'! Error: {str(e)}")
+
+        
+        if save_with_date: # use date on file name
+            image = pyautogui.screenshot()
+            path_file_screenshoted =  fr'{file_path}/{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
+
+            image.save(path_file_screenshoted)
+            return os.path.abspath(path_file_screenshoted)
+        
+        else: # not use date on file name
+            image = pyautogui.screenshot()
+            path_file_screenshoted =  fr'{file_path}/{file_name}.png'
+
+            image.save(path_file_screenshoted)
+            return os.path.abspath(path_file_screenshoted)
+    
+    except Exception as e:
+
+        rpa.error_print(f'Erro durante a função {screen_shot.__name__}! Error: {str(e)}')
+        return None

rpa_suite/file/temp_dir.py

@@ -1,3 +1,5 @@
+# /temp_dir.py
+
 import os, shutil
 from typing import Union
 from rpa_suite.log.printer import error_print, alert_print, success_print

rpa_suite/log/__create_log_dir.py

@@ -1,3 +1,5 @@
+# /_create_log_dir.py
+
 import os
 from typing import Union
 from rpa_suite.log.printer import error_print, alert_print, success_print

rpa_suite/log/__init__.py

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

rpa_suite/log/{functions_logger.py → _functions_logger.py}

@@ -1,5 +1,7 @@
+# /_functions_logger.py
+
 import logging
-from .logger import file_handler
+from ._logger import file_handler
 from rpa_suite.log.printer import error_print, success_print
 
 

rpa_suite/log/{logger.py → _logger.py}

@@ -1,3 +1,5 @@
+# /_logger.py
+
 import logging
 from logging import DEBUG
 from logging import FileHandler, StreamHandler, Filter

rpa_suite/log/_variables.py

@@ -1,3 +1,5 @@
+# /_variables.py
+
 from logging import FileHandler, StreamHandler
 from typing import Optional
 

rpa_suite/log/_variables_uru.py

@@ -1,3 +1,5 @@
+# /_variables_uru.py
+
 from loguru import logger
 from typing import Optional
 from typing import Any

rpa_suite/log/functions_logger_uru.py

@@ -1,3 +1,5 @@
+# /functions_logger_uru.py
+
 from loguru import logger
 from rpa_suite.log.printer import error_print, alert_print
 import inspect, os

rpa_suite/log/log_decorator.py

@@ -1,3 +1,5 @@
+# /log_decorator.py
+
 from typing import Callable
 from loguru import logger
 

rpa_suite/log/printer.py

@@ -1,3 +1,5 @@
+# /printer.py
+
 from colorama import Fore
 
 # Windows bash colors

rpa_suite/regex/__init__.py

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

rpa_suite/regex/list_from_text.py

@@ -1,3 +1,5 @@
+# /list_from_text.py
+
 import re
 from typing import Any
 from rpa_suite.log.printer import error_print, success_print

rpa_suite/suite.py

@@ -1,3 +1,31 @@
+# suite.py
+
+"""
+This file is the heart of the library, acting as a central access point to all available submodules. It imports and instantiates all functions from the submodules into a single object, `Rpa_suite`, allowing users to access all functionalities of the library by importing just this object.
+
+The structure of the library has been designed to be modular and organized, with each submodule dedicated to a specific type of functionality. Each submodule is contained in its own folder, making the code easier to navigate and maintain.
+
+Upon installing the library, users only need to import the `Rpa_suite` object to have access to all available functions. This is done through the `invoke` function, which returns an instance of the `Rpa_suite` object.
+
+Here is an overview of the available submodules:
+
+- **CLOCK**: Functions related to time, such as waiting for an execution or executing at a specific hour.
+- **DATE**: Functions for working with dates.
+- **EMAIL**: Functions for sending emails.
+- **FILE**: Functions for working with files, such as counting files or creating temporary directories.
+- **LOG**: Functions for logging events and printing messages.
+- **REGEX**: Functions for working with regular expressions.
+- **VALIDATE**: Functions for validating inputs, such as emails or strings.
+
+Remember, to use the library, just do the following:
+
+    # On your project
+        from rpa_suite import suite as rpa
+
+    # call functions
+        rpa.success_print(f'This work!')
+
+"""
 
 """MODULE CLOCK"""
 from .clock.waiter import wait_for_exec, exec_and_wait
@@ -21,8 +49,8 @@ from .file.temp_dir import create_temp_dir, delete_temp_dir
 # 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 
+from .log.logger_uru import config_logger
+from .log.functions_logger_uru import log_start_run_debug, log_debug, log_info, log_warning, log_error, log_critical
 
 
 """MODULE REGEX"""

rpa_suite/validate/__init__.py

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

rpa_suite/validate/mail_validator.py

@@ -1,3 +1,5 @@
+# /mail_validator.py
+
 import email_validator
 from rpa_suite.log.printer import error_print, success_print
 

rpa_suite/validate/string_validator.py

@@ -1,3 +1,5 @@
+# /string_validator.py
+
 from rpa_suite.log.printer import success_print, error_print
 
 def search_in(

{rpa_suite-1.0.1.dist-info → rpa_suite-1.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa-suite
-Version: 1.0.1
+Version: 1.0.3
 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
@@ -127,31 +127,36 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+
+[!IMPORTANT]
+No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow' e 'pyscreeze' instalados, geralmente a instalação de pyautogui já instala as demais dependencias deste caso.
   
 ## 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
 - **rpa_suite**
     - **clock**
-        - **waiter** - Funções para aguardar em relação a execução de uma função, podendo ser antes ou depois
-        - **exec_at** - Funções para executar em momentos pré determinados
+        - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
+        - **exec_at** - Função capaz de executar a função do argumento no horario especificado "xx:yy" parecido com scheduler, porem com a vantagem de ter o horario como variavel dentro do escopo de código podendo gerar variações pela propria natureza da aplicação
     - **date**
-        - **date** - Funções para capturar data, mês, ano, hora, minutos de forma individual em apenas uma linha
+        - **date** - Funções capazes de extrair dia/mes/ano e hora/min/seg, facilitando a necessidade de formatar o resultado de datetime, a função ja devolve os valores em trio formatados em string
     - **email**
-        - **sender_smtp** - Funções para envio de email SMPT 
+        - **sender_smtp** - Funções para envio de email SMPT com configuração simples já default porem personalizavel
     - **file**
         - **counter** - Funções para contagem de arquivos
         - **temp_dir** - Funções para diretórios temporários
+        -**screen_shot** -  Função para criar diretório e arquivo de print com nome do diretório, arquivo e delay personalizáveis.
     - **log**
-        - **logger** - Objeto de log, cria diretório/arquivo de log integrado aos prints
-        - **printer** - Funções print personalizados (alerta, erro, sucesso, informativo)
+        - **logger_uru** - Instanciador de stream e handlefile que cria na pasta raiz do arquivo chamador pasta de log e seta o stream para as funções de log
+        - **functions_logger_uru** - Funções de log parecida com os prints personalizados, setadas e personalizadas para todos log levels usado pelo ´logger_uru´, já escreve no arquivo setado além de gerar o print no terminal
+        - **printer** - Funções de print personalizados (alerta, erro, sucesso, informativo)
     - **regex**
-        - **list_from_text** - Funções para gerar listas, dividindo texto usando padrão regex
+        - **list_from_text** - Funções para gerar listas, dividindo texto usando padrão regex (necessita de melhorias)
     - **validate**
-        - **mail_validator** - Funções para validação de emails
-        - **string_validator** - Funções para validação/varredura (strings, substrings, palavras)
+        - **mail_validator** - Função para validar lista de emails, devolvendo a lista com emails validos a partir da lista original 
+        - **string_validator** - Função que valida presença de letras, palavras, e texto em strings
 
 ## Release
-Versão: **Beta 1.0.1**
+Versão: **Beta 1.0.3**
 
 Lançamento: *20/02/2024*
 

rpa_suite-1.0.3.dist-info/RECORD

@@ -0,0 +1,34 @@
+rpa_suite/__init__.py,sha256=2k_ZeqU7FvqZMFqGm-EYRiV98uxUxmiy5wXygvIobPU,13
+rpa_suite/suite.py,sha256=D5VUJbG3fPCXtQjGA0z6Ll9znr4-YPzZWHbpGNpZ-nU,5246
+rpa_suite/clock/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/clock/exec_at.py,sha256=APgjuY5ORzITqtyGscdrhuYxYgJ0iAx4zqQxsdNBZoQ,5826
+rpa_suite/clock/scheduler.py,sha256=_EeERPcdVakgp4WoAWbQvLUeLUtZeWiONuU--EszKvI,1197
+rpa_suite/clock/waiter.py,sha256=puvi1tNIG5v50tVaGckxjWjbTcnDQkpuxIZykRCi6s4,5916
+rpa_suite/date/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/date/date.py,sha256=fYCEdOcv9mU41xI0AUzMVzABPzhEjMQ4ZBCE_mBPQws,4316
+rpa_suite/email/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/email/sender_smtp.py,sha256=e6DgITLLB1Acx1yQbHBargHT3UGxLDpTdHkQ0w8EgaM,7598
+rpa_suite/file/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/file/counter.py,sha256=vFaqENBC6HLv7dHmEmibsHhLVfumTM6Dh7p-u2g6s5Y,2483
+rpa_suite/file/screen_shot.py,sha256=3SFKSS1Kb9UlKY3Lt6cE9Bym7i44iu7XeMqzZ2d4dhc,3282
+rpa_suite/file/temp_dir.py,sha256=NnoLbpgCm9ZoC2D2mzywo756d8BBt_1fhQeNUUnxsPs,7134
+rpa_suite/log/__create_log_dir.py,sha256=Lm3qbIhJ0z4zBkRIdR5AFw8voBRaAGuEwr8G-6cSPGg,3318
+rpa_suite/log/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/log/_functions_logger.py,sha256=kIpJEyk-Rpg2oMo0Jjchjbh06N9PMx33GkYt6IlTTvA,2696
+rpa_suite/log/_logger.py,sha256=nuHCvu8uUbr_xIJDn5BVJowXBaG-UNnYlbuPO3P9FSw,3636
+rpa_suite/log/_variables.py,sha256=vCcktifFUriBQTyUaayZW8BlE8Gr7VP-tFbfomKOS5U,312
+rpa_suite/log/_variables_uru.py,sha256=xRqYp49l1fFNrHczOmJ6Pqw1PKIWs0f9kxlgvuYGYys,303
+rpa_suite/log/functions_logger_uru.py,sha256=Drnmpz08or3ij2HLQsrYgvWa-zxk66HFI00GxhmDGQY,6154
+rpa_suite/log/log_decorator.py,sha256=cSN-WINpdbtvH_bDNurpkbMLjQlDPJKdwou6T8JHo3g,1338
+rpa_suite/log/logger_uru.py,sha256=HwMHqJs9wKDfGqSny0smwOQK3wq1xLTd3x-nCGQ0IZo,3665
+rpa_suite/log/printer.py,sha256=Ue-OW5w6QB9zjUDd4Y62jmfgcN6ibPM_smuY2kutr6U,3965
+rpa_suite/regex/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/regex/list_from_text.py,sha256=HJaV_nhjCjn8UkJgEsnnKO2hYuE-zVDCAH9MD6XocGw,2226
+rpa_suite/validate/__init__.py,sha256=haPk94yjX88kR5YpzNNFCpzHw0T7fKAEoiaHA3-vAds,14
+rpa_suite/validate/mail_validator.py,sha256=dtFdthDd3gHyJ0uEUT9yPFFP1yyq4TXLxKLV1gqcNMo,2930
+rpa_suite/validate/string_validator.py,sha256=8dGAHhvZu19yIVOoX-te1pVqVi7cwDrFJKf107cLgvA,5370
+rpa_suite-1.0.3.dist-info/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.0.3.dist-info/METADATA,sha256=CpzZ1QqgR998I_tGfzPZSGwMUjJkMK1GLNRG0cuRC7k,7729
+rpa_suite-1.0.3.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+rpa_suite-1.0.3.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.0.3.dist-info/RECORD,,

rpa_suite-1.0.1.dist-info/RECORD

@@ -1,33 +0,0 @@
-rpa_suite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/suite.py,sha256=d0AyTyVBtORSFn08tot4WY2x9GUnuYPaaYVOqjNcMBE,3709
-rpa_suite/clock/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/clock/exec_at.py,sha256=AIwgot-zhAgLVSuBOEIIirH4hGoF2yGPOHsMXKZLeDQ,5809
-rpa_suite/clock/scheduler.py,sha256=N3JMu_nDB2xyWxTL4EGsA-_u0r1nUmwC9SnJTz0Frns,1178
-rpa_suite/clock/waiter.py,sha256=hczvBR9f63ofR8FZbWO-p96yJgu-df8fm_bpfmliMZc,5900
-rpa_suite/date/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/date/date.py,sha256=FXdth3CLvg57T8dZApLEftJhfi2KrOev0dOvI-xVkmc,4302
-rpa_suite/email/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/email/sender_smtp.py,sha256=8v-IH2Z_tS0fwo-JW_ichoyX54-ekBkCRuCEyjWdFTs,7577
-rpa_suite/file/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/file/counter.py,sha256=DDxeMaXI1pp31-divf30BEJ3QcLnA9ucKE-D0ZpsmFU,2466
-rpa_suite/file/temp_dir.py,sha256=F2ZDFLpqHO1BTtJURkiuexQNaO-pngJkk6cvTmp0JSk,7116
-rpa_suite/log/__create_log_dir.py,sha256=5pxX7j3vWYQ0Dn2_04UWnfUJvvbzd78DgOpH2IaBFYM,3293
-rpa_suite/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/log/_variables.py,sha256=rt8W9-yDgoonAu93yuPZgPy-rtnJcq4NwzB7EL0TRX4,292
-rpa_suite/log/_variables_uru.py,sha256=fe2IKhyZzroHO5WIIm_VCKwcdr8lfobOr-VctgpdQhc,279
-rpa_suite/log/functions_logger.py,sha256=A6z_f6pKClz_PYl3YEM-9px1KShNox5etU3umPqqvyg,2668
-rpa_suite/log/functions_logger_uru.py,sha256=GvXeAnsevLLVJCO2rhXr81ngmYl6xHfMsnEEin4Viu8,6124
-rpa_suite/log/log_decorator.py,sha256=K5RhUITcPIHQmnuCZjEYYUbYyK1-WaB7EwZe2V3ugCE,1315
-rpa_suite/log/logger.py,sha256=JD4mBdfWA_XE5Qq5JMLBf_LLWWonVKNZo-F-GqrRm04,3619
-rpa_suite/log/logger_uru.py,sha256=HwMHqJs9wKDfGqSny0smwOQK3wq1xLTd3x-nCGQ0IZo,3665
-rpa_suite/log/printer.py,sha256=sykxCpOyiMe539iXuRq-yN6HpKi1xxWiP7mZ1s8mF6k,3948
-rpa_suite/regex/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/regex/list_from_text.py,sha256=gGTNJdnmD1kwJ6oQOMwcEFFKb_U5i4rV-bSCHC-LlKQ,2202
-rpa_suite/validate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rpa_suite/validate/mail_validator.py,sha256=PEa_-bON7BYnpaz-p5aEZkpza7qsoBBFKv6GwsjdjCU,2906
-rpa_suite/validate/string_validator.py,sha256=7eJVTCmzVwgM513NqAAjqvo9iqHmsWQ-6LQ8-oOh_0s,5344
-rpa_suite-1.0.1.dist-info/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.0.1.dist-info/METADATA,sha256=pvVGsAISURiGv805OPLQKushyBWds5s3w9zl0fUCo5E,6604
-rpa_suite-1.0.1.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-rpa_suite-1.0.1.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.0.1.dist-info/RECORD,,