rpa-suite 1.0.2__tar.gz → 1.1.2__tar.gz

{rpa_suite-1.0.2 → rpa_suite-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa_suite
-Version: 1.0.2
+Version: 1.1.2
 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,6 +127,9 @@ 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
@@ -141,6 +144,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
     - **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_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
@@ -152,7 +156,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Função que valida presença de letras, palavras, e texto em strings
 
 ## Release
-Versão: **Beta 1.0.2**
+Versão: **Beta 1.1.2**
 
 Lançamento: *20/02/2024*
 

{rpa_suite-1.0.2 → rpa_suite-1.1.2}/README.md

@@ -102,6 +102,9 @@ 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
@@ -116,6 +119,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
     - **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_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
@@ -127,7 +131,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Função que valida presença de letras, palavras, e texto em strings
 
 ## Release
-Versão: **Beta 1.0.2**
+Versão: **Beta 1.1.2**
 
 Lançamento: *20/02/2024*
 

rpa_suite-1.1.2/rpa_suite/file/screen_shot.py

@@ -0,0 +1,81 @@
+# /screen_shot.py
+
+import os, time
+from datetime import datetime
+from rpa_suite.log.printer import error_print
+
+
+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)
+
+            except OSError as e:
+                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:
+
+        error_print(f'Erro durante a função {screen_shot.__name__}! Error: {str(e)}')
+        return None

{rpa_suite-1.0.2 → rpa_suite-1.1.2}/rpa_suite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa-suite
-Version: 1.0.2
+Version: 1.1.2
 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,6 +127,9 @@ 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
@@ -141,6 +144,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
     - **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_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
@@ -152,7 +156,7 @@ O módulo principal do rpa-suite é dividido em categorias. Cada categoria cont
         - **string_validator** - Função que valida presença de letras, palavras, e texto em strings
 
 ## Release
-Versão: **Beta 1.0.2**
+Versão: **Beta 1.1.2**
 
 Lançamento: *20/02/2024*
 

{rpa_suite-1.0.2 → rpa_suite-1.1.2}/rpa_suite.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ rpa_suite/email/__init__.py
 rpa_suite/email/sender_smtp.py
 rpa_suite/file/__init__.py
 rpa_suite/file/counter.py
+rpa_suite/file/screen_shot.py
 rpa_suite/file/temp_dir.py
 rpa_suite/log/__create_log_dir.py
 rpa_suite/log/__init__.py

{rpa_suite-1.0.2 → rpa_suite-1.1.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='1.0.2',
+    version='1.1.2',
     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',