csc-cia-stne 0.1.29__py3-none-any.whl → 0.1.30__py3-none-any.whl

csc_cia_stne/utilitarios/functions/__init__.py

@@ -7,6 +7,7 @@ from .func_get_secret import get_secret
 from .func_datetime import now_sp
 from .func_delete import delete_file, delete_folder
 from .func_validate_json import validate_json
+from .func_pdf_extract import extrair_x_paginas_pdf, extrair_paginas_intervalo_pdf
 
 __all__ = [
     "titulo", 
@@ -19,5 +20,7 @@ __all__ = [
     "now_sp",
     "delete_file",
     "delete_folder",
+    "extrair_x_paginas_pdf",
+    "extrair_paginas_intervalo_pdf",
     "validate_json"
     ]

csc_cia_stne/utilitarios/functions/func_pdf_extract.py

@@ -0,0 +1,104 @@
+from PyPDF2 import PdfReader, PdfWriter
+from io import BytesIO
+from typing import Optional
+
+def extrair_x_paginas_pdf(file_path: str, pages_limit: int = 15) -> Optional[bytes]:
+    """
+    Extrai as primeiras X páginas de um arquivo PDF e retorna os bytes dessas páginas.
+
+    Args:
+        file_path (str): Caminho completo do arquivo PDF original.
+        pages_limit (int, optional): Número máximo de páginas a serem extraídas. 
+                                    Defaults to 15.
+
+    Returns:
+        Optional[bytes]: Bytes do novo PDF contendo as primeiras X páginas,
+                        ou None em caso de erro.
+    
+    Note:
+        - Se o PDF tiver menos páginas que pages_limit, todas serão extraídas
+        - Utiliza PyPDF2 para manipulação do arquivo PDF
+        - Retorna None em caso de erro no processamento
+    
+    Example:
+        >>> pdf_bytes = extrair_x_paginas_pdf("documento.pdf", 10)
+        >>> if pdf_bytes["success"]:
+        ...     print(f"PDF extraído com {len(pdf_bytes["data"])} bytes")
+    """
+    try:
+        # Lê o arquivo PDF original
+        reader = PdfReader(file_path)
+        writer = PdfWriter()
+
+        # Extrai as primeiras 'pages_limit' páginas ou menos, caso o PDF tenha menos de 'pages_limit' páginas
+        for page_num in range(min(pages_limit, len(reader.pages))):
+            writer.add_page(reader.pages[page_num])
+
+        # Salva o novo PDF em um objeto BytesIO
+        pdf_bytes = BytesIO()
+        writer.write(pdf_bytes)
+        pdf_bytes.seek(0)  # Move o cursor para o início do buffer
+        resposta = {"success": True, "error": None, "data": pdf_bytes.read()}
+        return resposta
+    except Exception as e:
+        resposta = {"success": False, "error": f"Erro ao extrair as primeiras {pages_limit} páginas do PDF: {str(e)}", "data": None}
+        return resposta
+
+def extrair_paginas_intervalo_pdf(file_path: str, page_start: int = 1, pages_limit: int = 15) -> Optional[bytes]:
+    """
+    Extrai um número específico de páginas de um arquivo PDF a partir de uma página inicial.
+
+    Args:
+        file_path (str): Caminho completo do arquivo PDF original.
+        page_start (int, optional): Página inicial para começar a extração (1-indexed). 
+                                Defaults to 1.
+        pages_limit (int, optional): Número máximo de páginas a serem extraídas a partir 
+                                    da página inicial. Defaults to 15.
+
+    Returns:
+        Optional[bytes]: Bytes do novo PDF contendo as páginas do intervalo especificado,
+                    ou None em caso de erro.
+    
+    Note:
+        - Se page_start for maior que o número total de páginas, retorna None
+        - Se o número de páginas restantes for menor que pages_limit, extrai apenas as disponíveis
+        - Utiliza PyPDF2 para manipulação do arquivo PDF
+        - Páginas são indexadas começando em 1 (não 0)
+    
+    Example:
+        >>> # Extrai 5 páginas começando da página 3
+        >>> pdf_bytes = extrair_paginas_intervalo_pdf("documento.pdf", 3, 5)
+        >>> if pdf_bytes["success"]:
+        ...     print(f"PDF extraído com {len(pdf_bytes["data"])} bytes")
+    """
+    try:
+        # Lê o arquivo PDF original
+        reader = PdfReader(file_path)
+        writer = PdfWriter()
+        
+        # Converte page_start para índice 0-based
+        start_index = page_start - 1
+        
+        # Verifica se a página inicial é válida
+        if start_index >= len(reader.pages) or start_index < 0:
+            resposta = {"success": False, "error": f"Página inicial {page_start} inválida. O PDF tem {len(reader.pages)} páginas.", "data": None}
+            return resposta
+
+        # Calcula o índice final baseado no limite de páginas
+        end_index = min(start_index + pages_limit, len(reader.pages))
+        
+        # Extrai as páginas do intervalo especificado
+        for page_num in range(start_index, end_index):
+            writer.add_page(reader.pages[page_num])
+        
+        # Salva o novo PDF em um objeto BytesIO
+        pdf_bytes = BytesIO()
+        writer.write(pdf_bytes)
+        pdf_bytes.seek(0)  # Move o cursor para o início do buffer
+
+        resposta = {"success": True, "error": None, "data": pdf_bytes.read()}
+        return resposta
+
+    except Exception as e:
+        resposta = {"success": False, "error": f"Erro ao extrair páginas {page_start}-{page_start + pages_limit - 1} do PDF: {str(e)}", "data": None}
+        return resposta

{csc_cia_stne-0.1.29.dist-info → csc_cia_stne-0.1.30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: csc_cia_stne
-Version: 0.1.29
+Version: 0.1.30
 Summary: Biblioteca do time CSC-CIA utilizada no desenvolvimento de RPAs
 License: MIT
 Keywords: karavela,csc,cia,stone,rpa,botcity,stne
@@ -33,6 +33,7 @@ Requires-Dist: email-validator
 Requires-Dist: botcity-maestro-sdk
 Requires-Dist: psutil
 Requires-Dist: cryptography
+Requires-Dist: PyPDF2
 Requires-Dist: pycurl
 Dynamic: license-file
 

{csc_cia_stne-0.1.29.dist-info → csc_cia_stne-0.1.30.dist-info}/RECORD

@@ -17,12 +17,13 @@ csc_cia_stne/stne_admin.py,sha256=tbRN_l3y---GHlQoAAjlZP92wnVA73hUmk9hQxKavH8,28
 csc_cia_stne/wacess.py,sha256=g-bWZNpm_tU7UsW1G_rqh_2fW2KShvxZHGOerX8DuQw,26768
 csc_cia_stne/web.py,sha256=TBXUJ5eS36fytU3oFDuJsogi0sgw_qKgK-uphx4Nvxo,2506
 csc_cia_stne/utilitarios/__init__.py,sha256=ul7p-4XduFOQW2ldKSIbTQb3eq7h5O1l8IwSP7b5KgY,410
-csc_cia_stne/utilitarios/functions/__init__.py,sha256=1jKf5CbiBe5wRKu-npBe9AYqY8KybGbQXfHjZ8JR5wM,629
+csc_cia_stne/utilitarios/functions/__init__.py,sha256=KPzb4b48YxWkn-9Pg4L3XHTWO3UqDiRXmTu1IyOJXMY,778
 csc_cia_stne/utilitarios/functions/func_b64.py,sha256=XGU34BIQQXWXBS0yM2B4A2wDlcrMl1unIJXjq4lpLnk,1254
 csc_cia_stne/utilitarios/functions/func_converters.py,sha256=EY1zvlBaRX7G1MceVSiRXwwKDQDZwUO9iECBL0fe5iU,481
 csc_cia_stne/utilitarios/functions/func_datetime.py,sha256=UA7ch4sQWTiYcz8r6LtGujIdpTU-Sht8qmTYvm9vhh0,257
 csc_cia_stne/utilitarios/functions/func_delete.py,sha256=o2h4leucTq5Cs0XxJ5aBzbRyuxusKXIoedn2tmxNp1E,2449
 csc_cia_stne/utilitarios/functions/func_get_secret.py,sha256=XFsAd9GnKnf9WLnARqNG2fFg5h_JEOxbVvt_78VFYh4,2959
+csc_cia_stne/utilitarios/functions/func_pdf_extract.py,sha256=uuGecPx4gh6uVyCvrqstK97G11FP7Sz0iwr52MUgD48,4508
 csc_cia_stne/utilitarios/functions/func_recriar_pastas.py,sha256=4whZpB3aJQaCPJ3osMAQpKrzEhqYtJbljGWlx_OvKIM,826
 csc_cia_stne/utilitarios/functions/func_settings.py,sha256=XwlfqdcfocXQ8kTsDKZ6GsAtpzr0_u44AOTIMtdem7U,2059
 csc_cia_stne/utilitarios/functions/func_titulo.py,sha256=bH4tYxovTARF-g2kWUK_GIzzXt8egbVdp6mWD6fc_3I,5345
@@ -39,8 +40,8 @@ csc_cia_stne/utilitarios/web_screen/__init__.py,sha256=5QcOPXKd95SvP2DoZiHS0gaU6
 csc_cia_stne/utilitarios/web_screen/web_screen_abstract.py,sha256=PjL8Vgfj_JdKidia7RFyCkro3avYLQu4RZRos41sh3w,3241
 csc_cia_stne/utilitarios/web_screen/web_screen_botcity.py,sha256=Xi5YJjl2pcxlX3OimqcBWRNXZEpAE7asyUjDJ4Oho5U,12297
 csc_cia_stne/utilitarios/web_screen/web_screen_selenium.py,sha256=JLIcPJE9ZX3Pd6zG6oTRMqqUAY063UzLY3ReRlxmiSM,15581
-csc_cia_stne-0.1.29.dist-info/licenses/LICENCE,sha256=LPGMtgKki2C3KEZP7hDhA1HBrlq5JCHkIeStUCLEMx4,1073
-csc_cia_stne-0.1.29.dist-info/METADATA,sha256=sN19T2lC0fc6kk15iwjcobbX_1v_w9jhHWpbpHIvFCA,1530
-csc_cia_stne-0.1.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-csc_cia_stne-0.1.29.dist-info/top_level.txt,sha256=ldo7GVv3tQx5KJvwBzdZzzQmjPys2NDVVn1rv0BOF2Q,13
-csc_cia_stne-0.1.29.dist-info/RECORD,,
+csc_cia_stne-0.1.30.dist-info/licenses/LICENCE,sha256=LPGMtgKki2C3KEZP7hDhA1HBrlq5JCHkIeStUCLEMx4,1073
+csc_cia_stne-0.1.30.dist-info/METADATA,sha256=VzrUhcUhi1RZ2i2aBwBczNzvOfPFmGtwA3wfQSyAvYc,1552
+csc_cia_stne-0.1.30.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+csc_cia_stne-0.1.30.dist-info/top_level.txt,sha256=ldo7GVv3tQx5KJvwBzdZzzQmjPys2NDVVn1rv0BOF2Q,13
+csc_cia_stne-0.1.30.dist-info/RECORD,,