lbxtoolkit 2.4.3__tar.gz → 2.4.5__tar.gz

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lbxtoolkit
-Version: 2.4.3
+Version: 2.4.5
 Summary: Caixa ferramentas da LBX para automações de processos (RPA), integrações, utilitários Windows e componentes reutilizáveis.
 Author: Cristiano P. Ferrari
 Author-email: cristiano.ferrari@lbx.com.br
@@ -14,8 +14,8 @@ Requires-Dist: numpy (>=2.0.1)
 Requires-Dist: pandas (>=2.2.2)
 Requires-Dist: psutil (>=6.0.0)
 Requires-Dist: psycopg2 (>=2.9.9)
-Requires-Dist: pygetwindow (>=0.0.9)
-Requires-Dist: pywin32 (>=306)
+Requires-Dist: pygetwindow (>=0.0.9) ; sys_platform == "win32"
+Requires-Dist: pywin32 (>=306) ; sys_platform == "win32"
 Requires-Dist: requests (>=2.32.3)
 Requires-Dist: selenium (>=4.23.1)
 Requires-Dist: validators (>=0.33.0)

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/lbxtoolkit/api_rest.py

@@ -265,8 +265,9 @@ Para uso em APIs com autenticação JWT (JSON Web Token), OAuth, Bearer Token Au
                     MsgErro = Retorno
             except:
                 MsgErro = Retorno.replace(r'\n\t',' ')        
-            finally:
-                return MsgErro
+            # antes: "finally: return MsgErro" — mesmo efeito, sem o
+            # SyntaxWarning do Python 3.14 (PEP 765: return em finally)
+            return MsgErro
         else:
             return Retorno      
         #

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/lbxtoolkit/misc.py

@@ -1,13 +1,24 @@
 import ctypes
 import os
 import re
-import tkinter as tk
 from pathlib import Path
-from tkinter import filedialog
 from typing import Any, Optional
 from unicodedata import normalize
 
-import pygetwindow as gw
+# Dependências gráficas/Windows são opcionais: em Linux headless (VPS) o
+# tkinter pode não existir e o pygetwindow lança NotImplementedError no import.
+# Os métodos que dependem delas verificam a disponibilidade em tempo de execução.
+try:
+    import tkinter as tk
+    from tkinter import filedialog
+except ImportError:  # pragma: no cover - depende da plataforma
+    tk = None  # type: ignore[assignment]
+    filedialog = None  # type: ignore[assignment]
+
+try:
+    import pygetwindow as gw
+except (ImportError, NotImplementedError):  # pragma: no cover - depende da plataforma
+    gw = None  # type: ignore[assignment]
 
 
 class misc:
@@ -55,6 +66,9 @@ class misc:
         if TiposArquivo is None:
             TiposArquivo = [("Todos os arquivos", "*.*")]
 
+        if tk is None or filedialog is None:
+            raise RuntimeError("seleciona_arquivo indisponível: tkinter não está instalado neste ambiente")
+
         root = tk.Tk()
         root.withdraw()
 
@@ -83,6 +97,9 @@ class misc:
             Caminho do diretório selecionado como `Path`.
             Se o usuário cancelar, retorna `Path('.')`.
         """
+        if tk is None or filedialog is None:
+            raise RuntimeError("seleciona_dir indisponível: tkinter não está instalado neste ambiente")
+
         root = tk.Tk()
         root.withdraw()
 
@@ -167,8 +184,12 @@ class misc:
 
         Returns:
             Objeto de janela retornado por `pygetwindow`, ou `None`
-            se nenhuma janela adequada for encontrada.
+            se nenhuma janela adequada for encontrada ou se a plataforma
+            não suportar `pygetwindow` (ex.: Linux).
         """
+        if gw is None:
+            return None
+
         windows = gw.getWindowsWithTitle("")
         for window in windows:
             if window.title and window.visible and window.topleft:
@@ -181,8 +202,12 @@ class misc:
         """
         Maximiza a janela atual do console no Windows.
 
-        Não faz nada se o handle da janela não puder ser obtido.
+        Não faz nada se o handle da janela não puder ser obtido
+        ou se a plataforma não for Windows.
         """
+        if os.name != "nt":
+            return
+
         kernel32 = ctypes.WinDLL("kernel32")
         user32 = ctypes.WinDLL("user32")
         hWnd = kernel32.GetConsoleWindow()
@@ -487,4 +512,4 @@ class misc:
         try:
             return int(str(valor).strip())
         except ValueError as exc:
-            raise RuntimeError(f"Variável de ambiente {nome} deve ser numérica.") from exc
+            raise RuntimeError(f"Variável de ambiente {nome} deve ser numérica.") from exc

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/lbxtoolkit/service.py

@@ -8,8 +8,12 @@ from pathlib import Path
 import platform
 import socket
 import argparse
-import servicemanager #type: ignore
-import win32serviceutil #type: ignore
+try:
+    import servicemanager #type: ignore
+    import win32serviceutil #type: ignore
+except ImportError:  # pragma: no cover - fora do Windows
+    servicemanager = None  # type: ignore[assignment]
+    win32serviceutil = None  # type: ignore[assignment]
 
 class Servicer(): # Cria um daemon para rodar como serviço
     """
@@ -62,8 +66,8 @@ from pathlib import Path
 from lbxtoolkit import Servicer, ServicoWindows, lbx_logger
 
 class ServicerConfig(Servicer):        
-    def __init__(self, Log=None, piddir=None):  ## Log e piddir são parametros mandatórios. outros parametros posicionais ou nominais (*args e **kwargs) pode ser adicionados aqui para serem utilizados pelos métodos locais
-        super().__init__(Log=Log, piddir=piddir) ## provoca a inicialização da classe pai
+    def __init__(self, Log=None, piddir=None, NewModuleMode=False):  ## Log e piddir são parametros mandatórios. outros parametros posicionais ou nominais (*args e **kwargs) pode ser adicionados aqui para serem utilizados pelos métodos locais
+        super().__init__(Log=Log, piddir=piddir, NewModuleMode=NewModuleMode) ## provoca a inicialização da classe pai
         ## complete o código de instanciamento da classe aqui, se necessário
         ## os métodos on_init(), on_init_pre() e on_init_pos()
     ## SOBRECARGA DOS MÉTODOS DA CLASSE PAI 
@@ -141,7 +145,8 @@ class ServicerConfig(Servicer):
                             argparse_opt=ArgparseOpt,
                             ambiente=Ambiente
                             )
-    Daemon = ServicerConfig(DirRetorno, Log=LogDaemon, piddir=DirPIDDaemons)
+    NewModuleMode = misc.to_bool(os.getenv('NEW_MODULE_MODE'), False)
+    Daemon = ServicerConfig(DirRetorno, Log=LogDaemon, piddir=DirPIDDaemons, NewModuleMode=NewModuleMode)
     ConfigManager.set('daemon',Daemon)
 
     if __name__ == "__main__":
@@ -149,7 +154,7 @@ class ServicerConfig(Servicer):
         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
+    def __init__(self, Log=None, piddir=None, NewModuleMode: bool = False):#TODO: ao criar uma classe padrão usar args/kwargs para lidar como parametros variáveis no instanciamento
         """
         variáveis abaixo são mandatórias e precisa inicializadas no ConfigManager.inicialize() do módulo principal/pai:
             - log
@@ -173,6 +178,10 @@ class ServicerConfig(Servicer):
             raise ValueError(f'Argumento "argparse_opt" é mandatório e deve ser uma lista de dicionários ao mínimo as chaves: [short, long, action, help] para tratamento dos argumentos recebidos da linha de comando') 
         if self.ambiente is None or self.ambiente not in ['Linux', 'Windows', 'Serviço']:
             raise ValueError(f'Argumento "ambiente" é mandatório e deve ser uma string com um dos seguintes valores: [Linux, Windows, Serviço]') 
+        if not isinstance(NewModuleMode, bool):
+            raise ValueError(f'Argumento "NewModuleMode" deve ser booleano [True ou False]')
+
+        self.NewModuleMode = NewModuleMode
                       
         self.on_init_pre() ## método opcional a ser definito por sobrecarga na função local
 
@@ -211,6 +220,10 @@ class ServicerConfig(Servicer):
         elif [chave for chave in config if config[chave] is None]:
             raise ValueError(f'Argumento "config" ({config}) possui as seguintes chaves com valores inválidos [None]: {[chave for chave in config if config[chave] is None]:}')
 
+        _cmd_servico = len(sys.argv) > 1 and sys.argv[1] in ['install', 'remove', 'start', 'stop', 'restart', 'debug']
+        if (servicemanager is None or win32serviceutil is None) and (_cmd_servico or self.ambiente == 'Serviço'):
+            raise RuntimeError('Gerenciamento de serviço Windows indisponível nesta plataforma (pywin32 ausente); no Linux use systemd')
+
         ServicoWindows._svc_name_ = config['name']
         ServicoWindows._svc_display_name_ = config['display_name']
         ServicoWindows._svc_description_ = config['description']        

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/lbxtoolkit/service_windows.py

@@ -7,12 +7,38 @@ from pathlib import Path
 import subprocess
 import platform
 import socket
-import servicemanager
-import win32serviceutil
-import win32service
-import win32event
+# pywin32 só existe no Windows. Em outras plataformas o módulo continua
+# importável (o __init__ do pacote o importa sempre), mas a classe não pode
+# ser instanciada — no Linux o equivalente é uma unit do systemd.
+try:
+    import servicemanager
+    import win32serviceutil
+    import win32service
+    import win32event
+    _BaseServico = win32serviceutil.ServiceFramework
+    PYWIN32_DISPONIVEL = True
+except ImportError:  # pragma: no cover - depende da plataforma
+    servicemanager = None  # type: ignore[assignment]
+    win32serviceutil = None  # type: ignore[assignment]
+    win32service = None  # type: ignore[assignment]
+    win32event = None  # type: ignore[assignment]
+    PYWIN32_DISPONIVEL = False
 
-class ServicoWindows(win32serviceutil.ServiceFramework): # Gerencia a execução/instalação como serviço do windows
+    class _BaseServico:  # type: ignore[no-redef]
+        """
+        Base substituta usada quando o pywin32 não está disponível.
+
+        Permite importar o pacote fora do Windows; qualquer tentativa de
+        instanciar o serviço falha com mensagem explícita.
+
+        Example:
+            ServicoWindows(args)  # RuntimeError fora do Windows
+        """
+
+        def __init__(self, *args, **kwargs) -> None:
+            raise RuntimeError("ServicoWindows requer pywin32 (somente Windows); no Linux use systemd")
+
+class ServicoWindows(_BaseServico):  # type: ignore[misc, valid-type] # Gerencia a execução/instalação como serviço do windows
     """
 #### Classe **ServicoWindows**
 
@@ -41,6 +67,8 @@ O objetos mandatórios a serem inicilizados pelo **ConfigManager** são:
     _svc_display_name_ = None
     _svc_description_ = None   
     def __init__(self, args):
+        if not PYWIN32_DISPONIVEL:
+            raise RuntimeError("ServicoWindows requer pywin32 (somente Windows); no Linux use systemd")
         self.log = ConfigManager.get('log')
         self.daemon = ConfigManager.get('daemon')
         self.config = ConfigManager.get('config')  
@@ -98,13 +126,18 @@ O objetos mandatórios a serem inicilizados pelo **ConfigManager** são:
             _svc_display_name_ = config['display_name']
             _svc_description_ = config['description']
 
-            ## para legado. suportar tanto a criação de execução direta do .py (originalmente) como por módulo
-            ## a lógica é que raiz_projeto e modulo só sejam definidos se o projeto foi estrutura para execução por módulo/entrypoint (pythom -m ou poetry run). 
-            #  neste caso, é esperado que service_path e python_path sejam nulos
-            ## por outro lado, se a execução for diretamente pelo script (python script.py), é esperado que raiz_projeto e modulo sejam nulos. se service_path e python_path forem nulos também, serão definidos arbitrariamente
-            if raiz_projeto and modulo: ## execução por módulo (novo)
-                service_path = None
-                python_path = None
+            NewModuleMode = getattr(daemon, 'NewModuleMode', False)
+
+            if NewModuleMode:
+                ## Novo padrão de execução por módulo.
+                ## Usa exatamente o interpretador que executou o comando "install",
+                ## independentemente de onde o ambiente virtual esteja armazenado.
+                python_path = Path(sys.executable).resolve()
+                if not python_path.is_file():
+                    raise FileNotFoundError(
+                        f'Interpretador Python não encontrado: {python_path}'
+                    )
+
                 wrapper = Path(raiz_projeto, f'wrapper_servico_{modulo}.bat') ## tem que ser igual a SvcRemove. Mudou lá, muda aqui.
                 wrapper_content = f"""
 @echo off
@@ -113,16 +146,39 @@ REM !!!!NÃO TOQUE NESSE ARQUIVO. NÃO O APAQUE NEM O MODIFIQUE.!!!!
 REM O serviço do windows [{config['display_name']}] que roda nesta máquina depende do conteúdo deste arquivo de lotes.
 REM ==================================================================================================================
 set PYTHONPATH=%~dp0
-"%~dp0.venv\\Scripts\\python.exe" -m {modulo} %*
-            """              
+"{python_path}" -m {modulo} %*
+            """
                 with open(wrapper, "w", encoding="utf-8") as file:
                     file.write(wrapper_content)
                 service_cmd = f'{wrapper}'
 
-            else: ## execução direta do script (legado)
-                service_path = ConfigManager.get('service_path') if ConfigManager.get('service_path') else os.path.abspath(__file__)
-                python_path = ConfigManager.get('python_path') if ConfigManager.get('python_path') else os.path.join(os.getenv('VIRTUAL_ENV'), 'Scripts', 'python.exe') if os.getenv('VIRTUAL_ENV')  else sys.executable
-                service_cmd = f'{python_path} {service_path}'
+            else:
+                ## Comportamento anterior preservado integralmente para compatibilidade com o legado.
+                ## Suporta tanto a criação de execução direta do .py como por módulo.
+                ## A lógica é que raiz_projeto e modulo só sejam definidos se o projeto foi estruturado
+                ## para execução por módulo/entrypoint (python -m ou poetry run).
+                if raiz_projeto and modulo: ## execução por módulo no padrão anterior
+                    service_path = None
+                    python_path = None
+                    wrapper = Path(raiz_projeto, f'wrapper_servico_{modulo}.bat') ## tem que ser igual a SvcRemove. Mudou lá, muda aqui.
+                    wrapper_content = f"""
+@echo off
+REM ==================================================================================================================
+REM !!!!NÃO TOQUE NESSE ARQUIVO. NÃO O APAQUE NEM O MODIFIQUE.!!!!
+REM O serviço do windows [{config['display_name']}] que roda nesta máquina depende do conteúdo deste arquivo de lotes.
+REM ==================================================================================================================
+set PYTHONPATH=%~dp0
+"%~dp0.venv\\Scripts\\python.exe" -m {modulo} %*
+            """
+                    with open(wrapper, "w", encoding="utf-8") as file:
+                        file.write(wrapper_content)
+                    service_cmd = f'{wrapper}'
+
+                else: ## execução direta do script (legado)
+                    service_path = ConfigManager.get('service_path') if ConfigManager.get('service_path') else os.path.abspath(__file__)
+                    python_path = ConfigManager.get('python_path') if ConfigManager.get('python_path') else os.path.join(os.getenv('VIRTUAL_ENV'), 'Scripts', 'python.exe') if os.getenv('VIRTUAL_ENV')  else sys.executable
+                    service_cmd = f'{python_path} {service_path}'
+
 
 
             IP = socket.gethostbyname(socket.gethostname())
@@ -329,4 +385,4 @@ set PYTHONPATH=%~dp0
         finally:
             log.info('daemon encerrado!')               
         #
-        #
+        #

{lbxtoolkit-2.4.3 → lbxtoolkit-2.4.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "lbxtoolkit"
-version = "2.4.3"
+version = "2.4.5"
 description = "Caixa ferramentas da LBX para automações de processos (RPA), integrações, utilitários Windows e componentes reutilizáveis."
 authors = ["Cristiano P. Ferrari <cristiano.ferrari@lbx.com.br>"]
 readme = "README.md"
@@ -16,8 +16,8 @@ requests = ">=2.32.3"
 selenium = ">=4.23.1"
 webdriver-manager = ">=4.0.2"
 validators = ">=0.33.0"
-pygetwindow = ">=0.0.9"
-pywin32 = ">=306"
+pygetwindow = { version = ">=0.0.9", markers = "sys_platform == 'win32'" }
+pywin32 = { version = ">=306", markers = "sys_platform == 'win32'" }
 
 
 [tool.poetry.group.docs.dependencies]