lbxtoolkit 2.0.1__tar.gz → 2.0.3__tar.gz

{lbxtoolkit-2.0.1/lbxtoolkit.egg-info → lbxtoolkit-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lbxtoolkit
-Version: 2.0.1
+Version: 2.0.3
 Summary: Biblioteca de ferramentas LBX S/A
 Author: Cristiano P. Ferrari
 Author-email: boxferrari@gmail.com
@@ -19,6 +19,7 @@ Requires-Dist: requests
 Requires-Dist: selenium
 Requires-Dist: webdriver-manager
 Requires-Dist: validators
+Requires-Dist: pygetwindow
 
 # Biblioteca de ferramentas LBX S/A
 
@@ -43,14 +44,21 @@ Esta biblioteca possui ferramentas de uso recorrente para interação com banco
   - _.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.
-  - _.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
+  - _.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 
 
+**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)
 
 ## Instalação e uso:
 
@@ -411,4 +419,14 @@ log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit
 log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
 ```
 
+#### Classe **misc**
 
+Classe que reune pequenas funções uteis para agilizar tarefas comuns.
+
+Sintaxe e exemplos de uso. Parametros omissos assume  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()`

lbxtoolkit-2.0.1/PKG-INFO → lbxtoolkit-2.0.3/README.md

@@ -1,25 +1,3 @@
-Metadata-Version: 2.1
-Name: lbxtoolkit
-Version: 2.0.1
-Summary: Biblioteca de ferramentas LBX S/A
-Author: Cristiano P. Ferrari
-Author-email: boxferrari@gmail.com
-License: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: psycopg2
-Requires-Dist: pandas
-Requires-Dist: numpy
-Requires-Dist: msal
-Requires-Dist: requests
-Requires-Dist: selenium
-Requires-Dist: webdriver-manager
-Requires-Dist: validators
-
 # Biblioteca de ferramentas LBX S/A
 
 Esta biblioteca possui ferramentas de uso recorrente para interação com banco de dados e API, além de autenticação/validação de credenciais de usuário no Microsoft Entra ID
@@ -43,14 +21,21 @@ Esta biblioteca possui ferramentas de uso recorrente para interação com banco
   - _.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.
-  - _.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
+  - _.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 
 
+**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)
 
 ## Instalação e uso:
 
@@ -411,4 +396,14 @@ log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit
 log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
 ```
 
+#### Classe **misc**
+
+Classe que reune pequenas funções uteis para agilizar tarefas comuns.
+
+Sintaxe e exemplos de uso. Parametros omissos assume  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()`

{lbxtoolkit-2.0.1 → lbxtoolkit-2.0.3}/lbxtoolkit/__init__.py

@@ -18,6 +18,13 @@ import numpy as np
 from http.server import BaseHTTPRequestHandler, HTTPServer
 import urllib.parse as urlparse
 import validators
+from pathlib import Path
+import tkinter as tk
+from tkinter import filedialog
+import re 
+from unicodedata import normalize 
+import pygetwindow as gw
+import ctypes    
 
 locale.setlocale(locale.LC_ALL, 'pt_BR.UTF-8')
 
@@ -535,6 +542,25 @@ class api_rest: # Classe para interação com APIs Rest (especialmente Sienge)
             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}', exit=1)
 
+    def trata_erro_sienge(CodRet, Retorno):
+        if not 200 <= CodRet <= 299:        
+            try:
+                DicRetorno = eval(Retorno.replace('null','None').replace(r'\n\t',' '))
+                if 'clientMessage' in DicRetorno:
+                    MsgErro = DicRetorno['clientMessage']
+                elif 'developerMessage' in DicRetorno:
+                    MsgErro = DicRetorno['developerMessage']
+                elif 'message' in DicRetorno:
+                    MsgErro = DicRetorno['message']
+                else:
+                    MsgErro = Retorno
+            except:
+                MsgErro = Retorno.replace(r'\n\t',' ')        
+            finally:
+                return MsgErro
+        else:
+            return Retorno      
+
     def close(self): # Encerra a cessão
         self.Sessao.close()                   
 
@@ -603,6 +629,10 @@ class lbx_logger: # Classe para gerenciar a saída para log
             return
         self.logger.error("Exceção não prevista", exc_info=(exc_type, exc_value, exc_traceback))
 
+    def print(self, *args, **kwargs):
+        # Imprime diretamente na saída padrão
+        print(*args, **kwargs, file=self.original_stdout)
+
     def add(self, message, corte=None):
         message = message[:corte] if corte else message
         self.msg = self.msg + message if not message is None else self.msg
@@ -662,3 +692,57 @@ class lbx_logger: # Classe para gerenciar a saída para log
         for handler in handlers:
             handler.close()
             self.logger.removeHandler(handler)
+
+class misc: # Classe de miscelâneas
+    def __init__(self):
+        return None
+
+    # Picker para selecionar arquivo
+    def seleciona_arquivo(DirBase, TiposArquivo=[('Todos os arquivos', '*.*')], Titulo='Selecionar arquivo'):    
+        root = tk.Tk()
+        root.withdraw()  # Esconde a janela principal do Tkinter
+        Arquivo = filedialog.askopenfilename(initialdir=DirBase, filetypes=TiposArquivo, title=Titulo)
+        Arquivo = Path(Arquivo)
+        root.destroy()
+        return Arquivo
+
+    # Picker para selecionar diretório
+    def seleciona_dir(DirBase=Path(r'./'), Titulo='Selecionar diretório'):
+        root = tk.Tk() # objeto picker  (Tkinter)para selecionar arquivos e diretórios
+        root.withdraw()  # Esconde a janela principal do Tkinter
+        Diretorio = filedialog.askdirectory(initialdir=DirBase, title=Titulo)
+        Diretorio = Path(Diretorio)
+        root.destroy()
+        return Diretorio
+
+    # Limpa e padroniza nomes
+    def normaliza(Original):
+        Lixo = r'/\\?%§ªº°`´^~*:|"<>!@#$%¨&*()_+=-[]{}"\' ' 
+        Normalizar = 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()
+
+    # Captura a referencia da janela atual para retornar o foco à ela depois de chamar os pickers
+    def get_cmd_window():
+        pid = os.getpid()
+        windows = gw.getWindowsWithTitle("")
+        for window in windows:
+            if window.title and window.visible and window.topleft:
+                return window
+        return None
+
+    def maximize_console():
+        # Ajustar o buffer de console
+        # os.system('mode con: cols=500 lines=100')
+        
+        # Obter o handle da janela do console
+        kernel32 = ctypes.WinDLL('kernel32')
+        user32 = ctypes.WinDLL('user32')
+        hWnd = kernel32.GetConsoleWindow()
+        
+        if hWnd:
+            # Definir as dimensões da tela
+            user32.ShowWindow(hWnd, 3)  # 3 = SW_MAXIMIZE  

lbxtoolkit-2.0.1/README.md → lbxtoolkit-2.0.3/lbxtoolkit.egg-info/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.1
+Name: lbxtoolkit
+Version: 2.0.3
+Summary: Biblioteca de ferramentas LBX S/A
+Author: Cristiano P. Ferrari
+Author-email: boxferrari@gmail.com
+License: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psycopg2
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: msal
+Requires-Dist: requests
+Requires-Dist: selenium
+Requires-Dist: webdriver-manager
+Requires-Dist: validators
+Requires-Dist: pygetwindow
+
 # Biblioteca de ferramentas LBX S/A
 
 Esta biblioteca possui ferramentas de uso recorrente para interação com banco de dados e API, além de autenticação/validação de credenciais de usuário no Microsoft Entra ID
@@ -21,14 +44,21 @@ Esta biblioteca possui ferramentas de uso recorrente para interação com banco
   - _.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.
-  - _.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
+  - _.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 
 
+**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)
 
 ## Instalação e uso:
 
@@ -389,4 +419,14 @@ log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit
 log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
 ```
 
+#### Classe **misc**
+
+Classe que reune pequenas funções uteis para agilizar tarefas comuns.
+
+Sintaxe e exemplos de uso. Parametros omissos assume  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()`

{lbxtoolkit-2.0.1 → lbxtoolkit-2.0.3}/lbxtoolkit.egg-info/requires.txt

@@ -6,3 +6,4 @@ requests
 selenium
 webdriver-manager
 validators
+pygetwindow

{lbxtoolkit-2.0.1 → lbxtoolkit-2.0.3}/setup.py

@@ -8,7 +8,7 @@ with open("README.md", "r", encoding='utf-8') as fh:
 
 setup(
     name='lbxtoolkit',
-    version='2.0.1',
+    version='2.0.3',
     packages=find_packages(),
     install_requires=[
         'psycopg2',
@@ -18,7 +18,8 @@ setup(
         'requests',
         'selenium',
         'webdriver-manager',
-        'validators'
+        'validators',
+        'pygetwindow'
     ],
     license='MIT License',
     description='Biblioteca de ferramentas LBX S/A',