lbxtoolkit 2.2.2__py3-none-any.whl → 2.2.3__py3-none-any.whl

lbxtoolkit/config_manager.py

@@ -1,6 +1,6 @@
 class ConfigManager: # Inicializa e recupera variáveis em ambiente de intercâmbio entre classes
     """
-#### Classe **auth_EntraID**
+#### Classe **ConfigManager**
 
 É um singleton que garante que todas as partes do código usem a mesma instância e, portanto, compartilhem a mesma configuração.
 

lbxtoolkit/service.py

@@ -145,7 +145,7 @@ class ServicerConfig(Servicer):
     if __name__ == "__main__":
 
         Daemon.main()            
-````            
+```         
     """
     def __init__(self, Log=None, piddir=None):#TODO: ao criar uma classe padrão usar args/kwargs para lidar como parametros variáveis no instanciamento
         # PRE-REQUISITOS/DEPENDÊNCIAS: 

lbxtoolkit/service_windows.py

@@ -18,10 +18,10 @@ class ServicoWindows(win32serviceutil.ServiceFramework): # Gerencia a execução
 
 Gerencia a instalação e execução de um daemon como um serviço do windows. Também assume o controle dos argumentos recebidos via linha de comando.
 
-    - `SvcInstall`: Cria um serviço do windows com base neste script
-    - `SvcRemove`: Remove o serviço do windows configurado à partir de `SvcInstall`
-    - `SvcStop`: Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado automaticamente pela chamada do service manager do windows)
-    - `SvcDoRun`: Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado autoamticamente pela chamada do service manager do windwos)
+- `SvcInstall`: Cria um serviço do windows com base neste script
+- `SvcRemove`: Remove o serviço do windows configurado à partir de `SvcInstall`
+- `SvcStop`: Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado automaticamente pela chamada do service manager do windows)
+- `SvcDoRun`: Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado autoamticamente pela chamada do service manager do windwos)
     """
     _svc_name_ = None
     _svc_display_name_ = None

{lbxtoolkit-2.2.2.dist-info → lbxtoolkit-2.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lbxtoolkit
-Version: 2.2.2
+Version: 2.2.3
 Summary: 
 Author: Cristiano P. Ferrari
 Author-email: cristiano.ferrari@lbx.com.br
@@ -43,66 +43,66 @@ print(help)
 
 **auth_EntraID**
 Usa o Microsoft Entra ID (antiga Azure AD) para evitar execução não autorizada de scripts 
-    - `disclaimer` : Mensagem sobre a necessidade de autenticação
-    - `valida_grupo` : Autentica o usuário e aborta se checa não pertencer ao grupo de segurança
+- `disclaimer` : Mensagem sobre a necessidade de autenticação
+- `valida_grupo` : Autentica o usuário e aborta se checa não pertencer ao grupo de segurança
 
 
 **postgreSQL**
 Interage com o banco de dados PostgreSQL
-    - `db` Inicia sessão com o banco
-    - `csv_df` Lê arquivo CSV e gera Dataframe (pandas) a partir dele
-    - `db_insert_df` Insere informações de Dataframe em tabela do banco com estrutura equivalente
-    - `db_select` Retorna um cursor a partir de uma query
-    - `db_update` Executa update em tabelas
+- `db` Inicia sessão com o banco
+- `csv_df` Lê arquivo CSV e gera Dataframe (pandas) a partir dele
+- `db_insert_df` Insere informações de Dataframe em tabela do banco com estrutura equivalente
+- `db_select` Retorna um cursor a partir de uma query
+- `db_update` Executa update em tabelas
 
 
 **api_rest**
 Interage com APIs RESTfull, especialmente providas para a plataforma Sienge
-    - `auth_base` Autentica (HTTPBasicAuth) sessão na API
-    - `auth_bearer` Autentica sessão na API pelos métodos: OAuth, JWT, Bearer 
-    - `endpoint_json` Realizad chama ao endpoint. Payload em formato `json` opcional.
-    - `trata_erro_sienge` Retorna a mensagem de erro do Sienge caso código de retorno seja diferente de 200.
-    - `close` Encerra a sessão autenticada
+- `auth_base` Autentica (HTTPBasicAuth) sessão na API
+- `auth_bearer` Autentica sessão na API pelos métodos: OAuth, JWT, Bearer 
+- `endpoint_json` Realizad chama ao endpoint. Payload em formato `json` opcional.
+- `trata_erro_sienge` Retorna a mensagem de erro do Sienge caso código de retorno seja diferente de 200.
+- `close` Encerra a sessão autenticada
 
 **lbx_logger**
 Manipula e formata as mensagens de saída do script para direcioná-las para tela (stdout) e/ou arquivo de log
-    - `add` Adiciona a mensagem a um _buffer_ sem exibir, acumulando até a próxima chamada em algum dos níveis abaixo.
-    - `print` Contorna o manipulador de log e imprime diretamente na tela (stdout), sem formatar a mensagem nem registrar no arquivo
-    - `debug, .info, .aviso, .erro, .critico` Classifica as mensagens por nível de severidade/relevância e rediciona a saída (arquivo, tela, tela+arquivo) conforme a configuração do nível
-    - `stop_logging` Interrompe a manipulação das saídas pelo logger e restaura as saídas padrão (stdout/stderr) para a tela 
-    - `filtra` Filtra os eventos do arquivo de log registrados em um intervalo de tempo específico
+- `add` Adiciona a mensagem a um _buffer_ sem exibir, acumulando até a próxima chamada em algum dos níveis abaixo.
+- `print` Contorna o manipulador de log e imprime diretamente na tela (stdout), sem formatar a mensagem nem registrar no arquivo
+- `debug, .info, .aviso, .erro, .critico` Classifica as mensagens por nível de severidade/relevância e rediciona a saída (arquivo, tela, tela+arquivo) conforme a configuração do nível
+- `stop_logging` Interrompe a manipulação das saídas pelo logger e restaura as saídas padrão (stdout/stderr) para a tela 
+- `filtra` Filtra os eventos do arquivo de log registrados em um intervalo de tempo específico
 
 **SafeLogger**
 Intercepta as ordens de saída comandadas pelos métodos de lbx_logger e interrompe um daemon em execução antes de saír
 
 **ConfigManager**
 Permite a inicialização/instanciamento e o consumo de objetos entre classes e métodos independentes, inclusive métodos estáticos (sem instanciamento da classe), garantindo que todas as partes do código usem a mesma instância e, portanto, compartilhem a mesma configuração.
-    - `initialize` Inicialização com Argumentos Dinâmicos: O método initialize usa **kwargs para aceitar qualquer número de pares chave-valor, armazenando-os no dicionário da instância.
-    - `get` O método get aceita uma chave como argumento e retorna o valor correspondente do dicionário _config.
-    - `set` O método set permite adicionar ou atualizar dinamicamente valores no dicionário _config.
-    - `reset` O método reset limpa todas as configurações armazenadas, permitindo uma nova inicialização do ConfigManager com novos valores 
+- `initialize` Inicialização com Argumentos Dinâmicos: O método initialize usa **kwargs para aceitar qualquer número de pares chave-valor, armazenando-os no dicionário da instância.
+- `get` O método get aceita uma chave como argumento e retorna o valor correspondente do dicionário _config.
+- `set` O método set permite adicionar ou atualizar dinamicamente valores no dicionário _config.
+- `reset` O método reset limpa todas as configurações armazenadas, permitindo uma nova inicialização do ConfigManager com novos valores 
 
 **ServicoWindows**
 Gerencia a instalação e execução de um daemon como um serviço do windows. Também assum o controle dos argumentos recebidos via linha de comando.
-    - `SvcInstall` Cria um serviço do windows com base neste script
-    - `SvcRemove` Remove o serviço do windows configurado à partir de `SvcInstall`
-    - `SvcStop` Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_)
-    - `SvcDoRun` Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_)
+- `SvcInstall` Cria um serviço do windows com base neste script
+- `SvcRemove` Remove o serviço do windows configurado à partir de `SvcInstall`
+- `SvcStop` Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_)
+- `SvcDoRun` Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_)
 
 **Servicer**
 Classe base com a esrtutura padrão para a criação dameons/serviços do windows.
-    - `run`, `stop` Usados para iniciar (`run`) e parar (`stop`) a execução do daemon/serviço. 
-    - `main` deve ser chamada para controlar a sua chamada inicial do script, tratando os argumentos da linha de comando
-    - `on_run` é o método que efetivamente executa o propósito do script quando o método pai `run` é executado
-    - `args_parser` é o método que define o comportamento do script quando o método `main` é executado (**`argpaser`**)
+- `run`, `stop` Usados para iniciar (`run`) e parar (`stop`) a execução do daemon/serviço. 
+- `main` deve ser chamada para controlar a sua chamada inicial do script, tratando os argumentos da linha de comando
+- `on_run` é o método que efetivamente executa o propósito do script quando o método pai `run` é executado
+- `args_parser` é o método que define o comportamento do script quando o método `main` é executado (**`argpaser`**)
 
 **misc**
 Classe de miscelâneas/diversos
-    - `seleciona_arquivo` Abre um picker do sistema operacionar para selecionar um *arquivo* e retorna seu path
-    - `seleciona_dir` Abre um picker do sistema operacionar para selecionar um *diretório* e retorna seu path
-    - `normaliza` Limpa caracteres especiais e espaços de strings e retorna tudo em minúsculo
-    - `get_cmd_window` Captura a referencia da janela atual (cmd.exe) para retornar o foco à ela depois de chamar os pickers 
-    - `maximize_console` Maxima a janela do console (cmd.exe)
+- `seleciona_arquivo` Abre um picker do sistema operacionar para selecionar um *arquivo* e retorna seu path
+- `seleciona_dir` Abre um picker do sistema operacionar para selecionar um *diretório* e retorna seu path
+- `normaliza` Limpa caracteres especiais e espaços de strings e retorna tudo em minúsculo
+- `get_cmd_window` Captura a referencia da janela atual (cmd.exe) para retornar o foco à ela depois de chamar os pickers 
+- `maximize_console` Maxima a janela do console (cmd.exe)
 
 ## Instalação e uso:
 
@@ -194,7 +194,7 @@ Payload = {
             }
 EndPoint = f'{UrlBase}/bills/{Nutitulo}/installments/{Nuparcela}'
 
-`chama` o endpoint e recebe o retorno no objeto AlteraVcto
+#chama o endpoint e recebe o retorno no objeto AlteraVcto
 AlteraVcto = ApiSienge.endpoint_json(EndPoint, 'patch', Payload)
 ```
 
@@ -222,8 +222,8 @@ Este recurso tem o propósito de controlar as permissões de execução do scrip
 
 Essa classe possui apenas dois métodos:
 
-    - `auth_EntraID.disclaimer()`: apenas exibe uma tela de informações/instruções ao usuário.
-    - `auth_EntraID.valida_grupo([client_id], [client_secret], [tenant_id], timeout=60, log_file='auth_EntraID.log')`: efetua a autenticação do usuário e verifica se ele pertence ao grupo informado,  abortando a execução caso não pertença ao grupo ou a autenticação não seja validada no tempo estabelecido. Os argumentos `timeout` e `log_file` são opcionais e, se omitidos, os valores aqui atribuídos serão adotados como padrão.
+- `auth_EntraID.disclaimer()`: apenas exibe uma tela de informações/instruções ao usuário.
+- `auth_EntraID.valida_grupo([client_id], [client_secret], [tenant_id], timeout=60, log_file='auth_EntraID.log')`: efetua a autenticação do usuário e verifica se ele pertence ao grupo informado,  abortando a execução caso não pertença ao grupo ou a autenticação não seja validada no tempo estabelecido. Os argumentos `timeout` e `log_file` são opcionais e, se omitidos, os valores aqui atribuídos serão adotados como padrão.
 
 É necessário obter parametros da plataforma de identidade da Microsoft (AD Azure, agora Microsoft Entra ID), no [*Centro de administração do Microsoft Entra*](https://entra.microsoft.com).
 Sugerimos não armazenar estas ou outras informações sensíveis no script. Considere usar o pacote `dotenv` para isso.
@@ -252,7 +252,7 @@ auth.disclaimer()
 
 auth.valida_grupo('Nome do Grupo de Distribuição') 
 # se usuário não pertencer a grupo informado, a execução do script é abortada.
-    ```
+```
 
 <a id="lbxtoolkit.config_manager"></a>
 
@@ -266,7 +266,7 @@ auth.valida_grupo('Nome do Grupo de Distribuição')
 class ConfigManager()
 ```
 
-#### Classe **auth_EntraID**
+#### Classe **ConfigManager**
 
 É um singleton que garante que todas as partes do código usem a mesma instância e, portanto, compartilhem a mesma configuração.
 
@@ -307,35 +307,35 @@ Todos os parametros são nominativos e facultativos. Em caso de omissão, os val
 
 Os parametros para o instanciamento da classe são:
 
-    - `log_file_path`: Define o caminho e o nome do arquivo de log. Se omisso, as mensagens serão todas direcionadas apenas para a tela.
-    - `log_level`: Define o nível mínimo de severidade das mensagens a serem manipuladas pelo logger. Se omisso, será assumido o nível mais baixo (_debug_). As mensagens com nível abaixo do especificado são descartadas. Os níveis devem ser informados de acordo com a sintaxe acima (prefixados com _logging._ e com o nome do nível em inglês e maiúsculas). Exemplo: 
-    - `logging.DEBUG`: para manipular chamadas do método *.debug()* e acima.
-    - `logging.INFO`: para manipular chamadas do método *.info()* e acima.
-    - `logging.WARNING`: para manipular chamadas do método *.aviso()* e acima.
-    - `logging.ERROR`: para manipular chamadas do método *.erro()* e acima.
-    - `logging.CRITICAL`: para manipular chamadas do método *.critico()* e acima.        
-    - `formato_log`: Define o formato em que a mensagem será apresentada. Se omisso, o padrá é *DATA_HORA - NIVEL - MENSAGEM*. Para maiores opções veja: [Atributos de log](https://docs.python.org/3/library/logging.html#logrecord-attributes)
-    - `modulo`: Nome do módulo para o qual os logs serão monitorados. Permite instanciar várias vezes a classe para criar manipuladores diferentes para módulos diferente. Informe o nome do módulo para criar um log específico para ele ou simplesmente omita o parametro para criar um log para o script em geral.
-    - `ignore_console`: Lista com os níveis de severidade a serem ignorados para *apresentação na tela*, registrando *apenas no arquivo* (quando informado no parametro `log_file_path`) e obedecendo ao nível mínimo estabelecido no parametro `log_level`. Note que omitir o parametro `log_file_path` e incluir um nível na lsita `ignore_console` implica em ignorar/suprimir esse nível de mensagem de qualquer apresentação.
-    - `ignore_file`: Mesma lógica do parametro `ignore_console`, mas com lógica invertida: suprime o registro do nível do arquivo e demonstra *apenas na tela*.
+- `log_file_path`: Define o caminho e o nome do arquivo de log. Se omisso, as mensagens serão todas direcionadas apenas para a tela.
+- `log_level`: Define o nível mínimo de severidade das mensagens a serem manipuladas pelo logger. Se omisso, será assumido o nível mais baixo (_debug_). As mensagens com nível abaixo do especificado são descartadas. Os níveis devem ser informados de acordo com a sintaxe acima (prefixados com _logging._ e com o nome do nível em inglês e maiúsculas). Exemplo: 
+- `logging.DEBUG`: para manipular chamadas do método *.debug()* e acima.
+- `logging.INFO`: para manipular chamadas do método *.info()* e acima.
+- `logging.WARNING`: para manipular chamadas do método *.aviso()* e acima.
+- `logging.ERROR`: para manipular chamadas do método *.erro()* e acima.
+- `logging.CRITICAL`: para manipular chamadas do método *.critico()* e acima.        
+- `formato_log`: Define o formato em que a mensagem será apresentada. Se omisso, o padrá é *DATA_HORA - NIVEL - MENSAGEM*. Para maiores opções veja: [Atributos de log](https://docs.python.org/3/library/logging.html#logrecord-attributes)
+- `modulo`: Nome do módulo para o qual os logs serão monitorados. Permite instanciar várias vezes a classe para criar manipuladores diferentes para módulos diferente. Informe o nome do módulo para criar um log específico para ele ou simplesmente omita o parametro para criar um log para o script em geral.
+- `ignore_console`: Lista com os níveis de severidade a serem ignorados para *apresentação na tela*, registrando *apenas no arquivo* (quando informado no parametro `log_file_path`) e obedecendo ao nível mínimo estabelecido no parametro `log_level`. Note que omitir o parametro `log_file_path` e incluir um nível na lsita `ignore_console` implica em ignorar/suprimir esse nível de mensagem de qualquer apresentação.
+- `ignore_file`: Mesma lógica do parametro `ignore_console`, mas com lógica invertida: suprime o registro do nível do arquivo e demonstra *apenas na tela*.
 
 1. As mensagem são manipuladas substituindo-se o comando `print()` pela chamada a um dos 5 métodos acima (_.add(), .debug(), .info(), .aviso(), .erro(), .critico()_). Exceto o método `.add()`, qualquer um dos demais métodos pode interromper a execução do script, através da passagem do parâmetro `exit`. Ao informar esse parametro na chamadada do método, atribua a ele o código de saída desejado (0 para normal, qualquer outro número para saída com erro). Exemplo:
 
-```python
-log.erro('Essa mensagem apenas resulta em uma mensagem de nível ERROR')
-log.erro('Essa mensagem resulta em uma mensagem de nível ERRO e encerra o script com código de retorno -1', exit=-1)
-```
+    ```python
+    log.erro('Essa mensagem apenas resulta em uma mensagem de nível ERROR')
+    log.erro('Essa mensagem resulta em uma mensagem de nível ERRO e encerra o script com código de retorno -1', exit=-1)
+    ```
 
 Qualquer chamada ao comando `print()`, uma vez instanciado manipulador de log, será registada como uma chamada ao método _.info()_ e registrada com este nível de severidade. 
 Para retornar ao comportamente padrão do comando print, ou interromper o manipulador, faça chamada ao método `.stop_logging()`
 
 2. O método _.add()_ não exibe/grava imediatamente a mensagem, mas apenas a diciona a _buffer_. Todas as chamas a _.add()_ irão concatenar a mensagem recebida até a próxima chamada em algum dos níveis _.debug(), .info(), .aviso(), .erro(), .critico()_. Na primeira chama de um destes níveis após uma (ou mais) chamada(s) ao método _.add()_ o *buffer* será concatenado à mensagem recebida por um destes métodos e o resultado será manipulado pelo log conforme os parametros definidos no intanciamento da classe e o método chamado. Essa função é útil para tratar mensagens com retorno condicional. Exemplo:
 
-```python
-log.add('Mensagem 1# ') ## não será exibida/registrada
-log.add('Mensagem 2# ') ## não será exibida/registrada
-log.info('Mensagem 3) ## será exibida/registrada como nível "info" e com texto: "Mensagem 1# Mensagem 2# Mensagem 3"
-```
+    ```python
+    log.add('Mensagem 1# ') ## não será exibida/registrada
+    log.add('Mensagem 2# ') ## não será exibida/registrada
+    log.info('Mensagem 3) ## será exibida/registrada como nível "info" e com texto: "Mensagem 1# Mensagem 2# Mensagem 3"
+    ```
 
 3. Os métodos que exibem as mensagens (`.debug()`,`.info()`,`.aviso()`, `.erro()`, `.critico()`) possuem 3 parametros: `message`, `corte=None`, `exit=None`.
 
@@ -345,88 +345,88 @@ log.info('Mensagem 3) ## será exibida/registrada como nível "info" e com texto
 
 4. O método `.filtra()` possui 3 parametros posicionais, todos opcionais: `log_file`, `dh_ini`, `dh_fim`.
 
-Se os 3 forem omitidos, serão exibidas as entradas de log do arquivo corrente, definido no instanciamento da classe `lbx_logger`, registradas na última hora. Deste modo, o valor padrão para `dh_fim` é `now()`  e para `dh_ini` é `now()` menos 1 hora.
+    Se os 3 forem omitidos, serão exibidas as entradas de log do arquivo corrente, definido no instanciamento da classe `lbx_logger`, registradas na última hora. Deste modo, o valor padrão para `dh_fim` é `now()`  e para `dh_ini` é `now()` menos 1 hora.
 
-Caso queira filtrar os registro de outro arquivo de log, que não seja o do script corrente, informe o endereço do arquivo no primeiro parametro.
+    Caso queira filtrar os registro de outro arquivo de log, que não seja o do script corrente, informe o endereço do arquivo no primeiro parametro.
 
-E caso queira alterar alterar o período de filtragem, informe nos parametros 2 e 3 a data/hora de início e fim do período. Estes dois parametros aceitam tanto um objeto do tipo `datetime` como uma string (que será convertida para datetime), desde que ela esteja no formato `dd/mm/aaaa hh:mm:[ss]` (segundos são opcionais).
+    E caso queira alterar alterar o período de filtragem, informe nos parametros 2 e 3 a data/hora de início e fim do período. Estes dois parametros aceitam tanto um objeto do tipo `datetime` como uma string (que será convertida para datetime), desde que ela esteja no formato `dd/mm/aaaa hh:mm:[ss]` (segundos são opcionais).
 
-Considerando que os parametros são posicionais, caso queira omitir apenas um dos parametros, preencha a posição do parametro a ser omitido com `None`.
+    Considerando que os parametros são posicionais, caso queira omitir apenas um dos parametros, preencha a posição do parametro a ser omitido com `None`.
 
-A saída dessa função retorna um objeto, que pode ser salvo em disco ou impresso na tela.
+    A saída dessa função retorna um objeto, que pode ser salvo em disco ou impresso na tela.
 
 
 5. Exemplos de uso:
 
-```python
-from lbx_toolkit import lbx_logger 
-import logging
-import os
-from pathlib import Path
-
-DirBase = Path('./')  # diretório corrente do script
-BaseName = os.path.splitext(os.path.basename(__file__))[0] # nome do script sem extensão
-LogFile = Path(DirBase, BaseName + '.log') # salva logs no diretório corrente, em um arquivo nomeado com nome do script + extensão ".log"
-
-### instancia o manipulador para tratar todas as mensagens (nível DEBUG acima), 
-#   mas suprime a apresentação em tela das mensagens de nível "DEBUG" na tela, 
-#   apenas registrando-as somente no arquivo
-#   e sumprime o registro no arquivo das mensagens de nível "ERROR", 
-#   mostrando-as apenas na tela
-log = lbx_logger(LogFile, logging.DEBUG, ignore_console=[logging.DEBUG], ignore_file=[logging.ERROR]) 
-
-# Exemplo de mensagens de log
-log.debug('Esta é uma mensagem de debug') 
-log.info('Esta é uma mensagem informativa')
-log.add('Esta mensagem não será exibida agora, mas acumulada no buffer# ')
-log.aviso('Esta é uma mensagem de aviso')
-log.erro('Esta é uma mensagem de erro')
-log.erro('Esta é uma mensagem erro muito comprida e será limitada a 40 caracteres, o restante será cortado e ingorado ao ser manipulado', 40)
-log.critico('Esta é uma mensagem crítica')
-
-# Exemplo de função que gera uma exceção
-def funcao_com_erro():
-    raise ValueError('Este é um erro de exemplo')
-
-# Testando redirecionamento de print e captura de exceção
-print('Mensagem de teste via print')
-try:
-    funcao_com_erro()
-except Exception as e:
-    print(f'Capturado um erro: {e}')
-
-log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit=1)
-
-log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
-
-# obtem os registros de log da última hora (comportamento padrão)
-filtra_log = log.search() 
-
-# obtem os registros das últimas 6 horas
-ultimas_6h = datetime.datetime.now() - datetime.timedelta(hours=6) ## carimbo de tempo de 6 horas atrás !!! requer import datetime
-filtra_log = log.search(None, ultimas_6h) # None no 1º parametro impõe o log do arquivo corrente como padrão (definido em 'LogFile' e apontado no instanciamento da classe)
-
-# obtem os registros do dia 14/01/2020 até 3h atrás
-ultimas_3h = datetime.datetime.now() - datetime.timedelta(hours=3) ## carimbo de tempo de 6 horas atrás !!! requer import datetime
-filtra_log = log.search(None, '14/01/2020 00:00', ultimas_3h) # 
-
-# obtem os registros do horário comercial do dia 23/12/2023 do arquivo salvo em C:\temp\outro_arquivo.log
-Outro_Log = Path(r'c:\temp\outro_arquivo.log')
-filtra_log = log.search(Outro_Log, '23/12/2023 08:00', '23/12/2023 18:00') # 
-
-# salva conteúdo filtrado em um arquivo:
-filtrado = 'filtered_log.txt'
-with open(filtado, 'w', encoding='ISO-8859-1') as output_file:  # indique o enconding conforme salvo (UTF-8 ou ISO-8859-1)
-    output_file.writelines(filta_log)    
-
-# mostra o conteúdo filtrado na tela
-print(''.join(filtra_log))
-
-# mostra o conteúdo filtrado na tela, listando apenas as os registros do nível "DEBUG"
-for line in filtered_lines:
-    if "DEBUG" in line:
-        print(line, end='')
-```
+    ```python
+    from lbx_toolkit import lbx_logger 
+    import logging
+    import os
+    from pathlib import Path
+
+    DirBase = Path('./')  # diretório corrente do script
+    BaseName = os.path.splitext(os.path.basename(__file__))[0] # nome do script sem extensão
+    LogFile = Path(DirBase, BaseName + '.log') # salva logs no diretório corrente, em um arquivo nomeado com nome do script + extensão ".log"
+
+    ### instancia o manipulador para tratar todas as mensagens (nível DEBUG acima), 
+    #   mas suprime a apresentação em tela das mensagens de nível "DEBUG" na tela, 
+    #   apenas registrando-as somente no arquivo
+    #   e sumprime o registro no arquivo das mensagens de nível "ERROR", 
+    #   mostrando-as apenas na tela
+    log = lbx_logger(LogFile, logging.DEBUG, ignore_console=[logging.DEBUG], ignore_file=[logging.ERROR]) 
+
+    # Exemplo de mensagens de log
+    log.debug('Esta é uma mensagem de debug') 
+    log.info('Esta é uma mensagem informativa')
+    log.add('Esta mensagem não será exibida agora, mas acumulada no buffer# ')
+    log.aviso('Esta é uma mensagem de aviso')
+    log.erro('Esta é uma mensagem de erro')
+    log.erro('Esta é uma mensagem erro muito comprida e será limitada a 40 caracteres, o restante será cortado e ingorado ao ser manipulado', 40)
+    log.critico('Esta é uma mensagem crítica')
+
+    # Exemplo de função que gera uma exceção
+    def funcao_com_erro():
+        raise ValueError('Este é um erro de exemplo')
+
+    # Testando redirecionamento de print e captura de exceção
+    print('Mensagem de teste via print')
+    try:
+        funcao_com_erro()
+    except Exception as e:
+        print(f'Capturado um erro: {e}')
+
+    log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit=1)
+
+    log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
+
+    # obtem os registros de log da última hora (comportamento padrão)
+    filtra_log = log.search() 
+
+    # obtem os registros das últimas 6 horas
+    ultimas_6h = datetime.datetime.now() - datetime.timedelta(hours=6) ## carimbo de tempo de 6 horas atrás !!! requer import datetime
+    filtra_log = log.search(None, ultimas_6h) # None no 1º parametro impõe o log do arquivo corrente como padrão (definido em 'LogFile' e apontado no instanciamento da classe)
+
+    # obtem os registros do dia 14/01/2020 até 3h atrás
+    ultimas_3h = datetime.datetime.now() - datetime.timedelta(hours=3) ## carimbo de tempo de 6 horas atrás !!! requer import datetime
+    filtra_log = log.search(None, '14/01/2020 00:00', ultimas_3h) # 
+
+    # obtem os registros do horário comercial do dia 23/12/2023 do arquivo salvo em C:\temp\outro_arquivo.log
+    Outro_Log = Path(r'c:\temp\outro_arquivo.log')
+    filtra_log = log.search(Outro_Log, '23/12/2023 08:00', '23/12/2023 18:00') # 
+
+    # salva conteúdo filtrado em um arquivo:
+    filtrado = 'filtered_log.txt'
+    with open(filtado, 'w', encoding='ISO-8859-1') as output_file:  # indique o enconding conforme salvo (UTF-8 ou ISO-8859-1)
+        output_file.writelines(filta_log)    
+
+    # mostra o conteúdo filtrado na tela
+    print(''.join(filtra_log))
+
+    # mostra o conteúdo filtrado na tela, listando apenas as os registros do nível "DEBUG"
+    for line in filtered_lines:
+        if "DEBUG" in line:
+            print(line, end='')
+    ```
 
 <a id="lbxtoolkit.lbx_logger.SafeLogger"></a>
 
@@ -458,11 +458,11 @@ Classe que reune pequenas funções uteis para agilizar tarefas comuns.
 
 Sintaxe e exemplos de uso. Parametros omissos assume-se os valores padrão indicados abaixo:
 
-    - `Arquivo = seleciona_arquivo(DirBase, TiposArquivo=[('Todos os arquivos', '*.*')], Titulo='Selecionar arquivo')`
-    - `Diretório = seleciona_dir(DirBase=Path(r'./'), Titulo='Selecionar diretório'):`
-    - `NomeLimpo = normaliza('String # SEM Noção!') # string_sem_nocao`
-    - `cmd_window = get_cmd_window()`
-    - `maximize_console()`
+- `Arquivo = seleciona_arquivo(DirBase, TiposArquivo=[('Todos os arquivos', '*.*')], Titulo='Selecionar arquivo')`
+- `Diretório = seleciona_dir(DirBase=Path(r'./'), Titulo='Selecionar diretório'):`
+- `NomeLimpo = normaliza('String # SEM Noção!') # string_sem_nocao`
+- `cmd_window = get_cmd_window()`
+- `maximize_console()`
 
 <a id="lbxtoolkit.postgresql"></a>
 
@@ -482,131 +482,131 @@ Recursos de interação com o banco de dados relacional PostgreSQL
 
 1. O método `postgreSQl.db()` exige que as credenciais e parametros de acesso sejam fornecidas em um *dicionário* com, ao mínimo, o seguinte formato:
 
-```python
-credenciais = {
-                'dbname': 'NOME_BANCO',
-                'user': 'USUARIO'',        
-                'password': 'SENHA',     
-                'host': 'IP_OU_DNS_SERVIDOR',
-                'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
-            }
+    ```python
+    credenciais = {
+                    'dbname': 'NOME_BANCO',
+                    'user': 'USUARIO'',        
+                    'password': 'SENHA',     
+                    'host': 'IP_OU_DNS_SERVIDOR',
+                    'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
+                }
 
-conexao = postgreSQL.db(credenciais)
-```
+    conexao = postgreSQL.db(credenciais)
+    ```
 
-O nome do schema é ser declarado no contexto da query, mas se desejar alterar o schema padrão, adicione *`'options' : '-c search_path=[NOME_SCHEMA]',`* ao dicionário.
+    O nome do schema é ser declarado no contexto da query, mas se desejar alterar o schema padrão, adicione *`'options' : '-c search_path=[NOME_SCHEMA]',`* ao dicionário.
 
-Qualquer argumento de conexão previsto no pacote *psycopg2* são aceitos como entrada no dicionário acima.
+    Qualquer argumento de conexão previsto no pacote *psycopg2* são aceitos como entrada no dicionário acima.
 
 2. O método `postgreSQl.csv_df()` lê arquivo texto do tipo CSV e o converte para o objeto Dataframe do `pandas`. A assinatura da função exige que se forneça o caminho do arquivo CSV e, opcionalmente o caracter delimitador. Se o caracter demilitador não for informado, será assumido `;`. Considere usar a função `Path` para tratar o caminho do arquivo de origem.
 
-```python
-from pathlib import Path
-arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
-dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
-```
+    ```python
+    from pathlib import Path
+    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.
 
-A assinatura da função é `postgreSQL.db_insert_df([conexao], [dataframe_origem], [tabela_destino], Schema=None, Colunas=None, OnConflict=None)`
+    A assinatura da função é `postgreSQL.db_insert_df([conexao], [dataframe_origem], [tabela_destino], Schema=None, Colunas=None, OnConflict=None)`
 
-É necessário que os nomes das colunas do dataframe coincidam com o nome das colunas da tabela. 
-Não há como traduzir/compatibilizar (de-para) nomes de colunas entre o dataframe e a tabela.
+    É necessário que os nomes das colunas do dataframe coincidam com o nome das colunas da tabela. 
+    Não há como traduzir/compatibilizar (de-para) nomes de colunas entre o dataframe e a tabela.
 
-Os três primeiros parametros são posicionais e correspondem, respectivamente, (1) ao objeto da conexão com o banco, (2) ao objeto que contém o dataframe e (3) ao nome da tabela de destino.
-Assume-se que a tabela pertença ao schema padrão (definido na variável _search_path_ do servidor). Caso a tabela de destino esteja em um _schema_ diferente do padrão, deve-se informar seu nome no parâmetro opcional `Schema`.
+    Os três primeiros parametros são posicionais e correspondem, respectivamente, (1) ao objeto da conexão com o banco, (2) ao objeto que contém o dataframe e (3) ao nome da tabela de destino.
+    Assume-se que a tabela pertença ao schema padrão (definido na variável _search_path_ do servidor). Caso a tabela de destino esteja em um _schema_ diferente do padrão, deve-se informar seu nome no parâmetro opcional `Schema`.
 
-O parametro opcional `Colunas` espera um objeto do tipo _lista_ que contenha a relação das colunas a serem importadas. 
-As colunas listadas neste objeto precisam existir nas duas pontas (dataframe e tabela).
-Caso seja omisso, todas as colunas do dataframe serão inseridas na tabela. Neste caso, admite-se que haja colunas na tabela que não exitam no dataframe (serão gravadas como NULL), mas o contrário provocará erro. 
+    O parametro opcional `Colunas` espera um objeto do tipo _lista_ que contenha a relação das colunas a serem importadas. 
+    As colunas listadas neste objeto precisam existir nas duas pontas (dataframe e tabela).
+    Caso seja omisso, todas as colunas do dataframe serão inseridas na tabela. Neste caso, admite-se que haja colunas na tabela que não exitam no dataframe (serão gravadas como NULL), mas o contrário provocará erro. 
 
-O último parametro opcional `OnConflict` espera uma declaração para tratar o que fazer caso o dado a ser inserido já exista na tabela, baseado na cláusula [*ON CONFLICT*](https://www.postgresql.org/docs/current/sql-insert.html#SQL-ON-CONFLICT) do comando INSERT. A claúsula deve ser declarada explicita e integralmente nessa variável (clausula, _target_ e _action_) e não há crítica/validação desse argumento, podendo gerar erros se declarado inconforme com o padrão SQL.
+    O último parametro opcional `OnConflict` espera uma declaração para tratar o que fazer caso o dado a ser inserido já exista na tabela, baseado na cláusula [*ON CONFLICT*](https://www.postgresql.org/docs/current/sql-insert.html#SQL-ON-CONFLICT) do comando INSERT. A claúsula deve ser declarada explicita e integralmente nessa variável (clausula, _target_ e _action_) e não há crítica/validação desse argumento, podendo gerar erros se declarado inconforme com o padrão SQL.
 
-Exemplo de uso:
+    Exemplo de  uso:
 
-```python
-from lbx_toolkit import postgreSQL
-from pathlib import Path
+    ```python
+    from lbx_toolkit import postgreSQL
+    from pathlib import Path
 
-credenciais = {
-                'dbname': 'NOME_BANCO',
-                'user': 'USUARIO'',        
-                'password': 'SENHA',     
-                'host': 'IP_OU_DNS_SERVIDOR',
-                'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
-            }
+    credenciais = {
+                    'dbname': 'NOME_BANCO',
+                    'user': 'USUARIO'',        
+                    'password': 'SENHA',     
+                    'host': 'IP_OU_DNS_SERVIDOR',
+                    'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
+                }
 
-conexao = postgreSQL.db(credenciais)
+    conexao = postgreSQL.db(credenciais)
 
-arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
-dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
+    arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
+    dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
 
-postgreSQL.db_insert_df(conexao, dados, 'teste_table', Schema='meu_esquema', OnConflict='on conflict (coluna_chave_primaria) do nothing')
+    postgreSQL.db_insert_df(conexao, dados, 'teste_table', Schema='meu_esquema', OnConflict='on conflict (coluna_chave_primaria) do nothing')
 
-# conexão com o banco precisa ser fechada explicitamente após a chamada do método, caso não seja mais utilizada:
-conexao.close()
-```
+    # conexão com o banco precisa ser fechada explicitamente após a chamada do método, caso não seja mais utilizada:
+    conexao.close()
+    ```
 
 4. O método `postgreSQl.db_select()` executa consultas no banco de dados e retorna um `cursor` com o resultado.
 
-A assinatura da função é `postgreSQL.db_select([conexao], [query])`
+    A assinatura da função é `postgreSQL.db_select([conexao], [query])`
 
-São permitidas apenas instruções de consulta (podendo serem complexas, por exemplo, com uso de [CTE](https://www.postgresql.org/docs/current/queries-with.html)). A presença de outras instruções SQL de manipulação de dados e metadados não são permitidas e abortarão a execução da query, se presentes.
+    São permitidas apenas instruções de consulta (podendo serem complexas, por exemplo, com uso de [CTE](https://www.postgresql.org/docs/current/queries-with.html)). A presença de outras instruções SQL de manipulação de dados e metadados não são permitidas e abortarão a execução da query, se presentes.
 
-O `cursor` é fechado no contexto do método, antes do retorno, *não podendo* ser manipulado após recebido como retorno da função.
+    O `cursor` é fechado no contexto do método, antes do retorno, *não podendo* ser manipulado após recebido como retorno da função.
 
-A função retorna *dois objetos*, o primeiro contendo os dados do cursor, o segundo, contendo os nomes das respectivas colunas.
+    A função retorna *dois objetos*, o primeiro contendo os dados do cursor, o segundo, contendo os nomes das respectivas colunas.
 
-Exemplo de uso:
+    Exemplo de uso:
 
-```python
-from lbx_toolkit import postgreSQL
-from pathlib import Path
+    ```python
+    from lbx_toolkit import postgreSQL
+    from pathlib import Path
 
-credenciais = {
-                'dbname': 'NOME_BANCO',
-                'user': 'USUARIO'',        
-                'password': 'SENHA',     
-                'host': 'IP_OU_DNS_SERVIDOR',
-                'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
-            }
+    credenciais = {
+                    'dbname': 'NOME_BANCO',
+                    'user': 'USUARIO'',        
+                    'password': 'SENHA',     
+                    'host': 'IP_OU_DNS_SERVIDOR',
+                    'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
+                }
 
-conexao = postgreSQL.db(credenciais)
+    conexao = postgreSQL.db(credenciais)
 
-query = 'select * from meu_esquema.teste_table'
+    query = 'select * from meu_esquema.teste_table'
 
-dados, colunas = postgreSQL.db_select(conexao, query)
-conexao.close()
-```
+    dados, colunas = postgreSQL.db_select(conexao, query)
+    conexao.close()
+    ```
 
 5. O método `postgreSQl.db_update()` executa updates no banco
 
-A assinatura da função é `postgreSQL.db_update([conexao], [query])`
+    A assinatura da função é `postgreSQL.db_update([conexao], [query])`
 
-São permitidas apenas instruções de update. A presença de outras instruções SQL de manipulação de dados e metadados não são permitidas e abortarão a execução da query.
+    São permitidas apenas instruções de update. A presença de outras instruções SQL de manipulação de dados e metadados não são permitidas e abortarão a execução da query.
 
-A função retorna *a quantidade de linhas alteradas*.
+    A função retorna *a quantidade de linhas alteradas*.
 
-Exemplo de uso:
+    Exemplo de uso:
 
-```python
-from lbx_toolkit import postgreSQL
-from pathlib import Path
+    ```python
+    from lbx_toolkit import postgreSQL
+    from pathlib import Path
 
-credenciais = {
-                'dbname': 'NOME_BANCO',
-                'user': 'USUARIO'',        
-                'password': 'SENHA',     
-                'host': 'IP_OU_DNS_SERVIDOR',
-                'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
-            }
+    credenciais = {
+                    'dbname': 'NOME_BANCO',
+                    'user': 'USUARIO'',        
+                    'password': 'SENHA',     
+                    'host': 'IP_OU_DNS_SERVIDOR',
+                    'port': 'PORTA_POSTGRESQL',  ## padrão = 5432
+                }
 
-conexao = postgreSQL.db(credenciais)
+    conexao = postgreSQL.db(credenciais)
 
-query = "update meu_esquema.teste_table set coluna='novo_valor' where pk='chave'"
+    query = "update meu_esquema.teste_table set coluna='novo_valor' where pk='chave'"
 
-result = postgreSQL.db_update(conexao, query)
-conexao.close()
+    result = postgreSQL.db_update(conexao, query)
+    conexao.close()
     ```
 
 <a id="lbxtoolkit.service"></a>
@@ -655,7 +655,7 @@ O objetos mandatórios a serem inicilizados pelo **ConfigManager** são:
 > [!NOTE]
 > Para ser funcional, é necessária que a classe local herde essa classe base e redefina (por sobrecarga) ao menos os métodos `on_run` e `args_parser()`. 
 
-> [!CAUTION] 
+> [!CAUTION]
 > **Não inicialize diretamente a classe!!**
 > Sempre crie uma classe local que herde esta classe
 
@@ -753,7 +753,7 @@ class ServicerConfig(Servicer):
     if __name__ == "__main__":
 
         Daemon.main()            
-````
+```
 
 <a id="lbxtoolkit.service.Servicer.main"></a>
 
@@ -952,10 +952,10 @@ class ServicoWindows(win32serviceutil.ServiceFramework)
 
 Gerencia a instalação e execução de um daemon como um serviço do windows. Também assume o controle dos argumentos recebidos via linha de comando.
 
-    - `SvcInstall`: Cria um serviço do windows com base neste script
-    - `SvcRemove`: Remove o serviço do windows configurado à partir de `SvcInstall`
-    - `SvcStop`: Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado automaticamente pela chamada do service manager do windows)
-    - `SvcDoRun`: Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado autoamticamente pela chamada do service manager do windwos)
+- `SvcInstall`: Cria um serviço do windows com base neste script
+- `SvcRemove`: Remove o serviço do windows configurado à partir de `SvcInstall`
+- `SvcStop`: Para/Interrompe a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado automaticamente pela chamada do service manager do windows)
+- `SvcDoRun`: Inicializa a execução do serviço do windows criado por este script (método herdado da classe pai _win32serviceutil.ServiceFramework_ invocado autoamticamente pela chamada do service manager do windwos)
 
 <a id="lbxtoolkit.service_windows.ServicoWindows.SvcInstall"></a>
 

{lbxtoolkit-2.2.2.dist-info → lbxtoolkit-2.2.3.dist-info}/RECORD

@@ -1,12 +1,12 @@
 lbxtoolkit/__init__.py,sha256=44ojkLaBn3xC5Ejuiua_4CHP4JAN3rybRjElJAm3EwA,5850
 lbxtoolkit/api_rest.py,sha256=vuehp8CevkiDThjV7ofYmnPUgsBOrw3B_L-jnn5Kxx0,11228
 lbxtoolkit/auth_entra_id.py,sha256=2iE7KpRhdh4u7Y4lem63IUkEPl_GpSLRSw45_Byn1s0,21922
-lbxtoolkit/config_manager.py,sha256=Bjll1vbndi2vyLYksK2_8T7kFAWTCJJzpS2oI6z-2YQ,1628
+lbxtoolkit/config_manager.py,sha256=n3pVsxKykiYsgRuJNcNrq-bdEAjDHLmeCySl33DsoNE,1629
 lbxtoolkit/lbx_logger.py,sha256=45raalyTX45OwVOk3I7W8B4tDnIaU2j2cYsprn7SREk,22854
 lbxtoolkit/misc.py,sha256=CYPlrOQTuyql-LPDqG2NXCHq5-JhxttmBRLZMSVdHhA,3113
 lbxtoolkit/postgresql.py,sha256=UzjeA675cDG0_reVLUf_2UJm1X_r7wRfAsxAmaYRzhk,10898
-lbxtoolkit/service.py,sha256=N94WmVj8i5Pay2LKgr37jIcHQoRH4WiQEX8cKwb3xYc,18942
-lbxtoolkit/service_windows.py,sha256=WkaOLTfJyeR1kUnYSQDZAJmGcA9KciyCEDlpQLWUHkE,15242
-lbxtoolkit-2.2.2.dist-info/METADATA,sha256=oh7dr4pTD6cBgDlU6bo3fEjTiR1Od_zhk9rAoBoJZgE,46191
-lbxtoolkit-2.2.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-lbxtoolkit-2.2.2.dist-info/RECORD,,
+lbxtoolkit/service.py,sha256=Jjqq-ovB5YBue4bRRYCix9v4QDwyWoABH0AYO03yvfY,18938
+lbxtoolkit/service_windows.py,sha256=LTqITqOEWVSvp5slHG7NpRZV0-NYqI9tAgMXRvkSibM,15226
+lbxtoolkit-2.2.3.dist-info/METADATA,sha256=969no0mtfbj_NaLFhbHfBfsolRrz-GKA-gjxwVYcM5s,46566
+lbxtoolkit-2.2.3.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+lbxtoolkit-2.2.3.dist-info/RECORD,,