PyVeri

Type-safe, minimal-dependency Python SDK for deep cryptographic validation.

⚠️ El Problema

Lidiar directamente con cryptography o pyOpenSSL en el backend para firmar facturas (TicketBAI, VeriFactu) contamina la lógica de negocio. Requiere manejar buffers de memoria complejos, ASN.1 y algoritmos de digestión manuales, convirtiéndose en un infierno de mantenimiento en FastAPIs/Djangos.

⚡ La Solución (SDK Dedicado)

PyVeri abstrae el horror criptográfico en una interfaz limpia orientada a objetos, 100% tipada (con mypy) y probada rigurosamente. Integra PyVeri en tu infraestructura (como VeriStack) y olvídate de la fontanería de los certificados digitales.

🚀 Instalación y Uso

Aviso: Este es un SDK interno, su distribución vía PyPI está en Roadmap.

from pyveri.signer import VeriFactuSigner
from pyveri.models import InvoiceData

signer = VeriFactuSigner(certificate_path="/vault/cert.p12", password="secure_pass")

invoice = InvoiceData(amount=100.45, tax=21.0, merchant_id="ESB12345678")
signature = signer.sign_invoice(invoice)

print(f"Cryptographic Signature Hash: {signature.hash_sha256}")

🧠 Core Philosophy

• 🛡️ Zero side-effects: Funciones deterministas puras. Sin peticiones de red ocultas.
• 🚨 Fail-Fast: Levanta excepciones estrictas y específicas (InvalidCertificateError) inmediatamente en el arranque en lugar de fallar silenciosamente en producción.
• 🧩 Type-Safe: Abrazando Pydantic y Type Hints de Python puro para lograr un Autocomplete perfecto en el IDE de los desarrolladores que consuman tu librería.