lbxtoolkit 2.4.1__tar.gz → 2.4.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lbxtoolkit
-Version: 2.4.1
+Version: 2.4.3
 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.1 → lbxtoolkit-2.4.3}/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.1 → lbxtoolkit-2.4.3}/pyproject.toml

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