lbxtoolkit 2.2.6__py3-none-any.whl → 2.2.8__py3-none-any.whl

lbxtoolkit/api_rest.py

@@ -166,6 +166,56 @@ Para uso em APIs com autenticação JWT (JSON Web Token), OAuth, Bearer Token Au
             return Err
         #
         #
+    def auth_token(self): # Autentica e abre sessão na API
+        if self.Credenciais['token']:
+            Token = self.Credenciais['token']
+            self.Headers.update({"UserAuthorization": f"token {Token}"})
+        else:
+            self.logger.critico(f'Falha de requisição api_rest.auth_token: Token não fornecido no dicionário de credenciais! Necessário informar chave da API em dicionário com chave "token" no instanciamento da classe', exit=1)
+                
+        try:          
+            self.Sessao = requests.Session()
+            Auth = self.Sessao.post(self.Url, headers=self.Headers, verify=self.Verify)            
+            
+            if 200 <= Auth.status_code <= 299:
+                self.Sessao.status_code = Auth.status_code
+                return self.Sessao
+            else:
+                self.logger.critico(f"Erro ao autenticar API: {self.Sessao.status_code} - {self.Sessao.text}") 
+                raise Exception
+        except Exception as Err:
+            self.logger.critico(f"Falha ao autenticar API: {Err}. URL: {self.Url}")
+            return Err
+        #
+        #        
+    def url_request(self, metodo, payload=None): #  Efetua chamada diretamente à URL e não a EndPoint específico
+        self.ult_tempo_req = time() 
+        self.Metodo = metodo.lower()
+        self.EndPoint = self.Url        
+        self.Payload = payload
+        MetodosAceitos = ['post', 'get', 'patch', 'put']
+        if not any(element in self.Metodo for element in MetodosAceitos):
+            self.logger.critico(f'Método {self.Metodo} não previsto. Abortando chamada!', exit=1)
+        else:
+            ChamadaApi = f'self.Sessao.{self.Metodo}(self.Url, timeout=self.Timeout, headers=self.Headers, verify=self.Verify)' if self.Payload is None else f'self.Sessao.{self.Metodo}(self.Url, timeout=self.Timeout, headers=self.Headers, verify=self.Verify, data=self.Payload)'
+            self.controla_cadencia()
+            self.TempoUltReq = time()   
+            try: 
+                self.RetEndPoint = eval(ChamadaApi)
+                if self.RetEndPoint.status_code >= 500:
+                    self.logger.critico(f'Erro [{self.RetEndPoint.status_code}] no lado servidor na resposta à requisição')   
+                    raise Exception
+                self.RetEndPoint.Espera = self.Espera ## adiona o tempo de espera ao retorno da API
+                self.RetEndPoint.Intervalo = self.Intervalo ## adiciona o intervalo entre chamada ao retorno da API                                
+                return self.RetEndPoint
+            except requests.exceptions.ReadTimeout as Err:
+                self.logger.critico(f'Excedido tempo limite {self.Timeout} para retorno do endpoint: {Err}\nEndpoint: {self.EndPoint}')            
+                return Err
+            except Exception as Err:
+                self.logger.critico(f'Falha na chamada do endpoint: {Err}\nEndpoint: {self.EndPoint}\nCodigo retorno: {self.RetEndPoint.status_code}\nResposta:{self.RetEndPoint.text}')
+                return self.RetEndPoint
+        #
+        #
     def endpoint_json(self, endpoint, metodo, payload=None): # Interage com End Point
         self.ult_tempo_req = time() 
         self.Metodo = metodo.lower()
@@ -182,7 +232,7 @@ Para uso em APIs com autenticação JWT (JSON Web Token), OAuth, Bearer Token Au
             try: 
                 self.RetEndPoint = eval(ChamadaApi)
                 if self.RetEndPoint.status_code >= 500:
-                    self.logger.critico(f'Erro {self.RetEndPoint.status_code} na chamada do endpoint: {Err}\nEndpoint: {self.EndPoint}\nResposta: {self.RetEndPoint.text}')   
+                    self.logger.critico(f'Erro [{self.RetEndPoint.status_code}] no lado servidor na resposta à requisição')   
                     raise Exception
                 self.RetEndPoint.Espera = self.Espera ## adiona o tempo de espera ao retorno da API
                 self.RetEndPoint.Intervalo = self.Intervalo ## adiciona o intervalo entre chamada ao retorno da API                                
@@ -192,7 +242,7 @@ Para uso em APIs com autenticação JWT (JSON Web Token), OAuth, Bearer Token Au
                 return Err
             except Exception as Err:
                 self.logger.critico(f'Falha na chamada do endpoint: {Err}\nEndpoint: {self.EndPoint}\nCodigo retorno: {self.RetEndPoint.status_code}\nResposta:{self.RetEndPoint.text}')
-                return Err
+                return self.RetEndPoint
         #
         #
     def trata_erro_sienge(CodRet, Retorno):

lbxtoolkit/postgresql.py

@@ -37,7 +37,10 @@ arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
 dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
 ```
 
-1. O método `postgreSQl.db_insert_df()` insere dados a partir de um Dataframe (pandas) em uma tabela do banco com estrutura de colunas equivalente.
+Qualquer argumento da função read_csv do Pandas é aceito na chamada do método.
+
+
+3. O método `postgreSQl.db_insert_df()` insere dados a partir de um Dataframe (pandas) em uma tabela do banco com estrutura de colunas equivalente.
 
 A assinatura da função é `postgreSQL.db_insert_df([conexao], [dataframe_origem], [tabela_destino], Schema=None, Colunas=None, OnConflict=None)`
 
@@ -150,9 +153,12 @@ conexao.close()
             raise
         #
         #
-    def csv_df(self, CsvPath, CsvDelim=';'): # Le arquivo CSV e gera Dataframe do Pandas
+    def csv_df(self, CsvPath, CsvDelim=';', **kwargs): # Le arquivo CSV e gera Dataframe do Pandas
+        """
+        Os parametros de read_csv() do Pandas podem ser passados opcionalmente para a função para ajustar a importação
+        """
         try:
-            DataFrame = pd.read_csv(CsvPath, delimiter=CsvDelim)  # Verifique se o delimitador é ';'
+            DataFrame = pd.read_csv(CsvPath, delimiter=CsvDelim, **kwargs)  # Verifique se o delimitador é ';'
             DataFrame.replace({np.nan: None}, inplace=True)  ## troca 'NaN' por None (null no postgresql)
             return DataFrame
         except Exception as Err:
@@ -202,10 +208,10 @@ conexao.close()
         #
     def db_update(self, Query): # Retorna um cursor à partir de um select
         UpdRows = 0
-        BlackList = ['INSERT ', 'DELETE ', 'SELECT ', 'CREATE ', 'DROP ', 'MERGE ', 'REPLACE ', 'CALL ', 'EXECUTE ']
+        BlackList = ['INSERT ', 'SELECT ', 'CREATE ', 'DROP ', 'MERGE ', 'REPLACE ', 'CALL ', 'EXECUTE ']
         if any(element in Query.upper() for element in BlackList):
             BlackListed = [element for element in BlackList if element in Query.upper()]          
-            self.logger.erro(f'{__name__}: Este método permite apenas updates. A query informada possui as seguintes palavras reservadas não aceitas: {BlackListed} e não foi executada!')
+            self.logger.erro(f'{__name__}: Este método permite apenas updates e deletes. A query informada possui as seguintes palavras reservadas não aceitas: {BlackListed} e não foi executada!')
             return None            
         else:
             try:

{lbxtoolkit-2.2.6.dist-info → lbxtoolkit-2.2.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lbxtoolkit
-Version: 2.2.6
+Version: 2.2.8
 Summary: 
 Author: Cristiano P. Ferrari
 Author-email: cristiano.ferrari@lbx.com.br
@@ -508,7 +508,9 @@ Recursos de interação com o banco de dados relacional PostgreSQL
     dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
     ```
 
-1. O método `postgreSQl.db_insert_df()` insere dados a partir de um Dataframe (pandas) em uma tabela do banco com estrutura de colunas equivalente.
+    Qualquer argumento da função `read_csv()` pode ser repassado na chamada do método.
+
+3. O método `postgreSQl.db_insert_df()` insere dados a partir de um Dataframe (pandas) em uma tabela do banco com estrutura de colunas equivalente.
 
     A assinatura da função é `postgreSQL.db_insert_df([conexao], [dataframe_origem], [tabela_destino], Schema=None, Colunas=None, OnConflict=None)`
 

{lbxtoolkit-2.2.6.dist-info → lbxtoolkit-2.2.8.dist-info}/RECORD

@@ -1,12 +1,12 @@
 lbxtoolkit/__init__.py,sha256=DbLn2XbgrDKcPhk0MR5hmFYVIRTOjyF_HSmKw1JtSOQ,5923
-lbxtoolkit/api_rest.py,sha256=rtdJoTBCSo7X4Q_vS_dWk4HizEm3gVsReHNSFZq_eTU,11624
+lbxtoolkit/api_rest.py,sha256=8OpmCAwCLWIHU2C_caIb8qvu52kav7dKpJP0Ak1zUww,14736
 lbxtoolkit/auth_entra_id.py,sha256=2iE7KpRhdh4u7Y4lem63IUkEPl_GpSLRSw45_Byn1s0,21922
 lbxtoolkit/config_manager.py,sha256=n3pVsxKykiYsgRuJNcNrq-bdEAjDHLmeCySl33DsoNE,1629
 lbxtoolkit/lbx_logger.py,sha256=iInkOlKdUzm-FSJOvcj-8D-uGJlAcNfjqrb0Q0TJ48Y,23433
 lbxtoolkit/misc.py,sha256=RCIsIi1z_QSZW_jMEHYR9QSO0hdppKwV_QnKH7AVg8A,5282
-lbxtoolkit/postgresql.py,sha256=UzjeA675cDG0_reVLUf_2UJm1X_r7wRfAsxAmaYRzhk,10898
+lbxtoolkit/postgresql.py,sha256=OC0Iw9sbEthagcESqotodUGFUD6iIycg16ENnsDS6p4,11155
 lbxtoolkit/service.py,sha256=KnkoybzKuO1t4tWkK8xGBylMnq-MMtwhGndf451M57A,19091
 lbxtoolkit/service_windows.py,sha256=LTqITqOEWVSvp5slHG7NpRZV0-NYqI9tAgMXRvkSibM,15226
-lbxtoolkit-2.2.6.dist-info/METADATA,sha256=iq6JDBnYK0gEMFS-Y_hZU1HXR4SVYwRN7i1CAc_cVrA,46701
-lbxtoolkit-2.2.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-lbxtoolkit-2.2.6.dist-info/RECORD,,
+lbxtoolkit-2.2.8.dist-info/METADATA,sha256=a_f305BcReKYM3N1-wpHcDi2ZQ6wJDkI_m561kqwldE,46792
+lbxtoolkit-2.2.8.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+lbxtoolkit-2.2.8.dist-info/RECORD,,