rpa-suite 1.3.7__tar.gz → 1.4.0__tar.gz

{rpa_suite-1.3.7 → rpa_suite-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.3.7
+Version: 1.4.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
@@ -24,6 +24,7 @@ Requires-Dist: email_validator
 Requires-Dist: loguru
 Requires-Dist: typing
 Requires-Dist: pillow
+Requires-Dist: pyautogui
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -185,7 +186,7 @@ Lançamento: *20/02/2024*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.3.7
+### Notas da atualização: 1.4.0
 
 - 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*

{rpa_suite-1.3.7 → rpa_suite-1.4.0}/README.md

@@ -148,7 +148,7 @@ Lançamento: *20/02/2024*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.3.7
+### Notas da atualização: 1.4.0
 
 - 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*

rpa_suite-1.4.0/rpa_suite/core/email.py

@@ -0,0 +1,131 @@
+# /sender_smtp.py
+
+import smtplib, os
+from email.mime.image import MIMEImage
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+from email.mime.base import MIMEBase
+from email import encoders
+from rpa_suite.functions._printer import alert_print, error_print, success_print
+from rpa_suite.core.validate import email_validator
+
+
+class Email():
+    
+    smtp_server:str = "smtp.hostinger.com",
+    smtp_port:str = 465,
+    email_user:str = "your_email@email.com",
+    email_password:str = "password",
+    email_to: str = "to@email.com",
+    attachments: list[str] = [],
+    subject_title: str = 'Test title',
+    body_message: str = '<p>Testing message body</p>'
+    auth_tls: bool = False,
+
+    def __init__(self):
+        ...
+
+    def send_smtp(
+        self,
+        email_user:str,
+        email_password:str,
+        email_to: str,
+        subject_title: str = 'Test title',
+        body_message: str = '<p>Testing message body</p>',
+        attachments: list[str] = [],
+        smtp_server:str = "smtp.hostinger.com",
+        smtp_port:str = 465,
+        auth_tls: bool = False,
+        display_message: bool = True,
+        ):
+
+        """
+        Envia um e-mail utilizando o servidor SMTP especificado.
+
+        Args:
+            smtp_server (str, optional): Endereço do servidor SMTP. 
+                Padrão: "smtp.hostinger.com".
+            smtp_port (str, optional): 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. 
+                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. 
+                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.
+        """
+
+        try:
+            self.smtp_server = smtp_server
+            self.smtp_port = smtp_port
+            self.email_user = email_user
+            self.email_password = email_password
+            self.email_to = email_to
+            self.subject_title = subject_title
+            self.body_message = body_message
+            self.attachments = attachments
+            self.auth_tls = auth_tls
+
+            # Criando a mensagem
+            msg = MIMEMultipart()
+            msg['From'] = self.email_user
+            msg['To'] = ', '.join(self.email_to) if isinstance(self.email_to, list) else self.email_to
+            msg['Subject'] = str(self.subject_title)
+
+            # Corpo do e-mail
+            body = str(self.body_message)
+            msg.attach(MIMEText(body, 'html'))
+
+            # Anexos (opcional)
+            if self.attachments:
+                from email.mime.base import MIMEBase
+                from email import encoders
+                import os
+
+                for attachment_path in self.attachments:
+                    try:
+                        with open(attachment_path, "rb") as attachment:
+                            part = MIMEBase("application", "octet-stream")
+                            part.set_payload(attachment.read())
+                            encoders.encode_base64(part)
+                            part.add_header(
+                                "Content-Disposition",
+                                f"attachment; filename= {os.path.basename(attachment_path)}",
+                            )
+                            msg.attach(part)
+
+                    except Exception as e:
+                        error_print(f"Erro ao anexar o arquivo {attachment_path}: {str(e)}")
+
+            try:
+                if self.auth_tls:
+                    # Conectando ao servidor SMTP com TLS
+                    server = smtplib.SMTP(self.smtp_server, self.smtp_port)
+                    server.starttls()
+                    server.login(self.email_user, self.email_password)
+                else:
+                    # Conectando ao servidor SMTP com SSL
+                    server = smtplib.SMTP_SSL(self.smtp_server, self.smtp_port)
+                    server.login(self.email_user, self.email_password)
+
+                # Enviando o e-mail
+                server.sendmail(self.email_user, self.email_to, msg.as_string())
+                if display_message: success_print("E-mail enviado com sucesso!")
+
+                # Encerrando a conexão
+                server.quit()
+
+            except Exception as e:
+                alert_print(f"Falha ao enviar o e-mail: {str(e)}")
+
+        except Exception as e:
+            error_print(f"Ocorreu um erro geral na função sendmail: {str(e)}")

{rpa_suite-1.3.7 → rpa_suite-1.4.0}/rpa_suite.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa_suite
-Version: 1.3.7
+Version: 1.4.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
@@ -24,6 +24,7 @@ Requires-Dist: email_validator
 Requires-Dist: loguru
 Requires-Dist: typing
 Requires-Dist: pillow
+Requires-Dist: pyautogui
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -185,7 +186,7 @@ Lançamento: *20/02/2024*
 
 Status: Em desenvolvimento.
 
-### Notas da atualização: 1.3.7
+### Notas da atualização: 1.4.0
 
 - 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*

{rpa_suite-1.3.7 → rpa_suite-1.4.0}/rpa_suite.egg-info/requires.txt

@@ -4,3 +4,4 @@ email_validator
 loguru
 typing
 pillow
+pyautogui

{rpa_suite-1.3.7 → rpa_suite-1.4.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='rpa_suite',
-    version='1.3.7',
+    version='1.4.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',
@@ -23,5 +23,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, Bot, Robô, Ferramentas de automação',
-    install_requires=['colorama', 'colorlog', 'email_validator', 'loguru', 'typing', 'pillow'],
+    install_requires=['colorama', 'colorlog', 'email_validator', 'loguru', 'typing', 'pillow', 'pyautogui'],
 )

rpa_suite-1.3.7/rpa_suite/core/email.py

@@ -1,343 +0,0 @@
-# /sender_smtp.py
-
-import smtplib, os
-from email.mime.image import MIMEImage
-from email.mime.multipart import MIMEMultipart
-from email.mime.text import MIMEText
-from email.mime.base import MIMEBase
-from email import encoders
-from rpa_suite.functions._printer import alert_print, error_print, success_print
-from rpa_suite.core.validate import email_validator
-
-
-"""
-    smtp_server:str = "smtp.hostinger.com",
-    smtp_port:str = 465,
-    email_user:str = "bot@vettracode.com",
-    email_password:str = "Bot@#2025",
-    email_to: str = "camilo.costa1993@gmail.com",
-    attachments: list[str] = [],
-    subject_title: str = 'titulo teste',
-    body_message: str = '<p>mensagem de teste</p>'
-"""
-
-class Email():
-    
-    smtp_server:str = "smtp.hostinger.com",
-    smtp_port:str = 465,
-    email_user:str = "your_email@email.com",
-    email_password:str = "password",
-    email_to: str = "to@email.com",
-    attachments: list[str] = [],
-    subject_title: str = 'Test title',
-    body_message: str = '<p>Testing message body</p>'
-    auth_tls: bool = False,
-
-    def __init__(self):
-        ...
-
-    def send_smtp(
-        self,
-        email_user:str,
-        email_password:str,
-        email_to: str,
-        subject_title: str = 'Test title',
-        body_message: str = '<p>Testing message body</p>',
-        attachments: list[str] = [],
-        smtp_server:str = "smtp.hostinger.com",
-        smtp_port:str = 465,
-        auth_tls: bool = False,
-        display_message: bool = True,
-        ):
-
-        """
-        Envia um e-mail utilizando o servidor SMTP especificado.
-
-        Args:
-            smtp_server (str, optional): Endereço do servidor SMTP. 
-                Padrão: "smtp.hostinger.com".
-            smtp_port (str, optional): 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. 
-                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. 
-                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.
-        """
-
-        try:
-            self.smtp_server = smtp_server
-            self.smtp_port = smtp_port
-            self.email_user = email_user
-            self.email_password = email_password
-            self.email_to = email_to
-            self.subject_title = subject_title
-            self.body_message = body_message
-            self.attachments = attachments
-            self.auth_tls = auth_tls
-
-            # Criando a mensagem
-            msg = MIMEMultipart()
-            msg['From'] = self.email_user
-            msg['To'] = ', '.join(self.email_to) if isinstance(self.email_to, list) else self.email_to
-            msg['Subject'] = str(self.subject_title)
-
-            # Corpo do e-mail
-            body = str(self.body_message)
-            msg.attach(MIMEText(body, 'html'))
-
-            # Anexos (opcional)
-            if self.attachments:
-                from email.mime.base import MIMEBase
-                from email import encoders
-                import os
-
-                for attachment_path in self.attachments:
-                    try:
-                        with open(attachment_path, "rb") as attachment:
-                            part = MIMEBase("application", "octet-stream")
-                            part.set_payload(attachment.read())
-                            encoders.encode_base64(part)
-                            part.add_header(
-                                "Content-Disposition",
-                                f"attachment; filename= {os.path.basename(attachment_path)}",
-                            )
-                            msg.attach(part)
-
-                    except Exception as e:
-                        error_print(f"Erro ao anexar o arquivo {attachment_path}: {str(e)}")
-
-            try:
-                if self.auth_tls:
-                    # Conectando ao servidor SMTP com TLS
-                    server = smtplib.SMTP(self.smtp_server, self.smtp_port)
-                    server.starttls()
-                    server.login(self.email_user, self.email_password)
-                else:
-                    # Conectando ao servidor SMTP com SSL
-                    server = smtplib.SMTP_SSL(self.smtp_server, self.smtp_port)
-                    server.login(self.email_user, self.email_password)
-
-                # Enviando o e-mail
-                server.sendmail(self.email_user, self.email_to, msg.as_string())
-                if display_message: success_print("E-mail enviado com sucesso!")
-
-                # Encerrando a conexão
-                server.quit()
-
-            except Exception as e:
-                alert_print(f"Falha ao enviar o e-mail: {str(e)}")
-
-        except Exception as e:
-            error_print(f"Ocorreu um erro geral na função sendmail: {str(e)}")
-
-
-
-    def send_by_smtp( self,
-                    email_from: str,
-                    pass_from: str,
-                    email_to: list[str],
-                    subject_title: str,
-                    body_message: str,
-                    image_footer: str = None,
-                    attachments: list[str] = None,
-                    type_content: str = 'html',
-                    smtp_server: str = 'smtp.office365.com',
-                    smtp_port: int = 587,
-                    authentication_tls: bool = True, 
-                    display_message: bool = True,
-                    ) -> dict:
-
-        """
-        Function responsible for sending emails ``(SMTP)``, accepts ``list of recipients`` and possibility
-        of ``attaching files``. \n
-        
-        Parameters:
-        ----------
-        ``email_from: str`` - email from who will send the email.
-        ``pass_from: str`` - password of the account used, advised to isolate the password elsewhere.
-        ``email_to: list[str]`` - list of emails to which the emails will be sent.
-        ``subject_title: str`` - email title.
-        ``body_message: str``- body message of the email.
-        ``image_footer: str`` - image footer of body message of the email.
-        ``attachments: list[str]`` - list with path of attachments if any. (default None).
-        ``type_content: str`` - type of message content can be 'plain' or 'html' (default 'html').
-        ``smtp_server: str`` - server to be used to connect with the email account (default 'smtp.office365.com')
-        ``smtp_port: int`` - port to be used on this server (default 587 - TLS), commum use 465 for SSL authentication 
-        ``authentication_tls: bool`` - authentication method (default True), if False use SSL authentication
-        
-        Return:
-        ----------
-        >>> type:dict
-        a dictionary with all information that may be necessary about the emails.
-        Respectively being:
-            * 'success': bool -  if there was at least one successful shipment
-            * 'all_mails': list - list of all emails parameterized for sending
-            * 'valid_mails': list - list of all valid emails for sending
-            * 'invalid_mails': list - list of all invalid emails for sending
-            * 'qt_mails_sent': int - effective quantity that was sent
-            * 'attchament': bool - if there are attachments
-            * 'qt_attach': int - how many attachments were inserted
-            
-        Description: pt-br
-        ----------
-        Função responsavel por enviar emails ``(SMTP)``, aceita ``lista de destinatários`` e possibilidade
-        de ``anexar arquivos``. \n
-        
-        Parametros:
-        ----------
-        ``email_from: str`` - email de quem ira enviar o email.
-        ``pass_from: str`` - senha da conta utilizada, aconselhado isolar a senha em outro local.
-        ``email_to: list[str]`` - lista de emails para os quais serão enviados os emails.
-        ``subject_title: str`` - titulo do email.
-        ``body_message: str``- mensagem do corpo do email.
-        ``image_footer: str`` - imagem de rodapé do corpo do email.
-        ``attachments: list[str]`` - lista com caminho de anexos se houver. (default None).
-        ``type_content: str`` - tipo de conteudo da mensagem pode ser 'plain' ou 'html' (default 'html').
-        ``smtp_server: str`` - servidor a ser utilizado para conectar com a conta de email (default 'smtp.office365.com')
-        ``smtp_port: int`` - porta a ser utilizada nesse servidor (default 587 - TLS), comum usar 465 para autenticação por SSL 
-        ``authentication_tls: bool`` - metódo de autenticação (default True), caso Falso usa autenticação por SSL
-        
-        Retorno:
-        ----------
-        >>> type:dict
-        um dicionário com todas informações que podem ser necessarias sobre os emails.
-        Sendo respectivamente:
-            * 'success': bool -  se houve pelo menos um envio com sucesso
-            * 'all_mails': list - lista de todos emails parametrizados para envio
-            * 'valid_mails': list - lista de todos emails validos para envio
-            * 'invalid_mails': list - lista de todos emails invalidos para envio
-            * 'qt_mails_sent': int - quantidade efetiva que foi realizado envio
-            * 'attchament': bool - se há anexos
-            * 'qt_attach': int - quantos anexos foram inseridos
-        """
-
-        try:
-            # Local Variables
-            result: dict = {
-                'success': bool,
-                'all_mails': list,
-                'valid_mails': list,
-                'invalid_mails': list,
-                'qt_mails_sent': int,
-                'attchament': bool,
-                'qt_attach': int
-            }
-            email_valido = []
-            email_invalido = []
-            
-            # Preprocessing
-            result['success'] = False
-            result['qt_mails_sent'] = 0
-            result['attchament'] = False
-
-            msg = MIMEMultipart()
-            msg['From'] = email_from
-            msg['Subject'] = subject_title
-
-            # Email Body Content
-            msg.attach(MIMEText(body_message, type_content))
-            
-            # Add image Footer 
-            if image_footer:
-                try:
-                    with open(image_footer, 'rb') as img:
-                        msg_image = MIMEImage(img.read())
-                        msg_image.add_header('Content-ID', '<logo>')
-                        # Notice: Content-ID correlact at "cid" on tag <img> at body mail
-                        msg.attach(msg_image)
-                except FileNotFoundError as e:
-                    alert_print(f'File Not Found! Error: {str(e)}')
-                except Exception as e:
-                    error_print(f'An Error ocurred, during set image: <{image_footer}> as MIMEImage! Error: {str(e)}')
-                    
-            # 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)
-                    attachs = open(path_to_attach, 'rb')
-                    part = MIMEBase('application', 'octet-stream')
-                    part.set_payload((attachs).read())
-                    encoders.encode_base64(part)
-                    part.add_header('Content-Disposition', "attachment; filename= %s" % file_name)
-                    msg.attach(part)
-                    result['qt_attach'] += 1
-            else:
-                result['attchament'] = False
-                result['qt_attach'] = 0
-
-            # SMTP server config
-            try:
-                
-                # authentication TLS False -> Using SSL authentication
-                if authentication_tls:
-                    
-                    server_by_smtp = smtplib.SMTP(smtp_server, smtp_port)
-                    server_by_smtp.starttls()
-                    server_by_smtp.login(email_from, pass_from)
-                    email_content = msg.as_string()
-                    
-                else: # auth with SSL
-                    
-                    # Conexão com o servidor SMTP usando SSL
-                    server_by_smtp = smtplib.SMTP_SSL(smtp_server, smtp_port)
-                    server_by_smtp.login(email_from, pass_from)
-                    email_content = msg.as_string()
-                    
-                # Treats the email list before trying to send, keeping only valid emails
-                try:  
-                    for emails in email_to:
-                        try:
-                            v = email_validator.validate_email(emails)
-                            email_valido.append(emails)
-
-                        except email_validator.EmailNotValidError:
-                            email_invalido.append(emails)
-
-                except Exception as e:
-                    error_print(f'Error while trying to validate email list: {str(e)}')
-
-                # Attaches the treated email list to perform the sending
-                msg['To'] = ', '.join(email_valido)
-                for email in email_valido:
-                    try:
-                        server_by_smtp.sendmail(email_from, email, email_content)
-                        result['qt_mails_sent'] += 1
-                        result['all_mails'] = email_to
-
-                    except smtplib.SMTPException as e:
-                        error_print(f"The email: {email} don't sent, caused by error: {str(e)}")
-
-                #server_by_smtp.quit()
-                result['success'] = True
-                if display_message: success_print(f'Email(s) Sent!')
-
-
-            except smtplib.SMTPException as e:
-                result['success'] = False
-                error_print(f'Error while trying sent Email: {str(e)}')
-                
-            finally:
-                server_by_smtp.quit()
-
-            # Postprocessing
-            result['valid_mails'] = email_valido
-            result['invalid_mails'] = email_invalido
-
-            return result
-        
-        except Exception as e:
-            error_print(f'Error function: {self.send_email.__name__}! Error: {str(e)}.')
-            return None