lbxtoolkit 2.4.4__tar.gz → 2.4.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lbxtoolkit
-Version: 2.4.4
+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.4 → 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.4 → 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.4 → 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
     """
@@ -216,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.4 → 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')  
@@ -357,4 +385,4 @@ set PYTHONPATH=%~dp0
         finally:
             log.info('daemon encerrado!')               
         #
-        #
+        #

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "lbxtoolkit"
-version = "2.4.4"
+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]