csc-cia-stne 0.1.10__tar.gz → 0.1.12__tar.gz

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csc_cia_stne
-Version: 0.1.10
+Version: 0.1.12
 Summary: Biblioteca do time CSC-CIA utilizada no desenvolvimento de RPAs
 License: MIT
 Keywords: karavela,csc,cia,stone,rpa,botcity,stne

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "csc_cia_stne"
-version = "0.1.10"
+version = "0.1.12"
 license = { text = "MIT" }
 description = "Biblioteca do time CSC-CIA utilizada no desenvolvimento de RPAs"
 keywords = ["karavela", "csc", "cia", "stone", "rpa", "botcity", "stne"]

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne/bc_correios.py

@@ -7,7 +7,7 @@ from requests.auth import HTTPBasicAuth
 from datetime import timedelta, datetime, time
 from typing import List, Tuple, Union, Optional
 from pydantic import BaseModel
-
+log = logging.getLogger(__name__)
 class PastasAutorizadas(BaseModel):
     MensagemErro: Optional[str] = None
     OcorreuErro: bool
@@ -218,7 +218,7 @@ class BC_Correios:
                     break
                 
                 for correio in correios:
-
+                    
                     item_de_lista_de_correios = ItemListaCorreio(
                         Assunto=correio.Assunto,
                         Data=correio.Data,
@@ -248,17 +248,18 @@ class BC_Correios:
 
                 if len(correios_filtrados) >= proxima_centena:
 
-                    logging.info(f"Página #{pagina_atual}: {len(correios_filtrados)} correios armazenados no total")
+                    log.info(f"Página #{pagina_atual}: {len(correios_filtrados)} correios armazenados no total")
                     proxima_centena = proxima_centena + 100
 
                 # Avança para a próxima página
                 pagina_atual += 1
 
-            return True, correios_filtrados
-        
+            #return True, correios_filtrados
+            return {"success": True, "data": correios_filtrados, "error": None}
+
         except Exception as e:
-            
-            return False, e
+
+            return {"success": False, "data": None, "error": str(e)}
 
     def ler_correio(self, numero:int,data_rebimento:datetime,tipo:str,transicao:int,versao:int,pasta:str)-> Tuple[bool, Union[ItemMsgCorreio, Exception]]:
         """
@@ -425,7 +426,8 @@ class BC_Correios:
             #novo end
 
             #return True, response
-            return True, msg_detail
+            #return True, msg_detail
+            return {"success": True, "data": msg_detail, "error": None}
 
             # Serializa o objeto SOAP em um dicionário Python
             #serialized_response = serialize_object(response)
@@ -437,7 +439,8 @@ class BC_Correios:
 
         except Exception as e:
 
-            return False, e
+            #return False, e
+            return {"success": False, "data": None, "error": str(e)}
         
     def obter_anexo(self, numero:int, versao:int, transicao:int,pasta:str,anexo_id:int,file_name:str,conteudo:str)-> Tuple[bool,Union[dict, Exception]]:
         """
@@ -504,17 +507,20 @@ class BC_Correios:
                 conteudo_anexo = response.Anexo.Conteudo
                 
                 # Retorna os dados capturados como um dicionário
-                return True, {
-                    'IdAnexo': id_anexo,
-                    'NomeAnexo': nome_anexo,
-                    'Conteudo': conteudo_anexo
-                }
+                #return True, {
+                #    'IdAnexo': id_anexo,
+                #    'NomeAnexo': nome_anexo,
+                #    'Conteudo': conteudo_anexo
+                #}
+                return {"success": True, "error": None, "data": conteudo_anexo}
             else:
-                return False, Exception("Correio não possui anexo")
+                return {"success": True, "error": "Correio não possui anexo", "data": None}
+                #return False, Exception("Correio não possui anexo")
         
         except Exception as e:
             
-            return False, e
+            return {"success": False, "error": str(e), "data": None}
+            #return False, e
 
     def encerrar(self):
         """Fecha o cliente e libera a sessão."""

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne/servicenow.py

@@ -139,7 +139,7 @@ class ServiceNow:
             logging.debug(f"Erro inesperado: {e}")
             return {"success": False, "result": None, "error": str(e)}
 
-    def __request_download(self, url, params="", timeout=15):
+    def __request_download(self, url: str, params: str="", timeout: int=15):
         """
         Realiza uma requisição GET para a URL especificada.
 
@@ -199,7 +199,7 @@ class ServiceNow:
             logging.debug(f"Erro inesperado: {e}")
             return {"success": False, "error": str(e), "result": None}
 
-    def put(self, url, payload, timeout=15):
+    def put(self, url: str, payload: dict, timeout: int = 15):
         """
         Realiza uma requisição PUT para a URL especificada.
 
@@ -251,17 +251,7 @@ class ServiceNow:
 
             # POSSUINDO 'RESULT', TEREMOS O RETORNO DO TICKET ABERTO.
             result = response.json()
-            if "result" in result:
-                update = result["result"]
-                logging.debug(
-                    f"Atualização concluída com sucesso. Registro atualizado: {update['sys_id']} | Alterações: {payload}"
-                )
-                return {"success": True, "result": update}
-            else:
-                logging.debug(
-                    f"A Resposta da sua requisição não contém o campo 'Result'. Segue o retorno: \n {result} | Alterações: {payload}"
-                )
-                return {"success": False, "result": result}
+            return {"success": True, "result": result["result"], "error": None} if "result" in result else {"success": False, "result": result, "error": None}
 
         # TRATAMENTOS DE ERRO
         except requests.exceptions.HTTPError as http_err:
@@ -279,7 +269,7 @@ class ServiceNow:
             return {"success": False, "error": str(e), "result": None}
 
     def post(
-        self, url: str, variables: dict, header_content_type="", timeout: int = 15
+        self, url: str, payload: dict, header_content_type="", timeout: int = 15
     ):
         """
         Função para criar um novo ticket no servicenow usando o API REST.
@@ -293,7 +283,7 @@ class ServiceNow:
 
         """
         try:
-            PostValidator(url=url, variables=variables)
+            PostValidator(url=url, variables=payload)
         except ValidationError as e:
             raise ValueError(
                 "Erro na validação dos dados de input do método:", e.errors()
@@ -303,15 +293,12 @@ class ServiceNow:
             header = header_content_type
         else:
             header = self.api_header
-
-        # Ajustar o Payload para a abertura do ticket
-        payload = {"sysparm_quantity": "1", "variables": json.dumps(variables)}
         try:
             response = requests.post(
-                f"{url}",
+                url,
                 auth=self.__auth(),
                 headers=header,
-                data=f"{payload}",
+                json=payload,
                 timeout=timeout,
             )
 
@@ -320,18 +307,8 @@ class ServiceNow:
 
             # POSSUINDO 'RESULT', TEREMOS O RETORNO DO TICKET ABERTO.
             result = response.json()
-            if "result" in result:
-                ticket_number = result["result"].get("number")
-                ticket_sys_id = result["result"].get("sys_id")
-                logging.debug(
-                    f"Ticket registrado com sucesso. Número: {ticket_number} | SYS_ID: {ticket_sys_id}"
-                )
-                return {"success": True, "result": result["result"]}
-            else:
-                logging.debug(
-                    f"A Resposta da sua requisição não contém o campo 'Result'. Segue o retorno: \n {result}"
-                )
-                return {"success": False, "result": result}
+            return {"success": True, "result": result["result"], "error" : None} if "result" in result else {"success": False, "result": result, "error" : None}
+
 
         # TRATAMENTOS DE ERRO
         except requests.exceptions.HTTPError as http_err:
@@ -502,7 +479,7 @@ class ServiceNow:
                 )
 
             logging.debug("Arquivo adicionado no ticket")
-            return {"success": True, "result": response}
+            return {"success": True, "result": response.json()}
 
         except Exception as e:
             return {"success": False, "result": None, "error": str(e)}
@@ -617,7 +594,6 @@ class ServiceNow:
             try:
                 if not os.path.exists(file_path):
                     diretorio = os.path.dirname(file_path)
-                    print(diretorio)
                     os.makedirs(diretorio, exist_ok=True)
                     logging.debug(f"Diretorio criado: {diretorio}")
                 with open(file_path, "wb") as f:

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne/utilitarios/__init__.py

@@ -1,4 +1,5 @@
-from .functions import titulo, recriar_pasta, b64encode, b64decode, convert_bquery_result_to_json,get_config, get_secret, now_sp
+from .functions import titulo, recriar_pasta, b64encode, b64decode, convert_bquery_result_to_json,get_config, get_secret, now_sp, validate_json, delete_file, delete_folder
+
 __all__ = [
     "titulo", 
     "recriar_pasta", 
@@ -8,4 +9,7 @@ __all__ = [
     "get_config",
     "get_secret",
     "now_sp",
+    "delete_file",
+    "delete_folder",
+    "validate_json"
     ]

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne/utilitarios/functions/__init__.py

@@ -5,6 +5,8 @@ from .func_converters import convert_bquery_result_to_json
 from .func_settings import get_config
 from .func_get_secret import get_secret
 from .func_datetime import now_sp
+from .func_delete import delete_file, delete_folder
+from .func_validate_json import validate_json
 
 __all__ = [
     "titulo", 
@@ -15,4 +17,7 @@ __all__ = [
     "get_config",
     "get_secret",
     "now_sp",
+    "delete_file",
+    "delete_folder",
+    "validate_json"
     ]

csc_cia_stne-0.1.12/src/csc_cia_stne/utilitarios/functions/func_delete.py

@@ -0,0 +1,96 @@
+import os
+import shutil
+
+
+def delete_file(filename:str) -> bool:
+    """
+    Exclui um arquivo no diretório atual com o nome especificado.
+    Parâmetros:
+        filename (str): O nome do arquivo a ser excluído.
+    Retorna:
+        dict: Um dicionário indicando o sucesso da operação. 
+            - Se bem-sucedido: {"success": True}
+            - Se falhar: {"success": False, "error": <mensagem de erro>}
+                Possíveis mensagens de erro incluem:
+                    - "Permissão negada."
+                    - "Arquivo não encontrado."
+                    - Mensagem de exceção genérica.
+    """
+
+    filepath = os.path.join(os.getcwd(), filename)
+
+    if os.path.exists(filepath):
+
+        try:
+            os.remove(filepath)
+
+            return {
+                "success": True,
+            }
+        
+        except PermissionError as e:
+
+            return {
+                "success": False,
+                "error": "Permissão negada.",
+            }
+
+        except Exception as e:
+
+            return {
+                "success": False,
+                "error": str(e),
+            }
+        
+    else:
+
+        return {
+            "success": False,
+            "error": "Arquivo não encontrado."
+        }
+
+def delete_folder(foldername:str):
+    """
+    Exclui uma pasta especificada pelo nome.
+    Parâmetros:
+        foldername (str): O nome da pasta a ser excluída.
+    Retorna:
+        dict: Um dicionário indicando se a exclusão foi bem-sucedida.
+            - Se bem-sucedido: {"success": True}
+            - Se a pasta não for encontrada: {"success": False, "error": "Pasta não encontrada."}
+            - Se houver permissão negada: {"success": False, "error": "Permissão negada."}
+            - Para outros erros: {"success": False, "error": <mensagem do erro>}
+    """
+
+    filepath = os.path.join(os.getcwd(), foldername)
+
+    if os.path.exists(filepath):
+
+        try:
+
+            shutil.rmtree(filepath)
+
+            return {
+                "success": True
+            }
+
+        except PermissionError as e:
+
+            return {
+                "success": False,
+                "error": "Permissão negada.",
+            }
+
+        except Exception as e:
+
+            return {
+                "success": False,
+                "error": str(e),
+            }
+        
+    else:
+
+        return {
+            "success": False,
+            "error": "Pasta não encontrada."
+        }

csc_cia_stne-0.1.12/src/csc_cia_stne/utilitarios/functions/func_validate_json.py

@@ -0,0 +1,49 @@
+import json
+
+
+def validate_json(token):
+    """
+    Valida e converte uma string JSON em um objeto Python (dict ou list).
+    Parâmetros:
+        token (str, dict ou list): O JSON a ser validado, podendo ser uma string ou já um objeto Python.
+    Retorna:
+        dict: Um dicionário contendo:
+            - "success" (bool): Indica se a validação/conversão foi bem-sucedida.
+            - "data" (dict ou list, opcional): O objeto Python resultante, presente se o sucesso for True.
+            - "error" (Exception, opcional): A exceção capturada, presente se o sucesso for False.
+    Exemplo:
+        >>> validate_json('{"chave": "valor"}')
+        {'success': True, 'data': {'chave': 'valor'}}
+    """
+
+    if not isinstance(token,dict) and not isinstance(token,list):
+
+        try:
+
+            token = json.loads(token)
+
+            return {
+                "success":True,
+                "data":token
+            }
+
+        except json.JSONDecodeError as e:
+
+            return {
+                "success":False,
+                "error":e
+            }
+
+        except Exception as e:
+
+            return {
+                "success":False,
+                "error":e
+            }
+        
+    else:
+
+        return {
+                "success":True,
+                "data":token
+            }

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne/utilitarios/validations/gcp_bucket.py

@@ -1,37 +1,31 @@
-from pydantic import BaseModel, field_validator, model_validator
+from __future__ import annotations
+from pydantic import BaseModel, field_validator, model_validator, ValidationError
+from typing import Optional, Mapping, Any
+
 
 class InitParamsValidator(BaseModel):
     """
-    Classe InitParamsValidator
-    Valida os parâmetros de inicialização para garantir que pelo menos um dos 
-    parâmetros 'creds_dict' ou 'creds_file' seja fornecido.
-    Atributos:
-        creds_dict (dict): Um dicionário contendo as credenciais.
-        creds_file (str): Um caminho para o arquivo contendo as credenciais.
-    Métodos:
-        check_others_input(cls, model):
-            Valida se pelo menos um dos parâmetros 'creds_dict' ou 'creds_file' 
-            foi fornecido. Levanta um ValueError caso ambos estejam ausentes ou 
-            inválidos.
+    Garante que ao menos um entre `creds_dict` e `creds_file` foi informado.
     """
-
-    creds_dict:dict
-    creds_file:str
+    creds_dict: Optional[Mapping[str, Any]] = None
+    creds_file: Optional[str] = None
 
     @model_validator(mode="after")
-    def check_others_input(cls, model):
-        creds_dict = model.creds_dict
-        creds_file = model.creds_file
+    def check_others_input(self):
+        has_dict = isinstance(self.creds_dict, Mapping) and bool(self.creds_dict)
+        has_file = isinstance(self.creds_file, str) and bool(self.creds_file.strip())
+
+        if not (has_dict or has_file):
+            raise ValueError(
+                "Pelo menos um dos parâmetros 'creds_dict' (dict não vazio) "
+                "ou 'creds_file' (caminho/string não vazia) deve ser fornecido."
+            )
+        return self
+
+
 
-        if isinstance(creds_dict, dict):
-            return model
 
-        elif isinstance(creds_file, str) and creds_file.strip():
-            return model
 
-        else:
-            raise ValueError("Pelo menos um dos parâmetros 'creds_dict' ou 'creds_file' deve ser fornecido.")
-        
 class ListFilesValidator(BaseModel):
     """
     Classe ListFilesValidator

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csc_cia_stne
-Version: 0.1.10
+Version: 0.1.12
 Summary: Biblioteca do time CSC-CIA utilizada no desenvolvimento de RPAs
 License: MIT
 Keywords: karavela,csc,cia,stone,rpa,botcity,stne

{csc_cia_stne-0.1.10 → csc_cia_stne-0.1.12}/src/csc_cia_stne.egg-info/SOURCES.txt

@@ -29,10 +29,12 @@ src/csc_cia_stne/utilitarios/functions/__init__.py
 src/csc_cia_stne/utilitarios/functions/func_b64.py
 src/csc_cia_stne/utilitarios/functions/func_converters.py
 src/csc_cia_stne/utilitarios/functions/func_datetime.py
+src/csc_cia_stne/utilitarios/functions/func_delete.py
 src/csc_cia_stne/utilitarios/functions/func_get_secret.py
 src/csc_cia_stne/utilitarios/functions/func_recriar_pastas.py
 src/csc_cia_stne/utilitarios/functions/func_settings.py
 src/csc_cia_stne/utilitarios/functions/func_titulo.py
+src/csc_cia_stne/utilitarios/functions/func_validate_json.py
 src/csc_cia_stne/utilitarios/validations/GcpBigQueryValidator.py
 src/csc_cia_stne/utilitarios/validations/GoogleDriveValidator.py
 src/csc_cia_stne/utilitarios/validations/ServiceNowValidator.py