rpa-suite 1.1.4__py3-none-any.whl → 1.1.6__py3-none-any.whl

rpa_suite/file/__create_ss_dir.py

@@ -0,0 +1,83 @@
+# /_create_ss_dir.py
+
+import os
+from typing import Union
+from rpa_suite.log.printer import error_print, alert_print, success_print
+
+
+def __create_ss_dir(path_to_create: str = 'default', name_ss_dir: str='screenshots') -> dict[str, Union[bool, str, None]]:
+
+    """
+    Function responsible for creating a screenshots directory to work with your screenshot files. \n
+
+    Parameters:
+    ----------
+    ``path_to_create: str`` - should be a string with the full path pointing to the folder where the screenshots 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_ss_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 screenshots para trabalhar com seus arquivos de sreenshot. \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_ss_dir: str`` - deve ser uma string representando o nome do diretório de screenshots a ser criado. Se estiver vazio, o valor ``screenshots`` 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_ss_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 screenshots directory! Error: {str(e)}')
+        
+    finally:
+        return result

rpa_suite/file/screen_shot.py

@@ -2,18 +2,13 @@
 
 import os, time
 from datetime import datetime
-from rpa_suite.log.printer import error_print
+from rpa_suite.log.printer import error_print, success_print
+from .__create_ss_dir import __create_ss_dir
 
 
-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:
+def screen_shot(path_dir:str = None, file_name: str = 'screenshot', save_with_date: bool = True, delay: int = 1, use_default_path_and_name: bool = True, name_ss_dir:str = None) -> 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
@@ -50,30 +45,41 @@ def screen_shot(file_path: str, file_name: str = 'screenshot', save_with_date: b
     # proccess
     try:
         
+        try:
+            import pyautogui
+            import pyscreeze
+            
+        except ImportError:
+            raise ImportError(" The ‘pyautogui’ e ‘Pillow’ libraries are necessary to use this module. Please install them with ‘pip install pyautogui pillow.")
+        
         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 not use_default_path_and_name:
+            result_tryed: dict = __create_ss_dir(path_dir, name_ss_dir)
+            path_dir = result_tryed['path_created']
+        else:
+            if path_dir == None and name_ss_dir == None:
+                result_tryed: dict = __create_ss_dir()
+                path_dir = result_tryed['path_created']
 
         
         if save_with_date: # use date on file name
             image = pyautogui.screenshot()
-            path_file_screenshoted =  fr'{file_path}/{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
-
+            file_name = f'{file_name}_{datetime.today().strftime("%d_%m_%Y-%H_%M_%S")}.png'
+            path_file_screenshoted = os.path.join(path_dir, file_name)
+            
+            success_print(path_file_screenshoted)
+            
             image.save(path_file_screenshoted)
-            return os.path.abspath(path_file_screenshoted)
+            return path_file_screenshoted
         
         else: # not use date on file name
             image = pyautogui.screenshot()
-            path_file_screenshoted =  fr'{file_path}/{file_name}.png'
-
+            file_name = f'{file_name}.png'
+            path_file_screenshoted = os.path.join(path_dir, file_name)
+            
             image.save(path_file_screenshoted)
-            return os.path.abspath(path_file_screenshoted)
+            return path_file_screenshoted
     
     except Exception as e:
 

rpa_suite/log/printer.py

@@ -33,7 +33,7 @@ def success_print(string_text: str, color=Colors.green, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -51,7 +51,7 @@ def alert_print(string_text: str, color=Colors.yellow, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -69,7 +69,7 @@ def info_print(string_text: str, color=Colors.cyan, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -87,7 +87,7 @@ def error_print(string_text: str, color=Colors.red, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -105,7 +105,7 @@ def magenta_print(string_text: str, color=Colors.magenta, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -123,7 +123,7 @@ def blue_print(string_text: str, color=Colors.blue, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -142,7 +142,7 @@ def print_call_fn(string_text: str, color=Colors.call_fn, ending="\n") -> None:
     ----------
         >>> type:None
     """
-    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:
@@ -161,4 +161,4 @@ def print_retur_fn(string_text: str, color=Colors.retur_fn, ending="\n") -> None
     ----------
         >>> type:None
     """
-    print(f'{color} {string_text} {Colors.default}', end=ending)
+    print(f'{color}{string_text}{Colors.default}', end=ending)

{rpa_suite-1.1.4.dist-info → rpa_suite-1.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rpa-suite
-Version: 1.1.4
+Version: 1.1.6
 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
@@ -156,9 +156,10 @@ 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.1.4**
+Versão: **Beta 1.1.6**
 
 Lançamento: *20/02/2024*
+Última atualização: *09/09/2024*
 
 Status: Em desenvolvimento.
 

{rpa_suite-1.1.4.dist-info → rpa_suite-1.1.6.dist-info}/RECORD

@@ -8,9 +8,10 @@ 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/__create_ss_dir.py,sha256=2u5-OgDoVo9orgOTrZ4YcVs1ZzxGKEJ695jC1bX00QE,3370
 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=CSvalWpVSP2aq_livBNjDpoEskIcPYklplpQHcfKpJI,3197
+rpa_suite/file/screen_shot.py,sha256=G8jzx0uuMgVMmYbz6MaPFJD5ePLCUTn_0Ub160DCSvk,3576
 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
@@ -21,14 +22,14 @@ rpa_suite/log/_variables_uru.py,sha256=xRqYp49l1fFNrHczOmJ6Pqw1PKIWs0f9kxlgvuYGY
 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/log/printer.py,sha256=r72zeobAi2baVbYgbfFH0h5-WMv4tSDGPNlcpZen7O0,3949
 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.1.4.dist-info/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
-rpa_suite-1.1.4.dist-info/METADATA,sha256=0nmfeHSOG1V9kIYlj9ZVrzfDtDvWN02hX30uswb89lE,7729
-rpa_suite-1.1.4.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-rpa_suite-1.1.4.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
-rpa_suite-1.1.4.dist-info/RECORD,,
+rpa_suite-1.1.6.dist-info/LICENSE,sha256=5D8PIbs31iGd9i1_MDNg4SzaQnp9sEIULALh2y3WyMI,1102
+rpa_suite-1.1.6.dist-info/METADATA,sha256=lP2LaADh4RHOVagf9m5mrHFMy1a_eF_Sh1igBwg1M7U,7766
+rpa_suite-1.1.6.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+rpa_suite-1.1.6.dist-info/top_level.txt,sha256=HYkDtg-kJNAr3F2XAIPyJ-QBbNhk7q6jrqsFt10lz4Y,10
+rpa_suite-1.1.6.dist-info/RECORD,,