rpa-suite 1.4.1__tar.gz → 1.4.5__tar.gz

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.4.1
+Version: 1.4.5
 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
@@ -145,6 +145,14 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+- pillow
+- pyautogui
+- typing
+
+  opcionalmente para automação de navegador:
+
+  - selenium
+  - webdriver_manager
 
 [!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 dependências deste caso.
@@ -153,6 +161,8 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 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
 
+! Divisao e nomes de funções precisam ser atualizadas nesta sessão de Estrutura do módulo !
+
 - **rpa_suite**
   - **clock**
     - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
@@ -178,26 +188,26 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release
 
-Versão: **Beta 1.3.4**
+Versão: **Beta 1.4.5**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/11/2024*
+Última atualização: *10/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.1
-
-- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
-- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
-- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
-- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
-- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
-- Funções de regex e busca em textos por strings e palavras atualizadas
-- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
-- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
-- ajuste de cores no svg da logo rpa-suite
+### Notas da atualização: 1.4.5
+
+- Mudança dos submodulos para Objetos, agora Rpa_suite é um Objeto de Suite que compoe diversos sub-objetos separados pelas mesmas categorias anteriormente ja definidas
+- Reformulada a arquitetura do projeto para melhor coeção e menos subpastas e arquivos, agora a estrutura é mais simples e de melhor manutenção contendo apenas uma pasta core para o nucleo de nossos modulos, e uma pasta utils com ferramentas utilitarias que vamos adicionar varias novidades
+- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
+- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
+- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
+- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
+- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
+- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
+- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
+- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
 
 ## Mais Sobre
 

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/README.md

@@ -107,6 +107,14 @@ No setup do nosso projeto já estão inclusas as dependências, só será necess
 - loguru
 - email-validator
 - colorlog
+- pillow
+- pyautogui
+- typing
+
+  opcionalmente para automação de navegador:
+
+  - selenium
+  - webdriver_manager
 
 [!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 dependências deste caso.
@@ -115,6 +123,8 @@ No caso da função de screenshot é necessario ter as libs 'pyautogui' 'pillow'
 
 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
 
+! Divisao e nomes de funções precisam ser atualizadas nesta sessão de Estrutura do módulo !
+
 - **rpa_suite**
   - **clock**
     - **waiter** - Função capaz de aguardar para executar a função do argumento, ou executar a função do argumento para aguardar posteriormente
@@ -140,26 +150,26 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
 
 ## Release
 
-Versão: **Beta 1.3.4**
+Versão: **Beta 1.4.5**
 
 Lançamento: *20/02/2024*
 
-Última atualização: *10/11/2024*
+Última atualização: *10/04/2025*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.4.1
-
-- Correções de bugs em diversas funções relacionadas a tempo: *exec_at_hour* , *wait_for_exec* , *exec_and_wait*
-- Correções de bugs com tempo superior a 10 minutos nas funções de data: *get_hms* e *get_dma*
-- Função **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
-- Função *send_email* atualizada para suportar autenticação *SSL* ou *TLS* via argumentos recebidos nos parametros
-- Adicionado parametro de *"display_message"* para o usuario poder ativar ou desativar as mensagens de console em cada função
-- Correção de bug na função *"count_files"* para realizar de maneira correta a soma de todos arquivos nos diretórios
-- Funções de regex e busca em textos por strings e palavras atualizadas
-- Implementado nova função para arquivo de flag para execuções, no submodulo file, as funções são: *"file_flag_create"* e *"file_flag_delete"*
-- correção de imports no arquivo suite.py das funções *"get_dmy"* e *"search_str_in"*
-- ajuste de cores no svg da logo rpa-suite
+### Notas da atualização: 1.4.5
+
+- Mudança dos submodulos para Objetos, agora Rpa_suite é um Objeto de Suite que compoe diversos sub-objetos separados pelas mesmas categorias anteriormente ja definidas
+- Reformulada a arquitetura do projeto para melhor coeção e menos subpastas e arquivos, agora a estrutura é mais simples e de melhor manutenção contendo apenas uma pasta core para o nucleo de nossos modulos, e uma pasta utils com ferramentas utilitarias que vamos adicionar varias novidades
+- Adicionado setor utils com funcionalidade de tornar o diretorio atual em um importavel relativo para o python
+- Adicionado Automação de Navegadores! Sim estamos devendo esta feature a bastante tempo, porem estamos com a primeira versão disponivel, em breve teremos mais recursos e disponibilidade para outros navegadores, atualmente suporte apenas para *Chrome.*
+- Mantemos o alerta! **get_dma** atualizada e **renomeada** para **get_dmy** para manter o padrão em ingles
+- Função *send_email* atualizada para simplificar seu uso e funcionalidade em uma maior variedade de maquinas
+- Melhoria nas descrições das funções e adicionado docstring (documentação explicativa) de todos Objetos e respectivas funções
+- Sub-modulos agora como são Objetos internos do Objeto principal Suite pode ser acessado de duas formas, ex1: " from rpa_suite import rpa ; rpa.modulo.function() " ou então ex2: "from rpa_suite.core.Submodulo import NomeModulo ; meu_obj = NomeModulo() ; meu_obj.function()",
+- Funções de regex e busca em textos foi simplificada e em breve estaremos adicionando funcionalidades mais interessantes.
+- Correção e melhoria do Submodulo de Log. Tinhamos dois formatos de Log com duas bibliotecas e decidimos optar apenas pela Loguru para podermos dedicar mais atenção e fornecer recursos de Log mais completos, agora possui funcionalidade para indicar o caminho da pasta, nome da pasta, e também nome do arquivo, realizando stream tanto para o console (terminal) como também para o arquivo com todos levels já configurados e personalizados para ter distinção e facilitar o reconhecimento visual do que esta acontecendo no seu projeto.
 
 ## Mais Sobre
 

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/rpa_suite/__init__.py

@@ -26,6 +26,7 @@
         ``printer``: Functions for formatted output
         ``regex``: Operations with regular expressions
         ``validate``: Data validation functions
+        ``Browser``: Object Browser automation functions
 
     pt-br
     -----
@@ -55,5 +56,8 @@
         ``printer``: Funções para output formatado
         ``regex``: Operações com expressões regulares
         ``validate``: Funções de validação de dados
+        ``Browser``: Objeto de Automação de Navegadores
 """
-from .suite import Suite as rpa
+
+from .suite import rpa
+rpa

rpa_suite-1.4.5/rpa_suite/core/__init__.py

@@ -0,0 +1,28 @@
+# rpa_suite/core/__init__.py
+
+"""
+The Core module is where we can import all Sub-Objects used by the rpa_suite module separately, categorized by their respective classes based on functionality. However, we can also use them through the main rpa object using the following syntax:
+>>> from rpa_suite import rpa
+>>> rpa.clock.wait_for_exec()
+>>> rpa.file.screen_shot() ...
+among others.
+
+pt-br
+----------
+O módulo Core é de onde podemos importar todos os Sub-Objetos usados pelo módulo rpa_suite de forma separada, categorizados por suas respectivas classes com base na funcionalidade. No entanto, também podemos usá-los através do objeto principal rpa usando a seguinte sintaxe:
+>>> from rpa_suite import rpa
+>>> rpa.clock.wait_for_exec()
+>>> rpa.file.screen_shot() ...
+entre outros.
+
+"""
+from .clock import Clock
+from .date import Date
+from .dir import Directory
+from .email import Email
+from .file import File
+from .log import Log
+from .print import Print
+from .regex import Regex
+from .validate import Validate
+from .browser import Browser

rpa_suite-1.4.5/rpa_suite/core/browser.py

@@ -0,0 +1,166 @@
+# default import
+import os, requests
+
+# imports
+from rpa_suite.functions._printer import error_print, alert_print, success_print
+
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from webdriver_manager.chrome import ChromeDriverManager
+from time import sleep
+
+class Browser():
+
+    """
+    WIP ...
+    """
+
+    driver: None
+    port: int = None
+    path_driver = None
+    
+    def __init__(self, port: int = 9393, close_all_chrome_on_this_port: bool = True):
+        self.port = port
+        self.path_driver = ChromeDriverManager().install()
+
+        if close_all_chrome_on_this_port: self._close_all_chrome()
+        ...
+
+    def configure_browser(self) -> None:
+        
+        try:
+            # Use the absolute path from comment
+            
+            options = Options()
+            options.add_experimental_option("debuggerAddress",
+                                         f"127.0.0.1:{str(self.port)}")
+            
+            # Additional configs  
+            options.add_argument("--start-maximized")
+            options.add_argument("--disable-notifications")
+            
+            # Verifica se o caminho do driver está correto
+            if not os.path.exists(self.path_driver):
+                raise FileNotFoundError(f'O caminho do driver não foi encontrado: {self.path_driver}')
+            
+            # Create driver with options and chromedriver path
+            self.driver = webdriver.Chrome(
+                #service=self.path_driver,
+                options=options,
+                keep_alive=True
+            )
+
+        except Exception as e:
+            error_print(f'Erro durante a função: {self.configure_browser.__name__}! Error: {str(e)}.')
+
+    def start_browser(self, close_chrome_on_this_port: bool = True, display_message: bool = False):
+        
+        try:
+            if close_chrome_on_this_port: self.close_browser()
+
+            # Inicia o Chrome com debugging port
+            os.system(f'start chrome.exe --remote-debugging-port={str(self.port)} --user-data-dir="C:/temp/chrome_profile"')
+
+            # Aguardar até que o Chrome esteja realmente aberto
+            while True:
+                try:
+                    # Tenta conectar ao Chrome na porta de depuração
+                    response = requests.get(f'http://127.0.0.1:{self.port}/json')
+                    if response.status_code == 200:
+                        break  # O Chrome está aberto
+                except requests.ConnectionError:
+                    sleep(1)  # Espera um segundo antes de tentar novamente
+            
+            # Inicializa o Chrome com as opções
+            self.configure_browser()
+            
+            if display_message: success_print(f'Browser: Iniciado com sucesso!')
+            
+        except Exception as e:
+            error_print(f'Erro ao iniciar navegador: {str(e)}.')
+
+
+    def find_ele(self, value, by=By.XPATH, timeout=12, display_message=True):
+        
+        try:
+            sleep(2)
+            element = WebDriverWait(self.driver, timeout).until(
+                EC.presence_of_element_located((by, value))
+            ); return element
+        
+        except Exception as e:
+
+            if display_message:
+                error_print(f'Erro durante a função: {self.find_ele.__name__}! Error: {str(e)}.')
+                return None
+            else: return None
+
+    # find elements (needs implementation)
+    ...
+    
+    # navigate
+    def get(self, url: str, display_message: bool = False):
+        
+        try:
+            self.driver.get(url)
+            if display_message: success_print(f'Browser: Navegando para: {url}')
+            
+        except Exception as e:
+            error_print(f'Erro ao navegar para a URL: {url}. Error: {str(e)}.')
+
+
+    def _close_all_chrome(self):
+
+        try:
+            os.system('taskkill /F /IM chrome.exe >nul 2>&1')
+        except:
+            pass
+
+
+    def close_browser(self, display_message: bool = False):
+        
+        try:
+            # Primeiro tenta fechar todas as janelas via Selenium
+            try:
+                self.driver.close()
+            except:
+                pass
+                
+            # Depois tenta encerrar a sessão
+            try:
+                self.driver.quit()
+            except:
+                pass
+            
+            # Aguarda um momento para o processo ser liberado
+            sleep(1)
+            
+            # Força o fechamento do processo específico do Chrome
+            os.system(f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" >nul 2>&1')
+            
+            # Verifica se o processo foi realmente terminado
+            check = os.system(f'tasklist /fi "imagename eq chrome.exe" /fi "commandline like *--remote-debugging-port={str(self.port)}*" >nul 2>&1')
+            
+            if check == 0:
+                # Processo ainda existe, tenta método mais agressivo
+                os.system(f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1')
+                if display_message: alert_print(f'Browser: Fechado via força!')
+                
+            else:
+                if display_message: success_print(f'Browser: Fechado com sucesso!')
+            
+        except Exception as e:
+            
+            
+            try:
+                if display_message: alert_print(f'Erro ao fechar navegador: {str(e)}, Tentando meio mais forte!')
+
+                # Último recurso - mata todos os processos do Chrome (use com cautela)
+                os.system(f'taskkill /f /im chrome.exe /fi "commandline like *--remote-debugging-port={str(self.port)}*" /t >nul 2>&1')
+                if display_message: alert_print(f'Browser: Fechado via força extrema!')
+                
+            except Exception as error_ultimate:
+                if display_message: error_print(f'Falha crítica ao tentar fechar o navegador! Error: {str(error_ultimate)}!')

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/rpa_suite/core/clock.py

@@ -7,6 +7,7 @@ from typing import Callable, Any
 
 
 class Clock():
+    
     """
     Class that provides utilities for time manipulation and stopwatch.
     
@@ -38,11 +39,12 @@ class Clock():
         >>> from rpa_suite import rpa
         >>> rpa.clock.exec_at_hour("14:30", minha_funcao)
     """
+
     def __init__(self):
         ...
-    
+        
     def exec_at_hour(self,
-                hour_to_exec: str,
+                hour_to_exec: str | None,
                 fn_to_exec: Callable[..., Any],
                 *args,
                 **kwargs,
@@ -190,7 +192,8 @@ class Clock():
         >>> wait_for_exec(30, sum, 10, 5) -> 15 \n
             * NOTE:  `wait_for_exec` receives as first argument the time to wait (sec), then the function `sum` and finally the arguments that the function will use.
             
-        Description: pt-br
+        
+        pt-br
         ----------    
         Função temporizadora, aguardar um valor em ``segundos`` para executar a função do argumento.
         
@@ -257,8 +260,9 @@ class Clock():
         We have a sum function in the following format ``sum(a, b) -> return x``, where ``x`` is the result of the sum. We want to execute the sum and then wait `30 seconds` to continue the main code:
         >>> wait_for_exec(30, sum, 10, 5) -> 15 \n
             * NOTE:  `wait_for_exec` receives as first argument the time to wait (sec), then the function `sum` and finally the arguments that the function will use.
-            
-        Description: pt-br
+        
+        
+        pt-br
         ----------
         Função temporizadora, executa uma função e aguarda o tempo em ``segundos``
         

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/rpa_suite/core/email.py

@@ -99,28 +99,54 @@ class Email():
         ):
 
         """
-        Envia um e-mail utilizando o servidor SMTP especificado.
+        Sends an email using the specified SMTP server.
 
         Args:
-            smtp_server (str, optional): Endereço do servidor SMTP. 
+            smtp_server (str, optional): Address of the SMTP server. 
+                Default: "smtp.hostinger.com".
+            smtp_port (str, optional): Port of the SMTP server. 
+                Default: 465.
+            email_user (str, optional): User (email) for authentication on the SMTP server. 
+                Default: "example@email.com".
+            email_password (str, optional): Password for authentication on the SMTP server. 
+                Default: "example123".
+            email_to (str, optional): Email address of the recipient. 
+                Default: "person@email.com".
+            attachments (list[str], optional): List of file paths to attach to the email. 
+                Default: [].
+            subject_title (str, optional): Title (subject) of the email. 
+                Default: 'test title'.
+            body_message (str, optional): Body of the email message, in HTML format. 
+                Default: '<p>test message</p>'.
+
+        Returns:
+            None: This function does not explicitly return any value, but prints success or failure messages when sending the email.
+        
+        pt-br
+        ------
+        
+        Envia um email usando o servidor SMTP especificado.
+
+        Args:
+            smtp_server (str, opcional): Endereço do servidor SMTP. 
                 Padrão: "smtp.hostinger.com".
-            smtp_port (str, optional): Porta do servidor SMTP. 
+            smtp_port (str, opcional): Porta do servidor SMTP. 
                 Padrão: 465.
-            email_user (str, optional): Usuário (e-mail) para autenticação no servidor SMTP. 
-                Padrão: "bot@vettracode.com".
-            email_password (str, optional): Senha para autenticação no servidor SMTP. 
-                Padrão: "Bot@#2025".
-            email_to (str, optional): Endereço de e-mail do destinatário. 
-                Padrão: "camilo.costa1993@gmail.com".
-            attachments (list[str], optional): Lista de caminhos de arquivos para anexar ao e-mail. 
+            email_user (str, opcional): Usuário (email) para autenticação no servidor SMTP. 
+                Padrão: "example@email.com".
+            email_password (str, opcional): Senha para autenticação no servidor SMTP. 
+                Padrão: "example123".
+            email_to (str, opcional): Endereço de email do destinatário. 
+                Padrão: "person@email.com".
+            attachments (list[str], opcional): Lista de caminhos de arquivos para anexar ao email. 
                 Padrão: [].
-            subject_title (str, optional): Título (assunto) do e-mail. 
-                Padrão: 'titulo teste'.
-            body_message (str, optional): Corpo da mensagem do e-mail, em formato HTML. 
+            subject_title (str, opcional): Título (assunto) do email. 
+                Padrão: 'título de teste'.
+            body_message (str, opcional): Corpo da mensagem do email, em formato HTML. 
                 Padrão: '<p>mensagem de teste</p>'.
 
         Returns:
-            None: Esta função não retorna nenhum valor explicitamente, mas imprime mensagens de sucesso ou falha no envio do e-mail.
+            Nenhum: Esta função não retorna explicitamente nenhum valor, mas imprime mensagens de sucesso ou falha ao enviar o email.
         """
 
         try:

{rpa_suite-1.4.1 → rpa_suite-1.4.5}/rpa_suite/core/file.py

@@ -7,54 +7,55 @@ from typing import Dict, List, Union
 
 class File():
     """
-    Class that provides utilities for file management, including creating, deleting, and manipulating files.
+    Class that provides utilities for file management, including creation, deletion, and manipulation of files.
 
     This class offers functionalities for:
-        - Creating files
-        - Deleting files
-        - Reading and writing file content
-        - File path management
+        - Creating and deleting flag files
+        - Counting files in a directory
+        - Capturing screenshots and managing their paths
 
     Methods:
-        create_file: Creates a new file with specified content
-        delete_file: Deletes a specified file
-        read_file: Reads content from a specified file
-        write_file: Writes content to a specified file
+        screen_shot: Creates a screenshot and saves it in a specified directory
+        count_files: Counts the number of files in a specified directory
+        flag_create: Creates a flag file
+        flag_delete: Deletes a flag file
 
-    The File class is part of RPA Suite and can be accessed through the rpa object:
+    The File class is part of the RPA Suite and can be accessed through the rpa object:
         >>> from rpa_suite import rpa
-        >>> rpa.file.create_file('example.txt', 'Hello, World!')
+        >>> rpa.file.screen_shot('example')
 
     Parameters:
-        file_name (str): The name of the file to be created or manipulated
-        content (str): The content to be written to the file
-        path (str): The directory path where the file should be created or deleted
+        file_name (str): The name of the screenshot file
+        path_dir (str): The path of the directory where the screenshot should be saved
+        save_with_date (bool): Indicates if the file name should include the date
+        delay (int): The wait time before capturing the screen
 
     pt-br
     ----------
     Classe que fornece utilitários para gerenciamento de arquivos, incluindo criação, exclusão e manipulação de arquivos.
 
     Esta classe oferece funcionalidades para:
-        - Criar arquivos
-        - Excluir arquivos
-        - Ler e escrever conteúdo de arquivos
-        - Gerenciamento de caminhos de arquivos
+        - Criar e excluir arquivos de flag
+        - Contar arquivos em um diretório
+        - Capturar screenshots e gerenciar seus caminhos
 
     Métodos:
-        create_file: Cria um novo arquivo com o conteúdo especificado
-        delete_file: Exclui um arquivo especificado
-        read_file: Lê o conteúdo de um arquivo especificado
-        write_file: Escreve conteúdo em um arquivo especificado
+        screen_shot: Cria uma captura de tela e a salva em um diretório especificado
+        count_files: Conta o número de arquivos em um diretório especificado
+        flag_create: Cria um arquivo de flag
+        flag_delete: Exclui um arquivo de flag
 
     A classe File é parte do RPA Suite e pode ser acessada através do objeto rpa:
         >>> from rpa_suite import rpa
-        >>> rpa.file.create_file('exemplo.txt', 'Olá, Mundo!')
+        >>> rpa.file.screen_shot('exemplo')
 
     Parâmetros:
-        file_name (str): O nome do arquivo a ser criado ou manipulado
-        content (str): O conteúdo a ser escrito no arquivo
-        path (str): O caminho do diretório onde o arquivo deve ser criado ou excluído
+        file_name (str): O nome do arquivo de captura de tela
+        path_dir (str): O caminho do diretório onde a captura de tela deve ser salva
+        save_with_date (bool): Indica se o nome do arquivo deve incluir a data
+        delay (int): O tempo de espera antes de capturar a tela
     """
+    
     def __init__(self):
         self.__create_ss_dir = create_ss_dir
 
@@ -64,7 +65,7 @@ class File():
                     save_with_date: bool = True,
                     delay: int = 1, 
                     use_default_path_and_name: bool = True,
-                    name_ss_dir:str = None,
+                    name_ss_dir:str | None = None,
                     display_message: bool = False) -> str | None:
 
         """
@@ -72,10 +73,13 @@ class File():
 
         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`.
+        ``path_dir: str`` - should be a string, not have a default path.
         ``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).
+        ``use_default_path_and_name: bool`` - should be a boolean, by default `True`
+        ``name_ss_dir: str`` - should be a string, by default type `None`
+        ``display_message`` - should be a boolean, by default `False`
 
         Return:
         ----------
@@ -88,10 +92,13 @@ class File():
 
         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`.
+        ``file_path: str`` - deve ser uma string, não tem um caminho padrão.
         ``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).
+        ``use_default_path_and_name: bool`` - deve ser um booleano, por padrão `True`
+        ``name_ss_dir: str`` - deve ser uma string, por padrão do tipo `None`
+        ``display_message`` - deve ser um booleano, por padrão `False`
         
         Retorno:
         ----------
@@ -149,7 +156,7 @@ class File():
 
     def flag_create(self,
                     name_file: str = 'running.flag',
-                    path_to_create: str = None,
+                    path_to_create: str | None = None,
                     display_message: bool = True) -> None:
         """
         Cria um arquivo de sinalização indicando que o robô está em execução.
@@ -172,7 +179,7 @@ class File():
 
     def flag_delete(self,
                     name_file: str = 'running.flag',
-                    path_to_delete: str = None,
+                    path_to_delete: str | None = None,
                     display_message: bool = True,) -> None:
         
         """
@@ -241,7 +248,7 @@ class File():
         # Process
         try:
             for dir in dir_to_count:
-                for current_dir, sub_dir, files in os.walk(dir):
+                for _, _, files in os.walk(dir):
                     for file in files:
                         if type_extension == '*' or file.endswith(f'.{type_extension}'):
                             result['qt'] += 1