lbxtoolkit 2.2.9__tar.gz → 2.2.11__tar.gz

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lbxtoolkit
-Version: 2.2.9
+Version: 2.2.11
 Summary: 
 Author: Cristiano P. Ferrari
 Author-email: cristiano.ferrari@lbx.com.br

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/lbxtoolkit/lbx_logger.py

@@ -3,6 +3,7 @@ import sys
 import re 
 import datetime
 import logging
+import traceback
 from pathlib import Path
 
 class lbx_logger: # Classe para gerenciar a saída para log
@@ -75,6 +76,9 @@ Considerando que os parametros são posicionais, caso queira omitir apenas um do
 
 A saída dessa função retorna um objeto, que pode ser salvo em disco ou impresso na tela.
 
+5. O método `.traceback_log`, quando acionado, grava, de maneira incremental, o tracback do último erro no arquivo `traceback.log` no mesmo diretório de log onde o arquivo principal de log está salvo. Se o log não está sendo salvo, a mensagem será exibida na tela.
+
+Os métodos `.erro()` e `.critico()` fazem isso automaticamente por padrão.
 
 5. Exemplos de uso:
 
@@ -168,7 +172,7 @@ for line in filtered_lines:
         
         if log_file_path:
             # Criando um handler para escrever em um arquivo de log
-            file_handler = logging.FileHandler(self.log_file_path)
+            file_handler = logging.FileHandler(self.log_file_path, encoding="utf-8")
             file_handler.setLevel(log_level)  # Sempre registrar tudo no arquivo
             
             # Criando um handler para exibir no console
@@ -187,6 +191,9 @@ for line in filtered_lines:
             # Adicionando os handlers ao logger
             self.logger.addHandler(file_handler)
             self.logger.addHandler(console_handler)
+
+            # Saida para o traceback
+            self.traceback_file = Path(self.log_file_path.parent, 'traceback.log')
         else:
             # Tudo direcionado para o console
             console_handler = logging.StreamHandler()
@@ -245,6 +252,7 @@ for line in filtered_lines:
         #
         #     
     def write(self, message):
+        message=message
         if message.strip():  # Ignorar mensagens vazias
             self.logger.info(message.strip())
         #
@@ -285,6 +293,7 @@ for line in filtered_lines:
         msg = self.msg[:corte] if corte else self.msg
         self.logger.error(msg)
         self.msg = ''
+        self.log_traceback()
         if exit:
             os._exit(exit)
         #
@@ -294,6 +303,7 @@ for line in filtered_lines:
         msg = self.msg[:corte] if corte else self.msg
         self.logger.critical(msg)
         self.msg = ''
+        self.log_traceback()
         if exit:
             os._exit(exit)
         #
@@ -308,7 +318,7 @@ for line in filtered_lines:
             self.logger.removeHandler(handler)
         #
         #
-    def filtra(self, log_file, dh_ini, dh_fim):
+    def filtra(self, log_file, dh_ini, dh_fim, logEncode='ISO-8859-1'):
         # Validar parametros de entrada
         if dh_ini:
             if not isinstance(dh_ini, datetime.datetime):
@@ -364,7 +374,7 @@ for line in filtered_lines:
             return dh_inicio <= timestamp <= dh_fim
 
         # Ler e filtrar o arquivo de log com a codificação ISO-8859-1
-        with open(log_file_path, 'r', encoding='ISO-8859-1') as log_file:
+        with open(log_file_path, 'r', encoding=logEncode) as log_file:
             log_lines = log_file.readlines()
 
         # Variável para armazenar o último timestamp válido
@@ -387,7 +397,16 @@ for line in filtered_lines:
         # Retornar o objeto contendo as linhas filtradas
         return filtered_lines
         #
-        #         
+        #  
+    def log_traceback(self):
+        if self.traceback_file:
+            with open(self.traceback_file, "a", encoding="utf-8") as f:
+                f.write("\n" + "-"*50 + "\n")  # Separador entre erros
+                f.write(f"\n{datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S,%f")[:-3]}")
+                f.write(traceback.format_exc())
+        else:
+            traceback.format_exc()
+        
 class SafeLogger: ## intercepta as entradas de log para parar o daemon/watcher quando parametro EXIT existir
     """
     Essa classe tem o propoósito de interceptar as ordens de saída (exit) disparadas pelos métodos do lbx_logger e interromper um daemon/serviço que esteja em execução antes.

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/lbxtoolkit/misc.py

@@ -44,14 +44,23 @@ Sintaxe e exemplos de uso. Parametros omissos assume-se os valores padrão indic
         return Diretorio
         #
         #
-    def normaliza(Original): # Limpa e padroniza nomes
-        Lixo = r'/\\?%§ªº°`´^~*:|"<>!@#$%¨&*()_+=-[]{}"\' ' 
-        Normalizar = normalize('NFKD', Original).encode('ASCII', 'ignore').decode('ASCII')
+    def normaliza(Original, Case='keep', KeepSpaces=False, KeepDelim=False, KeepDirTree=False): # Limpa e padroniza nomes
+        
+        Lixo = r'?%§ªº°`´^~*|"<>!@#$%¨&*_+=-"\''
+        Lixo = Lixo + r' ' if not KeepSpaces else Lixo
+        Lixo = Lixo + r'(){}[]' if not KeepDelim else Lixo
+        Lixo = Lixo + r':/\\' if not KeepDirTree else Lixo
+
+        if Case and not Case.lower() in ['upper', 'lower', 'keep']:
+            raise ValueError('Parametro opcioanl "Case" deve ser ["upper", "lower", "keep"]. Se omisso (None), string será convertida para caixa baixa.')
+        
+        Normalizar = (''.join(c for c in normalize('NFKD', Original) if c.encode('ascii', 'ignore').decode('ascii'))) if Case.lower() == 'keep' else normalize('NFKD', Original).encode('ASCII', 'ignore').decode('ASCII') 
         RemoverLixo = [c if c not in Lixo else '_' for c in Normalizar]    
         Limpo = "".join(RemoverLixo)
         Limpo = re.sub(r'\.(?=.*\.)', '_', Limpo) # troca todos os pontos por underline
         Limpo = re.sub(r'_+', '_', Limpo)  # limpa as reptições do underline
-        return Limpo.lower()
+        Limpo = Limpo.lower() if not Case or Case.lower() == 'lower' else Limpo.upper() if Case.lower() == 'upper' else Limpo
+        return Limpo
         #
         #
     def get_cmd_window(): # Captura a referencia da janela atual para retornar o foco à ela depois de chamar os pickers

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/lbxtoolkit/postgresql.py

@@ -4,6 +4,9 @@ import psycopg2
 from psycopg2.extras import execute_values
 import pandas as pd
 import numpy as np
+from io import StringIO
+import json
+from pathlib import Path
 
 class postgreSQL: # Classe de acesso e interação com banco PostgreSQL
     """
@@ -153,11 +156,13 @@ conexao.close()
             raise
         #
         #
-    def csv_df(self, CsvPath, CsvDelim=';', **kwargs): # Le arquivo CSV e gera Dataframe do Pandas
+    def csv_df(self, Csv, CsvDelim=';', **kwargs): # Le arquivo CSV e gera Dataframe do Pandas
         """
+        Parametro 'Csv' pode ser um caminho do pathlib [Path()] ou uma string com o conteúdo do CSV.
         Os parametros de read_csv() do Pandas podem ser passados opcionalmente para a função para ajustar a importação
         """
         try:
+            CsvPath = Csv if isinstance(Csv,Path) else StringIO(Csv)
             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
@@ -165,25 +170,75 @@ conexao.close()
             raise
         #
         #
-    def db_insert_df(self, DataFrame, Tabela, Schema=None, Colunas=None, OnConflict=None): # Insere os dados de um dataframe em uma tabela equivalente no banco (exige mesma estrutura de colunas)
+    def db_insert_df(self, DataFrame, Tabela, Schema=None, Colunas=None, OnConflict=None, TypeCast=None, Returning=None): # Insere os dados de um dataframe em uma tabela equivalente no banco (exige mesma estrutura de colunas)   
+        """
+        Insere um DataFrame no PostgreSQL usando psycopg2 e execute_values().
+        
+        Parâmetros:
+        - DataFrame: O DataFrame do pandas contendo os dados.
+        - Tabela: Nome da tabela no PostgreSQL.
+        - Schema: (Opcional) Schema da tabela (padrão: 'public').
+        - Colunas: (Opcional) Lista de colunas para inserir (padrão: todas as colunas do DataFrame).
+        - OnConflict: (Opcional) Cláusula ON CONFLICT para tratamento de duplicatas.
+        - TypeCast: (Opcional) Dicionário mapeando colunas para seus respectivos tipos de dado no PostgreSQL.
+        """        
         # Essa função exige que os nomes dos cabeçalhos das colunas do CSV sejam os mesmos das colunas da tabela de destino
-        Colunas = Colunas or DataFrame.columns.tolist()     # Caso não seja fornecida a lista de colunas, assume as colunas do DataFrame
-        Valores = [tuple(Linha) for Linha in DataFrame[Colunas].values]    
+        Colunas = Colunas or DataFrame.columns.tolist()
         Schema = Schema or 'public'
-        Query = f'insert into {Schema}.{Tabela} ({', '.join(Colunas)}) values %s '
-        if not OnConflict is None:
-            Query = Query + OnConflict
+        TypeCast = TypeCast or {}
+
+        Valores = []
+
+        for _, Linha in DataFrame.iterrows():
+                Linha_convertida = []
+                for coluna in Colunas:
+                    valor = Linha[coluna]
+
+                    # 🔹 Converte Timestamp para string ISO 8601
+                    if isinstance(valor, pd.Timestamp):
+                        valor = valor.strftime('%Y-%m-%d %H:%M:%S')
+
+                    # 🔹 Converte JSON para string válida
+                    if coluna in TypeCast and TypeCast[coluna] == "jsonb":
+                        if isinstance(valor, str):
+                            try:
+                                json.loads(valor)  # Valida se já é um JSON válido
+                            except json.JSONDecodeError:
+                                valor = json.dumps(valor)  # Serializa para JSON
+                        else:
+                            valor = json.dumps(valor)  # Converte para JSON corretamente
+
+                    Linha_convertida.append(valor)
+
+                Valores.append(tuple(Linha_convertida))  # Garante que cada linha seja uma tupla
+
+        Retorno = None
+
+        Retornar = f"RETURNING {', '.join(Returning)}" if Returning else ''
+        Conflito = OnConflict if OnConflict else ''
+
+        Parametros = ", ".join(["%s"] * len(Colunas))
+        Query = f'INSERT INTO {Schema}.{Tabela} ({", ".join(Colunas)}) VALUES ({Parametros}) {Conflito} {Retornar}'
 
         try:
-            self.Cursor = self.Conexao.cursor() 
-            execute_values(self.Cursor, Query, Valores)  
-            self.Conexao.commit()
+            self.Cursor = self.Conexao.cursor()
+
+            if Returning:
+                Retorno = []
+                for valor in Valores:
+                    self.Cursor.execute(Query, valor)
+                    Retorno.append(self.Cursor.fetchone())
+            else:
+                self.Cursor.executemany(Query, Valores)
+
+            self.Conexao.commit()        
         except Exception as Err:
+            self.logger.erro(f'{__name__}: Erro [{Err}] ao inserir dados na tabela {Schema}.{Tabela}!')    
             self.Conexao.rollback()
-            raise
         finally:        
             self.Cursor.close()
             #Conexao.close() ## conexão precisa ser fechada explicitamente fora da classe
+        return Retorno if Retorno else None
         #
         #
     def db_select(self, Query): # Retorna um cursor à partir de um select

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/lbxtoolkit/service_windows.py

@@ -195,6 +195,46 @@ Gerencia a instalação e execução de um daemon como um serviço do windows. T
         self.RunAsDaemon()              
         servicemanager.LogMsg(servicemanager.EVENTLOG_INFORMATION_TYPE, 
                               servicemanager.PYS_SERVICE_STARTED, (self._svc_name_, ''))  
+        
+
+    @staticmethod
+    def SvcStatus(ServiceName=None):  # Verifica o status de um serviço específico ou do próprio serviço
+        """
+        Retorna o status do serviço do Windows.
+        Se um nome for passado como parâmetro, verifica o status do serviço informado.
+        Caso contrário, retorna o status do próprio serviço.
+        """
+        try:
+            # Recuperar nome do serviço, se não for passado
+            if not ServiceName:
+                config = ConfigManager.get('config')
+                if not config or 'name' not in config:
+                    raise ValueError("Configuração do serviço inválida. O nome do serviço não pode ser determinado.")
+                ServiceName = config['name']
+
+            # Executa o comando SC QUERY para verificar o status
+            resultado = subprocess.run(["sc", "query", ServiceName], capture_output=True, text=True)
+            saida = resultado.stdout
+
+            # Buscar o status na saída do comando
+            if "RUNNING" in saida:
+                return "RUNNING"
+            elif "STOPPED" in saida:
+                return "STOPPED"
+            elif "PAUSED" in saida:
+                return "PAUSED"
+            elif "START_PENDING" in saida:
+                return "START_PENDING"
+            elif "STOP_PENDING" in saida:
+                return "STOP_PENDING"
+            else:
+                return f"UNKNOWN STATUS: {saida.strip()}"
+        
+        except Exception as Err:
+            log = ConfigManager.get('log')
+            if log:
+                log.erro(f"Erro ao obter status do serviço [{ServiceName}]: {Err}")
+            return f"ERROR: {Err}"
         #
         #
     @staticmethod 

{lbxtoolkit-2.2.9 → lbxtoolkit-2.2.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "lbxtoolkit"
-version = "2.2.9"
+version = "2.2.11"
 description = ""
 authors = ["Cristiano P. Ferrari <cristiano.ferrari@lbx.com.br>"]
 readme = "README.md"