csc-cia-stne 0.0.94__py3-none-any.whl → 0.0.96__py3-none-any.whl

csc_cia_stne/__init__.py

@@ -15,6 +15,7 @@ from .slack import Slack
 from .web import web_screen
 from .wacess import Waccess
 from .gcp_bucket import GCPBucket
+from .ftp import FTP
 
 # Define os itens disponíveis para importação
 __all__ = [
@@ -32,7 +33,8 @@ __all__ = [
     "Slack",
     "web_screen",
     "Waccess",
-    "GCPBucket"
+    "GCPBucket",
+    "FTP"
 ]
 
 _diretorio_inicial = os.getcwd()

csc_cia_stne/ftp.py

@@ -0,0 +1,306 @@
+import pycurl
+import socket
+import time
+import os
+from io import BytesIO
+
+from .utilitarios.validations.ftp import InitParamsValidator,UploadDownloadValidator,ListFilesValidator
+
+class FTP():
+
+    def __init__(self, host:str , user:str , password:str , timeout:int=30, port:bool=21, tls:bool=True, ssl:bool=True, verify_ssl:bool=False, verify_host:bool=False, tryouts:int=3):
+
+        self.host = host
+        self.user = user
+        self.password = password
+        self.port = port
+        self.timeout = timeout
+        self.tls = tls
+        self.ssl = ssl
+        self.verify_ssl = verify_ssl
+        self.verify_host = verify_host
+        self.tryouts = tryouts
+
+        try:
+
+            InitParamsValidator(
+                host=self.host,
+                user=self.user,
+                password=self.password,
+                port=self.port,
+                timeout=self.timeout,
+                tls=self.tls,
+                ssl=self.ssl,
+                verify_ssl=self.verify_ssl,
+                verify_host=self.verify_host,
+                tryouts=self.tryouts
+            )
+
+        except Exception as e:
+            
+            raise ValueError(f"Erro na validação dos parâmetros de inicialização: {str(e)}")
+
+
+        self._test_connection()
+
+    def _test_connection(self):
+        """
+        Testa a conexão com o servidor FTP utilizando o host e a porta especificados.
+        Este método tenta estabelecer uma conexão de socket com o servidor FTP
+        usando os parâmetros `host` e `port`. Caso a conexão seja bem-sucedida,
+        retorna `True`. Caso contrário, levanta uma exceção `ConnectionError` com
+        uma mensagem apropriada.
+        Raises:
+            ConnectionError: Se ocorrer um timeout ou se a conexão for recusada.
+            ConnectionError: Se ocorrer um erro desconhecido durante a tentativa de conexão.
+        Returns:
+            bool: `True` se a conexão for bem-sucedida.
+        """
+
+        try:
+
+            with socket.create_connection((self.host, self.port), timeout=self.timeout) as sock:
+
+                sock.close()
+
+                return True
+
+        except (socket.timeout, ConnectionRefusedError) as e:
+
+            raise ConnectionError(f"Erro de timeout ou conexão negada {self.host}:{self.port}. Error: {str(e)}")
+        
+        except Exception as e:
+
+            raise ConnectionError(f"Erro desconhecido ao tentar conexão com {self.host}:{self.port}. Error: {str(e)}")
+        
+    def _login_server(self):
+        """
+        Estabelece uma conexão com o servidor FTP utilizando as credenciais fornecidas e configurações de segurança.
+        Configurações:
+        - `self.user` e `self.password`: Credenciais de autenticação para o servidor FTP.
+        - `self.tls`: Se True, força o uso de TLS para a conexão.
+        - `self.ssl`: Se True, ativa FTPS explícito.
+        - `self.verify_ssl`: Se False, desativa a verificação de certificado SSL.
+        - `self.verify_host`: Se False, desativa a verificação do host SSL.
+        Retorna:
+            pycurl.Curl: Objeto de conexão configurado para o servidor FTP.
+        Exceções:
+            ConnectionError: Lançada quando ocorre um erro ao tentar estabelecer a conexão com o servidor FTP.
+        """
+
+        try:
+
+            connection_ftp = pycurl.Curl()
+
+            connection_ftp.setopt(connection_ftp.USERPWD, f"{self.user}:{self.password}")
+
+            connection_ftp.setopt(connection_ftp.CONNECTTIMEOUT, self.timeout)  # Tempo limite para conexão
+                    
+            connection_ftp.setopt(connection_ftp.TIMEOUT, self.timeout*2)  # Tempo limite para operação
+
+            if self.tls is True:
+
+                connection_ftp.setopt(connection_ftp.USE_SSL, connection_ftp.USESSL_ALL)  # Força uso de TLS
+            
+            if self.ssl is True:
+        
+                connection_ftp.setopt(connection_ftp.FTP_SSL, connection_ftp.FTPSSL_ALL)  # Ativa FTPS explícito
+
+            if self.verify_ssl is False:
+                
+                connection_ftp.setopt(connection_ftp.SSL_VERIFYPEER, 0)  # Desativar verificação SSL (ajuste conforme necessário)
+            
+            if self.verify_host is False:
+
+                connection_ftp.setopt(connection_ftp.SSL_VERIFYHOST, 0)  # Desativar verificação de host SSL
+
+            return connection_ftp
+        
+        except Exception as e:
+        
+            self._test_connection()
+
+            raise ConnectionError(f"Erro ao tentar conexão com o servidor FTP {self.host}:{self.port}. Error: {str(e)}")
+    
+    def upload_or_download_file(self, filename:str, filepathftp:str, method:str="UPLOAD"):
+        """
+        Faz upload ou download de um arquivo para/da um servidor FTP.
+        Args:
+            filename (str): Nome do arquivo local a ser enviado ou recebido.
+            filepathftp (str): Caminho remoto no servidor FTP onde o arquivo será enviado ou recebido.
+            method (str, opcional): Método de operação, "UPLOAD" para enviar arquivo ou "DOWNLOAD" para baixar arquivo. 
+                                    O padrão é "UPLOAD".
+        Returns:
+            dict: Um dicionário contendo:
+                - 'status' (bool): Indica se a operação foi bem-sucedida.
+                - 'status_code' (int): Código de resposta do servidor FTP.
+                - 'message' (str): Mensagem indicando o resultado da operação.
+        Raises:
+            FileNotFoundError: Se o arquivo especificado não for encontrado.
+            PermissionError: Se houver problemas de permissão ao acessar o arquivo.
+            Exception: Para outros erros durante a operação.
+        Nota:
+            O método tenta realizar a operação várias vezes, conforme definido em `self.tryouts`.
+            Em caso de falha, retorna um status indicando o erro.
+        """
+        
+        try:
+
+            UploadDownloadValidator(
+                filename=filename,
+                filepathftp=filepathftp,
+                method=method.upper()
+            )
+
+        except Exception as e:
+
+            raise ValueError(f"Erro na validação dos parâmetros de upload/download: {str(e)}")
+
+        filename = os.path.join(os.getcwd(), filename)
+
+        connection_ftp = self._login_server()
+
+        remote_path = f"{filepathftp}{filename}"
+
+        ftp_url = f"ftp://{self.host}{remote_path}"
+
+        status_upload = True
+
+        methodfile = "rb"
+
+        if method.upper() == "DOWNLOAD":
+
+            methodfile = "wb"
+
+        for try_out in range(self.tryouts):
+
+            time.sleep(5)
+
+            try:
+
+                with open(filename, methodfile) as file:
+
+                    connection_ftp.setopt(connection_ftp.URL, ftp_url)
+
+                    connection_ftp.setopt(connection_ftp.UPLOAD, 1)
+
+                    if method.upper() == "UPLOAD":
+                    
+                        connection_ftp.setopt(connection_ftp.READDATA, file)
+                    
+                    elif method.upper() == "DOWNLOAD":
+                      
+                        connection_ftp.setopt(connection_ftp.WRITEDATA, file)
+
+                    connection_ftp.perform()
+
+                    status_code = connection_ftp.getinfo(connection_ftp.RESPONSE_CODE)
+
+                    break
+                
+            except FileNotFoundError as e:
+
+                raise FileNotFoundError(f"Arquivo '{filename}' não encontrado. Error: {str(e)}")
+            
+            except PermissionError as e:
+
+                raise PermissionError(f"Permissão negada para acessar o arquivo '{filename}'. Error: {str(e)}")
+
+            except Exception as e:
+
+                status_code = None
+                
+                status_upload = False
+
+        if status_code == 226:
+
+            status_upload = True
+
+        else:
+
+            status_upload = False
+        
+        connection_ftp.close()
+
+        return {
+            'status': status_upload,
+            'status_code': status_code
+        }
+    
+    def list_files(self, filepathftp:str):
+        """
+        Lista arquivos em um diretório FTP especificado.
+        Este método conecta-se a um servidor FTP, lista os arquivos disponíveis no diretório especificado
+        e retorna os nomes dos arquivos juntamente com metadados, se disponíveis.
+        Args:
+            filepathftp (str): Caminho do diretório no servidor FTP onde os arquivos serão listados.
+        Returns:
+            dict: Um dicionário contendo:
+                - 'status' (bool): Indica se a operação foi bem-sucedida.
+                - 'status_code' (int ou None): Código de resposta do servidor FTP.
+                - 'message' (str): Mensagem detalhando o resultado da operação.
+                - 'files' (list): Lista de arquivos encontrados no diretório FTP.
+        Raises:
+            ConnectionError: Caso ocorra algum erro ao criar o buffer de memória ou ao definir a URL do FTP.
+        """
+
+        try:
+
+            ListFilesValidator(filepathftp=filepathftp)
+
+        except Exception as e:
+
+            raise ValueError(f"Erro na validação dos parâmetros de listagem de arquivos: {str(e)}")
+
+        try:
+
+            buffer = BytesIO()
+
+        except Exception as e:
+
+            raise ConnectionError(f"Erro ao criar buffer de memória. Error: {str(e)}")
+        
+        connection_ftp = self._login_server()
+
+        ftp_url = f"ftp://{self.host}{filepathftp}"
+
+        for try_out in range(self.tryouts):
+
+            try:
+
+                connection_ftp.setopt(connection_ftp.URL, ftp_url)
+
+                connection_ftp.setopt(connection_ftp.WRITEDATA, buffer)
+
+                connection_ftp.setopt(connection_ftp.VERBOSE, False)
+
+                connection_ftp.setopt(connection_ftp.NOBODY, False)
+
+                connection_ftp.setopt(connection_ftp.DIRLISTONLY, False)  # True = apenas nomes; False = nomes + metadados estilo ls -l
+    
+                connection_ftp.perform()
+
+                conteudo = buffer.getvalue().decode('utf-8')
+
+                lista_arquivos = [linha.strip() for linha in conteudo.splitlines() if linha.strip()]
+
+                connection_ftp.close()
+
+                return {
+                    'status': True,
+                    'status_code': connection_ftp.getinfo(connection_ftp.RESPONSE_CODE),
+                    'message': f"Arquivos listados com sucesso de {self.host}:{self.port}/{filepathftp}.",
+                    'files': lista_arquivos
+                }
+
+            except Exception as e:
+
+                raise ConnectionError(f"Erro ao definir URL do FTP. Error: {str(e)}")
+
+        connection_ftp.close()
+
+        return {
+            'status': False,
+            'status_code': None,
+            'message': f"Falha ao listar arquivos de {self.host}:{self.port}/{filepathftp}."
+        }

csc_cia_stne/stne_admin.py

@@ -543,7 +543,7 @@ class StoneAdmin:
             
             if async_mode:
             
-                response = requests.get(f"{self.base_url}/exports/accounts/{account_id}/statement?start_date={data_inicio}&end_date={data_fim}&format=pdf&async=true", headers=self.authenticated_header, timeout=60)
+                response = requests.get(f"{self.base_url}/exports/accounts/{account_id}/statement?start_date={data_inicio}&end_date={data_fim}&format=pdf&async=true", headers=self.authenticated_header, timeout=120)
             
             else:
             

csc_cia_stne/utilitarios/functions/__init__.py

@@ -4,8 +4,9 @@ from .func_b64 import b64decode, b64encode
 from .func_converters import convert_bquery_result_to_json
 from .func_settings import get_config
 from .func_get_secret import get_secret
-from .func_rdp import obter_ip_conexao_rdp, conectar_rdp
+# from .func_rdp import obter_ip_conexao_rdp, conectar_rdp
 from .func_datetime import now_sp
+
 __all__ = [
     "titulo", 
     "recriar_pasta", 
@@ -14,7 +15,7 @@ __all__ = [
     "convert_bquery_result_to_json",
     "get_config",
     "get_secret",
-    "obter_ip_conexao_rdp",
+    # "obter_ip_conexao_rdp",
     "now_sp",
-    "conectar_rdp"
+    # "conectar_rdp"
     ]

csc_cia_stne/utilitarios/functions/func_rdp.py

@@ -1,147 +1,147 @@
-import platform
-import subprocess
-import time
-import pyautogui
-import psutil
-import pygetwindow as gw
-import logging
-pyautogui.USE_MOUSEINFO = False
-log = logging.getLogger('__main__')
+# import platform
+# import subprocess
+# import time
+# import pyautogui
+# import psutil
+# import pygetwindow as gw
+# import logging
+# pyautogui.USE_MOUSEINFO = False
+# log = logging.getLogger('__main__')
 
-def obter_ip_conexao_rdp():
-    """Retorna o ip da conexão RDP
+# def obter_ip_conexao_rdp():
+#     """Retorna o ip da conexão RDP
 
-    Returns:
-        str: ip
-    """
+#     Returns:
+#         str: ip
+#     """
     
-    for proc in psutil.process_iter(['pid', 'name', 'cmdline']):
+#     for proc in psutil.process_iter(['pid', 'name', 'cmdline']):
     
-        if proc.info['name'] == 'mstsc.exe' and proc.info['cmdline']:
+#         if proc.info['name'] == 'mstsc.exe' and proc.info['cmdline']:
     
-            for arg in proc.info['cmdline']:
+#             for arg in proc.info['cmdline']:
     
-                if arg.startswith("/v:"):  # O argumento '/v:' contém o IP
+#                 if arg.startswith("/v:"):  # O argumento '/v:' contém o IP
     
-                    return arg.replace("/v:", "").strip()
+#                     return arg.replace("/v:", "").strip()
     
-    return None
+#     return None
 
-def verificar_sessao_rdp()->bool:
-    """Verifica se a sessão RDP está ativa"""
-    # Verifica se o processo mstsc.exe está rodando
-    for proc in psutil.process_iter(['name']):
-        if proc.info['name'] == 'mstsc.exe':
-            #return True
+# def verificar_sessao_rdp()->bool:
+#     """Verifica se a sessão RDP está ativa"""
+#     # Verifica se o processo mstsc.exe está rodando
+#     for proc in psutil.process_iter(['name']):
+#         if proc.info['name'] == 'mstsc.exe':
+#             #return True
     
-            # Verifica se a janela da Área de Trabalho Remota está aberta
-            for window in gw.getAllTitles():
-                if "Área de Trabalho Remota" in window or "Remote Desktop" in window:
-                    return True
+#             # Verifica se a janela da Área de Trabalho Remota está aberta
+#             for window in gw.getAllTitles():
+#                 if "Área de Trabalho Remota" in window or "Remote Desktop" in window:
+#                     return True
     
-    return False
+#     return False
 
-def conectar_rdp(host:str, usuario:str, senha:str)->bool:
-    """Conecta via RDP em uma máquina remota
+# def conectar_rdp(host:str, usuario:str, senha:str)->bool:
+#     """Conecta via RDP em uma máquina remota
     
-    Args:
+#     Args:
     
-            host (str): ip/host destino
-        usuario (str): usuário
-        senha (str): senha
+#             host (str): ip/host destino
+#         usuario (str): usuário
+#         senha (str): senha
     
-    Returns:
-        bool: True/False
-    """
+#     Returns:
+#         bool: True/False
+#     """
     
-    sistema = platform.system()
+#     sistema = platform.system()
 
-    if sistema == "Windows":
+#     if sistema == "Windows":
 
-        try:
+#         try:
             
-            def criar_arquivo_rdp(host, usuario, caminho_rdp="conexao.rdp")->str:
-                """Cria um arquivo .rdp para conexão RDP
-                Args:
-                    host (str): host do computador remoto
-                    usuario (str): Usuário
-                    caminho_rdp (str): Caminho do arquivo .rdp
-                Returns:
-                    str: Caminho do arquivo .rdp
-                """
-                conteudo_rdp = f"""
-                screen mode id:i:2
-                desktopwidth:i:1920
-                desktopheight:i:1080
-                session bpp:i:32
-                winposstr:s:0,1,0,0,800,600
-                full address:s:{host}
-                username:s:{usuario}
-                """
-                with open(caminho_rdp, "w") as arquivo:
-                    arquivo.write(conteudo_rdp.strip())
+#             def criar_arquivo_rdp(host, usuario, caminho_rdp="conexao.rdp")->str:
+#                 """Cria um arquivo .rdp para conexão RDP
+#                 Args:
+#                     host (str): host do computador remoto
+#                     usuario (str): Usuário
+#                     caminho_rdp (str): Caminho do arquivo .rdp
+#                 Returns:
+#                     str: Caminho do arquivo .rdp
+#                 """
+#                 conteudo_rdp = f"""
+#                 screen mode id:i:2
+#                 desktopwidth:i:1920
+#                 desktopheight:i:1080
+#                 session bpp:i:32
+#                 winposstr:s:0,1,0,0,800,600
+#                 full address:s:{host}
+#                 username:s:{usuario}
+#                 """
+#                 with open(caminho_rdp, "w") as arquivo:
+#                     arquivo.write(conteudo_rdp.strip())
                 
-                return caminho_rdp
+#                 return caminho_rdp
 
-            caminho_rdp = criar_arquivo_rdp(host, usuario)
-            subprocess.run(f"start mstsc {caminho_rdp}", shell=True)
-            # Espera a conexão ser feita e confirma que realmente quer fazer a conexão com o computador remoto de forma insegura (certificado)
-            time.sleep(10)
-            pyautogui.press('left')
-            pyautogui.press('enter')
-            # Espera 3 segundos para digitar a senha e dar enter
-            time.sleep(3)
-            pyautogui.write(senha)
-            pyautogui.press('enter')
-            # Espera 5 segundos para aparecer a tela sobre o certificado e aceitar a conexão de forma insegura (certificado)
-            time.sleep(5)
-            pyautogui.press('left')
-            pyautogui.press('enter')
-            # Aguarda 5 segundos e verifica se a conexão foi feita com sucesso
-            time.sleep(5)
-            return verificar_sessao_rdp()
+#             caminho_rdp = criar_arquivo_rdp(host, usuario)
+#             subprocess.run(f"start mstsc {caminho_rdp}", shell=True)
+#             # Espera a conexão ser feita e confirma que realmente quer fazer a conexão com o computador remoto de forma insegura (certificado)
+#             time.sleep(10)
+#             pyautogui.press('left')
+#             pyautogui.press('enter')
+#             # Espera 3 segundos para digitar a senha e dar enter
+#             time.sleep(3)
+#             pyautogui.write(senha)
+#             pyautogui.press('enter')
+#             # Espera 5 segundos para aparecer a tela sobre o certificado e aceitar a conexão de forma insegura (certificado)
+#             time.sleep(5)
+#             pyautogui.press('left')
+#             pyautogui.press('enter')
+#             # Aguarda 5 segundos e verifica se a conexão foi feita com sucesso
+#             time.sleep(5)
+#             return verificar_sessao_rdp()
         
-        except Exception as e:
+#         except Exception as e:
 
-            log.error(f"Erro ao conectar à área de trabalho remota:\n{e}")
-            return False
+#             log.error(f"Erro ao conectar à área de trabalho remota:\n{e}")
+#             return False
     
-    elif sistema == "Linux":
+#     elif sistema == "Linux":
         
-        # Comando para executar a conexao com o xfreerdp
-        # Para instalar: sudo apt install freerdp2-x11
-        comando_rdp = f"""xfreerdp /u:{usuario} /p:{senha} /v:{host} /size:1920x1080"""
+#         # Comando para executar a conexao com o xfreerdp
+#         # Para instalar: sudo apt install freerdp2-x11
+#         comando_rdp = f"""xfreerdp /u:{usuario} /p:{senha} /v:{host} /size:1920x1080"""
 
-        # Executar o comando e capturar saída
-        try:
+#         # Executar o comando e capturar saída
+#         try:
             
-            processo_rdp = subprocess.Popen(
-                comando_rdp,
-                shell=True,
-                stdout=subprocess.PIPE,
-                stderr=subprocess.PIPE,
-                text=True
-            )
+#             processo_rdp = subprocess.Popen(
+#                 comando_rdp,
+#                 shell=True,
+#                 stdout=subprocess.PIPE,
+#                 stderr=subprocess.PIPE,
+#                 text=True
+#             )
         
-        except Exception as e:
+#         except Exception as e:
         
-            raise Exception(f"Falha ao executar o comando de conexão RDP no Linux. Você possui o xfreerdp instalado? (sudo apt install freerdp2-x11)\nErro: {str(e)}")
+#             raise Exception(f"Falha ao executar o comando de conexão RDP no Linux. Você possui o xfreerdp instalado? (sudo apt install freerdp2-x11)\nErro: {str(e)}")
         
-        # Aguarda 10 segundos, para aparecer o banner azul
-        time.sleep(10)
+#         # Aguarda 10 segundos, para aparecer o banner azul
+#         time.sleep(10)
 
-        # Se a conexão foi bem-sucedida, retornar True
-        if processo_rdp.poll() is None:
+#         # Se a conexão foi bem-sucedida, retornar True
+#         if processo_rdp.poll() is None:
             
-            # Clica no 'enter', no banner azul
-            pyautogui.press('enter')
-            return True
+#             # Clica no 'enter', no banner azul
+#             pyautogui.press('enter')
+#             return True
 
-        else:
+#         else:
 
-            return False
+#             return False
         
-    else:
+#     else:
 
-        raise Exception("Sistema operacional não suportado (Somente 'Windows' ou 'Linux').")
+#         raise Exception("Sistema operacional não suportado (Somente 'Windows' ou 'Linux').")
 

csc_cia_stne/utilitarios/validations/ftp.py

@@ -0,0 +1,109 @@
+from pydantic import BaseModel, field_validator
+
+class InitParamsValidator(BaseModel):
+    """
+    Classe InitParamsValidator
+    Valida os parâmetros de inicialização para conexão FTP.
+    Atributos:
+        host (str): Endereço do servidor FTP. Deve ser uma string não vazia.
+        user (str): Nome de usuário para autenticação. Deve ser uma string não vazia.
+        password (str): Senha para autenticação. Deve ser uma string não vazia.
+        port (int): Porta do servidor FTP. Deve ser um inteiro positivo.
+        tryouts (int): Número de tentativas de conexão. Deve ser um inteiro positivo.
+        timeout (int): Tempo limite para conexão em segundos. Deve ser um inteiro positivo.
+        tls (bool): Indica se a conexão deve usar TLS. Deve ser um valor booleano.
+        ssl (bool): Indica se a conexão deve usar SSL. Deve ser um valor booleano.
+        verify_ssl (bool): Indica se o certificado SSL deve ser verificado. Deve ser um valor booleano.
+        verify_host (bool): Indica se o host deve ser verificado. Deve ser um valor booleano.
+    Métodos:
+        check_str_input(cls, value, info):
+            Valida se os campos 'host', 'user' e 'password' são strings não vazias.
+            Levanta ValueError caso o valor seja inválido.
+        check_int_input(cls, value, info):
+            Valida se os campos 'port', 'timeout' e 'tryouts' são inteiros positivos.
+            Levanta ValueError caso o valor seja inválido.
+        check_bool_input(cls, value, info):
+            Valida se os campos 'tls', 'ssl', 'verify_ssl' e 'verify_host' são booleanos.
+            Levanta ValueError caso o valor seja inválido.
+    """
+    host:str
+    user:str
+    password:str
+    port:int
+    tryouts:int
+    timeout:int
+    tls:bool
+    ssl:bool
+    verify_ssl:bool
+    verify_host:bool
+
+    @field_validator('host','user','password')
+    def check_str_input(cls, value, info):
+        if not isinstance(value, str) or not value.strip():
+            raise ValueError(f"O parametro '{info.field_name}' deve ser uma string e não um {type(value)} e não vazio")
+        return value
+    
+    @field_validator('port','timeout','tryouts')
+    def check_int_input(cls, value, info):
+        if not isinstance(value, int) or value <= 0:
+            raise ValueError(f"O parametro '{info.field_name}' deve ser um inteiro positivo e não um {type(value)}")
+        return value
+    
+    @field_validator('tls','ssl','verify_ssl','verify_host')
+    def check_bool_input(cls, value, info):
+        if not isinstance(value, bool):
+            raise ValueError(f"O parametro '{info.field_name}' deve ser um booleano e não um {type(value)}")
+        return value
+    
+
+class UploadDownloadValidator(BaseModel):
+    """
+    Classe UploadDownloadValidator
+    Valida os parâmetros fornecidos para operações de upload e download via FTP.
+    Atributos:
+        filename (str): Nome do arquivo. Deve ser uma string não vazia.
+        filepathftp (str): Caminho no FTP onde o arquivo está localizado ou será armazenado. Deve ser uma string não vazia.
+        method (str): Método da operação, deve ser 'upload' ou 'download'.
+    Métodos:
+        check_str_input(cls, value, info):
+            Valida se os campos 'filename' e 'filepathftp' são strings não vazias.
+            Levanta ValueError se o valor não for uma string ou estiver vazio.
+        check_method(cls, value):
+            Valida se o campo 'method' é 'upload' ou 'download'.
+            Levanta ValueError se o valor não for uma das opções válidas.
+    """
+    filename:str
+    filepathftp:str
+    method:str
+
+    @field_validator('filename','filepathftp')
+    def check_str_input(cls, value, info):
+        if not isinstance(value, str) or not value.strip():
+            raise ValueError(f"O parametro '{info.field_name}' deve ser uma string e não um {type(value)} e não vazio")
+        return value
+    
+    @field_validator('method')
+    def check_method(cls, value):
+        if str(value).lower() not in ['upload', 'download']:
+            raise ValueError(f"O parametro 'method' deve ser 'upload' ou 'download', mas foi recebido '{value}'")
+        return value
+    
+
+class ListFilesValidator(BaseModel):
+    """
+    Classe ListFilesValidator
+    Valida os parâmetros relacionados ao caminho de arquivos no FTP.
+    Atributos:
+        filepathftp (str): Representa o caminho do arquivo no FTP. Deve ser uma string não vazia.
+    Métodos:
+        check_str_input(cls, value, info):
+            Valida se o valor fornecido para o campo 'filepathftp' é uma string não vazia.
+            Levanta um ValueError caso o valor não seja uma string ou seja vazio.
+    """
+    filepathftp:str
+
+    @field_validator('filepathftp')
+    def check_str_input(cls, value, info):
+        if not isinstance(value, str) or not value.strip():
+            raise ValueError(f"O parametro '{info.field_name}' deve ser uma string e não um {type(value)} e não vazio")
+        return value

{csc_cia_stne-0.0.94.dist-info → csc_cia_stne-0.0.96.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csc_cia_stne
-Version: 0.0.94
+Version: 0.0.96
 Summary: Biblioteca do time CSC-CIA utilizada no desenvolvimento de RPAs
 License: MIT
 Keywords: karavela,csc,cia,stone,rpa,botcity,stne
@@ -30,7 +30,8 @@ Requires-Dist: email-validator
 Requires-Dist: botcity-maestro-sdk
 Requires-Dist: psutil
 Requires-Dist: cryptography
-Requires-Dist: pyautogui
+Requires-Dist: pycurl
+Requires-Dist: socket
 Dynamic: license-file
 
 Essa biblioteca é desenvolvida e atualizada pelo time **CSC-CIA** da **Stone**

{csc_cia_stne-0.0.94.dist-info → csc_cia_stne-0.0.96.dist-info}/RECORD

@@ -1,7 +1,8 @@
-csc_cia_stne/__init__.py,sha256=mJsIonLLjMtAmJcVGiEcvtGchVIk5soOR9VO7D9oaCY,2606
+csc_cia_stne/__init__.py,sha256=jwLhGpOwFCow_6cqzwLn31WcIrMzutMZtEQpLL4bQtM,2638
 csc_cia_stne/bc_correios.py,sha256=pQAnRrcXEMrx3N1MWydZVIhEQLerh3x8-0B045zZIzk,24174
 csc_cia_stne/bc_sta.py,sha256=sE-aU-ZVSAqryQrT1-nor9eAFM5npNAKF1QSm-ChhGU,28945
 csc_cia_stne/email.py,sha256=K0DcgxTPKa_Rz_SJekjbW8Nw_1L9s_iuDDxZ-69bZfM,8387
+csc_cia_stne/ftp.py,sha256=zoUQMRKTWdpUUmy0Ty2PT4mMaW84tPgs4d11O8HMNhQ,10833
 csc_cia_stne/gcp_bigquery.py,sha256=foq8azvvv_f7uikMDslX9RcUIrx7RAS-Sn0AGW0QFQc,7231
 csc_cia_stne/gcp_bucket.py,sha256=nP77BtagZ7jQq6lS88ZEa1qshzBza6e_LvhgS3_JJJk,10268
 csc_cia_stne/google_drive.py,sha256=k6GnM8bxQUPbXhaK6Sa4JpWrCcJ0vzYgXP8Uexy7YR0,16073
@@ -11,16 +12,16 @@ csc_cia_stne/logger_rich.py,sha256=fklgkBb4rblKQd7YZ3q-eWfhGg9eflO2k2-z4pGh_yo,5
 csc_cia_stne/provio.py,sha256=G-pDnHYLSp97joc7S7dvwjNvl3omnTmvdi3rOPQf5GA,3987
 csc_cia_stne/servicenow.py,sha256=cJtNtLZ8glWfs3OAzl78ZFlPyPz39CSBxHqpTdUU7i0,32136
 csc_cia_stne/slack.py,sha256=sPLeaQh_JewLcrBDjjwUgbjtC7d1Np03OTy06JimMV4,8117
-csc_cia_stne/stne_admin.py,sha256=cQPGnLTVEgcR18U6qEwxx0pR-zEaqJ_vB0onJpEu7jY,24219
+csc_cia_stne/stne_admin.py,sha256=4v_BVQAwZeWmxvjDOkwFAl9yIxJ3r54BY7pRgAgSXEM,24220
 csc_cia_stne/wacess.py,sha256=g-bWZNpm_tU7UsW1G_rqh_2fW2KShvxZHGOerX8DuQw,26768
 csc_cia_stne/web.py,sha256=_pc6BzPy2x0RvqtZsByjtKcSuUqlVTevfmmmKbVWLhA,15417
 csc_cia_stne/utilitarios/__init__.py,sha256=rBGAmW0WcZnwTfVNuikNuJ1RBs6o7aw4xrV2QSsF9Bs,389
-csc_cia_stne/utilitarios/functions/__init__.py,sha256=vdiPAyPmUDGDhtecJmcrXADGPW2yKD-aV3wP9SyLYbE,574
+csc_cia_stne/utilitarios/functions/__init__.py,sha256=6qM7QH4hI-5Gmg22aH_z93NRkTmjSbBayF2aW-81A6A,581
 csc_cia_stne/utilitarios/functions/func_b64.py,sha256=XGU34BIQQXWXBS0yM2B4A2wDlcrMl1unIJXjq4lpLnk,1254
 csc_cia_stne/utilitarios/functions/func_converters.py,sha256=EY1zvlBaRX7G1MceVSiRXwwKDQDZwUO9iECBL0fe5iU,481
 csc_cia_stne/utilitarios/functions/func_datetime.py,sha256=UA7ch4sQWTiYcz8r6LtGujIdpTU-Sht8qmTYvm9vhh0,257
 csc_cia_stne/utilitarios/functions/func_get_secret.py,sha256=cJZe_qtFFbISfQAo0iSCHjqutIjMvRF-L3I_bKUpM8I,2869
-csc_cia_stne/utilitarios/functions/func_rdp.py,sha256=bHzMEv2mofRLMB0DswW1-mLtYqQdrGPz3Lnt6xQNxFA,4713
+csc_cia_stne/utilitarios/functions/func_rdp.py,sha256=HdQ2vnrMPGqhS5gepqrAFBW_Lc7gpZjX0nWItmi2OAA,4933
 csc_cia_stne/utilitarios/functions/func_recriar_pastas.py,sha256=4whZpB3aJQaCPJ3osMAQpKrzEhqYtJbljGWlx_OvKIM,826
 csc_cia_stne/utilitarios/functions/func_settings.py,sha256=XwlfqdcfocXQ8kTsDKZ6GsAtpzr0_u44AOTIMtdem7U,2059
 csc_cia_stne/utilitarios/functions/func_titulo.py,sha256=bH4tYxovTARF-g2kWUK_GIzzXt8egbVdp6mWD6fc_3I,5345
@@ -28,11 +29,12 @@ csc_cia_stne/utilitarios/validations/GcpBigQueryValidator.py,sha256=PfCeeQquheZk
 csc_cia_stne/utilitarios/validations/GoogleDriveValidator.py,sha256=Q1oZTae4hDJ2TQ4sUL5Q5TkDNPoJo-DZQt6wIue2jwM,4811
 csc_cia_stne/utilitarios/validations/ServiceNowValidator.py,sha256=yleKUIo1ZfyloP9fDPNjv3JJXdLcocT81WIgRSYmqEA,14423
 csc_cia_stne/utilitarios/validations/__init__.py,sha256=O_qyEU2ji3u6LHUXZCXvUFsMpoMWL625qqHTXyXivTA,106
+csc_cia_stne/utilitarios/validations/ftp.py,sha256=LNYyS2c8eou3ML23bBtn87xJFIKSrb8w-2acG0Zugog,4988
 csc_cia_stne/utilitarios/validations/gcp_bucket.py,sha256=vqj70jBAkazydUCPXIdE3zzgoz8Te2cCJNX_rICX1aM,6096
 csc_cia_stne/utilitarios/validations/waccess.py,sha256=8yfOrmIPUSLzbCt6P0F6vj3FkSgU_RgrJpJlRhlLyV0,7352
 csc_cia_stne/utilitarios/validations/web_validator.py,sha256=HYKYSpDv1RvRjZIuwTPt-AbEz-9392MxM_O329iYuSA,5722
-csc_cia_stne-0.0.94.dist-info/licenses/LICENCE,sha256=LPGMtgKki2C3KEZP7hDhA1HBrlq5JCHkIeStUCLEMx4,1073
-csc_cia_stne-0.0.94.dist-info/METADATA,sha256=FkD61mTHmc7wwlftswSQY3Jynlz0AxCmIR3t9AhY31M,1422
-csc_cia_stne-0.0.94.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-csc_cia_stne-0.0.94.dist-info/top_level.txt,sha256=ldo7GVv3tQx5KJvwBzdZzzQmjPys2NDVVn1rv0BOF2Q,13
-csc_cia_stne-0.0.94.dist-info/RECORD,,
+csc_cia_stne-0.0.96.dist-info/licenses/LICENCE,sha256=LPGMtgKki2C3KEZP7hDhA1HBrlq5JCHkIeStUCLEMx4,1073
+csc_cia_stne-0.0.96.dist-info/METADATA,sha256=R8uQ09aOb_G7yhc8IbFev48OtBJR3c5pZTvgXOSI9V8,1441
+csc_cia_stne-0.0.96.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+csc_cia_stne-0.0.96.dist-info/top_level.txt,sha256=ldo7GVv3tQx5KJvwBzdZzzQmjPys2NDVVn1rv0BOF2Q,13
+csc_cia_stne-0.0.96.dist-info/RECORD,,

{csc_cia_stne-0.0.94.dist-info → csc_cia_stne-0.0.96.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any