lbxtoolkit 2.4.2__tar.gz → 2.4.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lbxtoolkit
-Version: 2.4.2
+Version: 2.4.4
 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

{lbxtoolkit-2.4.2 → lbxtoolkit-2.4.4}/lbxtoolkit/postgresql.py

@@ -290,3 +290,48 @@ conexao.close()
                 raise  
         #
         #
+    def db_execute(self, Query, Fetch=False): # Executa comandos SQL complexos, inclusive DML com CTE
+        """
+        Executa comandos SQL de manipulação de dados que não se enquadram nos métodos
+        db_select(), db_update() ou db_insert_df().
+
+        Use este método para comandos DML complexos, especialmente UPDATE/INSERT/DELETE
+        com CTE (WITH), subqueries ou RETURNING.
+
+        Por segurança, comandos de DDL e execução dinâmica não são permitidos.
+
+        Parâmetros:
+        - Query: Comando SQL a executar.
+        - Fetch: Quando True, retorna os dados do cursor e os nomes das colunas
+                 se o comando produzir resultset (ex: RETURNING).
+
+        Retorno:
+        - Se Fetch=True e houver resultset: (Dados, Colunas)
+        - Caso contrário: quantidade de linhas afetadas
+        """
+        UpdRows = 0
+        BlackList = ['CREATE ', 'DROP ', 'ALTER ', 'TRUNCATE ', 'REPLACE ', 'CALL ', 'EXECUTE ']
+
+        if any(element in Query.upper() for element in BlackList):
+            BlackListed = [element for element in BlackList if element in Query.upper()]
+            self.logger.erro(f'{__name__}: Este método não permite comandos DDL ou execução dinâmica. A query informada possui as seguintes palavras reservadas não aceitas: {BlackListed} e não foi executada!')
+            return None
+        else:
+            try:
+                self.Cursor = self.Conexao.cursor()
+                self.Cursor.execute(Query)
+                UpdRows = self.Cursor.rowcount
+
+                if Fetch and self.Cursor.description:
+                    Dados = self.Cursor.fetchall()
+                    Colunas = [Col[0] for Col in self.Cursor.description]
+                    self.Conexao.commit()
+                    self.Cursor.close()
+                    return Dados, Colunas
+
+                self.Conexao.commit()
+                self.Cursor.close()
+                return UpdRows
+            except Exception as Err:
+                self.Conexao.rollback()
+                raise

{lbxtoolkit-2.4.2 → lbxtoolkit-2.4.4}/lbxtoolkit/service.py

@@ -62,8 +62,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 +141,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 +150,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 +174,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
 

{lbxtoolkit-2.4.2 → lbxtoolkit-2.4.4}/lbxtoolkit/service_windows.py

@@ -98,13 +98,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 +118,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())

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

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