epok-toolkit 1.12.8__py3-none-any.whl

epok_toolkit/pdf/ticket_pdf.py

@@ -0,0 +1,246 @@
+from reportlab.lib.utils import ImageReader
+from reportlab.pdfbase import pdfmetrics
+from datetime import date, datetime
+from reportlab.pdfbase.ttfonts import TTFont
+from reportlab.pdfgen import canvas
+from dataclasses import dataclass
+from typing import Optional
+from PIL import Image
+from uuid import uuid4, UUID
+import os
+import qrcode
+from io import BytesIO
+import importlib.resources
+
+
+
+fuente_path = os.path.join(os.path.dirname(__file__), "fuentes", "Kollektif-Bold.ttf")
+pdfmetrics.registerFont(TTFont("kollektif", fuente_path))
+
+
+def hex_to_rgb(hex_color):
+    hex_color = hex_color.lstrip('#')
+    lv = len(hex_color)
+    return tuple(int(hex_color[i:i + lv // 3], 16) / 255.0 for i in range(0, lv, lv // 3))
+
+
+class Config:
+    base_path = os.path.dirname(__file__)
+    plantillas = base_path + "/plantillas/"
+    plantilla_path = importlib.resources.files("epok_toolkit.pdf.plantillas").joinpath("Ticket_congrats.png")
+    output_path = os.path.join(base_path, "ticket_final.pdf")
+    fuente = "Helvetica"
+    fuente_bold = "kollektif"
+    #bg_color = "#0082FF"  
+    bg_color = "#FFFFFF"  
+    font_color = "#000000"  
+
+
+class Contenedor:
+    def __init__(self, x, y, w, h, bold: bool = False):
+        self.x = x
+        self.y = y
+        self.w = w
+        self.h = h
+        self.color = Config.bg_color
+        self.font_size = 28
+        self.font_color = Config.font_color
+        self.fuente = Config.fuente_bold if bold else Config.fuente
+
+    def dibujar(self, c):
+        c.setFillColorRGB(*hex_to_rgb(self.color))
+        c.rect(self.x, self.y, self.w, self.h, stroke=0, fill=1)
+
+
+    def dibujar_texto(self, c, texto):
+        c.setFillColorRGB(*hex_to_rgb(self.font_color))
+        c.setFont(self.fuente, self.font_size)
+        ascent = pdfmetrics.getAscent(self.fuente) * self.font_size / 1000
+        descent = abs(pdfmetrics.getDescent(self.fuente) * self.font_size / 1000)
+        text_h = ascent + descent
+        baseline_x = self.x + self.w / 2
+        baseline_y = self.y + (self.h - text_h) / 2 + descent
+        c.drawCentredString(baseline_x, baseline_y, texto)
+
+
+class ContenedorTexto(Contenedor):
+    def __init__(self, x, y, w, h, bold: bool = False, texto="Demo",
+                 font_size=28,
+                 font_color=None,
+                 color=None,
+                 fuente=None):
+        super().__init__(x, y, w, h, bold=bold)
+        self.texto = texto
+        if font_size:
+            self.font_size = font_size
+        if font_color:
+            self.font_color = font_color
+        if color:
+            self.color = color
+        if fuente:
+            self.fuente = fuente
+    
+    def dibujar(self, c):
+        super().dibujar(c)
+        self.dibujar_texto(c, self.texto)
+
+
+class ContenedorQR(Contenedor):
+    def __init__(self, x, y, w, h, texto="QR vacío", color=None):
+        super().__init__(x, y, w, h)
+        self.texto = texto
+        if color:
+            self.color = color
+
+    def dibujar(self, c):
+        super().dibujar(c)
+        qr = qrcode.QRCode(
+            version=3,
+            error_correction=qrcode.constants.ERROR_CORRECT_H, # type: ignore
+            box_size=10,
+            border=1,
+        )
+        qr.add_data(self.texto)
+        qr.make(fit=True)
+        qr_img = qr.make_image(fill_color="black", back_color="white").convert("RGB") # type: ignore
+        qr_img = qr_img.resize((self.w, self.h), Image.LANCZOS) # type: ignore
+        buffer = BytesIO()
+        qr_img.save(buffer, format="PNG")
+        buffer.seek(0)
+        c.drawImage(ImageReader(buffer), self.x, self.y, width=self.w, height=self.h)
+
+
+@dataclass
+class TicketPDF:
+    nombre_evento: str
+    fecha: Optional[date]
+    titulo_ticket: str
+    precio: float
+    edad_min: int
+    tipo_evento: str
+    direccion: str
+    ticket_actual: int
+    total_tickets: int
+    nombre_persona: str
+    uuid: Optional[UUID] = None
+    hora_evento: Optional[str] = None
+    qr : Optional[str] = None
+
+    def __post_init__(self):
+        if isinstance(self.fecha, str):
+            self.fecha = datetime.strptime(self.fecha, "%Y-%m-%d %H:%M")
+        elif isinstance(self.fecha, date) and not isinstance(self.fecha, datetime):
+            hora = self.hora_evento or "00:00"
+            self.fecha = datetime.combine(self.fecha, datetime.strptime(hora, "%H:%M").time())
+        if not self.uuid:
+            raise ValueError("UUID no puede ser None")
+        
+        self.hora_evento = self.fecha.strftime("%H:%M") # type: ignore
+        self.width = 0
+        self.height = 0
+        self.font_size = 28
+        self.font_color = Config.font_color
+        self.color = Config.bg_color
+        self.fuente = Config.fuente
+        with Config.plantilla_path.open("rb") as f:
+            self.img = Image.open(f)
+            self.img.load()
+        self.width, self.height = self.img.size
+        self.buffer = BytesIO()
+        self.c = canvas.Canvas(self.buffer, pagesize=(self.width, self.height))
+
+
+    def generate_ticket(self):
+        def y(px): return self.height - px
+        with Config.plantilla_path.open("rb") as f:
+            self.c.drawImage(ImageReader(f), 0, 0, width=self.width, height=self.height, mask='auto')
+
+        # NOMBRE EVENTO
+        nombre_evento = ContenedorTexto(x=260, y=y(210), w=1400, h=90, texto=self.nombre_evento, font_size=78, bold=True)
+        nombre_evento.dibujar(self.c)
+        
+        # FECHA
+        SPANISH_DAYS = {
+            'Monday': 'Lunes', 'Tuesday': 'Martes', 'Wednesday': 'Miercoles',
+            'Thursday': 'Jueves', 'Friday': 'Viernes', 'Saturday': 'Sabado', 'Sunday': 'Domingo'
+        }
+        SPANISH_MONTHS = {
+            'January': 'Enero', 'February': 'Febrero', 'March': 'Marzo', 'April': 'Abril',
+            'May': 'Mayo', 'June': 'Junio', 'July': 'Julio', 'August': 'Agosto',
+            'September': 'Septiembre', 'October': 'Octubre', 'November': 'Noviembre', 'December': 'Diciembre'
+        }
+        fecha_obj = self.fecha  # type: ignore
+        day_name = SPANISH_DAYS[fecha_obj.strftime('%A')] # type: ignore
+        month_name = SPANISH_MONTHS[fecha_obj.strftime('%B')] # type: ignore
+        fecha = f"{day_name}, {fecha_obj.day} {month_name}".upper() #type: ignore
+        fecha = ContenedorTexto(x=570, y=y(320), w=900, h=90, texto=fecha, font_size=38, bold=True)
+        fecha.dibujar(self.c)
+
+        # TICKET TITULO
+        ticket_titulo = ContenedorTexto(x=260, y=y(525), w=950, h=90, texto=self.titulo_ticket, font_size=68, bold=True)
+        ticket_titulo.dibujar(self.c)
+        
+        # PRECIO
+        precio = f"{self.precio:,.2f} MXN"
+        precio = ContenedorTexto(x=450, y=y(650), w=600, h=90, texto=precio, font_size=58, bold=True)
+        precio.dibujar(self.c)
+        
+        # EDAD MINIMA
+        edad_min = str(self.edad_min)
+        edad_min = ContenedorTexto(x=345, y=y(760), w=80, h=30, texto=edad_min, font_size=18, bold=True)
+        edad_min.dibujar(self.c)
+        
+        # HORA DE ACCESO
+        hora_evento = ContenedorTexto(x=670, y=y(760), w=80, h=30, texto=self.hora_evento, font_size=18, bold=True) # type: ignore
+        hora_evento.dibujar(self.c)
+        
+        # TIPO DE EVENTO
+        tipo_evento = ContenedorTexto(x=995, y=y(760), w=150, h=30, texto=self.tipo_evento, font_size=18, bold=True)
+        tipo_evento.dibujar(self.c)
+
+        # DIRECCION
+        direccion = ContenedorTexto(x=200, y=y(950), w=1400, h=50, texto=self.direccion, font_size=38, bold=True)
+        direccion.dibujar(self.c)
+
+        # TICKET ACTUAL
+        texto = f"Ticket {self.ticket_actual} de {self.total_tickets}"
+        ticket_actual = ContenedorTexto(x=680, y=y(1035), w=340, h=50, texto=texto, font_size=28, bold=True)
+        ticket_actual.dibujar(self.c)
+        
+        # NOMBRE PERSONA
+        nombre_persona = ContenedorTexto(x=1080, y=y(1035), w=760, h=60, texto=self.nombre_persona, font_size=48, bold=True)
+        nombre_persona.dibujar(self.c)
+        
+        # UUID
+        uuid_string = self.uuid
+        # UUID
+        uuid_string = str(self.uuid)
+        uuid = ContenedorTexto(x=1390, y=y(770), w=400, h=30, texto=uuid_string, font_size=18, bold=True)
+        uuid.dibujar(self.c)
+        tam = 400
+        qr = ContenedorQR(x=1390, y=y(740), w=tam, h=tam, texto=uuid_string, color=Config.bg_color)
+        qr.dibujar(self.c)
+
+        self.c.showPage()
+        self.c.save()
+        self.buffer.seek(0)
+        return self.buffer.getvalue()
+
+
+
+        
+if __name__ == "__main__":
+    ticket = TicketPDF(
+        nombre_evento="14 aniversario Cerveza Libertad",
+        fecha=datetime(2025, 5, 31, 14, 30),
+        titulo_ticket="General",
+        precio=410,
+        edad_min=18,
+        tipo_evento="Aniversario",
+        direccion="Restaurante dentro de Hacienda del Conde",
+        ticket_actual=2,
+        total_tickets=5,
+        nombre_persona="Carolina Franco Medina",
+        uuid=uuid4(),
+    )
+    ticket.generate_ticket()

epok_toolkit-1.12.8.dist-info/METADATA

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: epok-toolkit
+Version: 1.12.8
+Summary: Una herramienta para la gestión de tareas y procesos en Django con Celery.
+Author-email: Fernando Leon Franco <fernanlee2131@gmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.0.2
+Requires-Dist: djangorestframework>=3.16.0
+Requires-Dist: celery[redis]>=5.5.3
+Requires-Dist: django-celery-beat>=2.6.0
+Requires-Dist: colorstreak>=2.1.3
+Requires-Dist: PyJWT>=2.10.1
+Requires-Dist: reportlab>=4.4.3
+Requires-Dist: qrcode>=8.2
+Dynamic: license-file
+
+
+
+# EPOK Toolkit 'v1.12.6'
+
+EPOK Toolkit es una librería de utilidades para proyectos Django y Python, diseñada para facilitar tareas comunes como envío de emails, mensajería WhatsApp, generación de PDFs y manejo avanzado de caché en APIs.
+
+---
+
+
+## ✉️ Email
+Módulo para envío de correos electrónicos con plantillas HTML y texto plano, registro dinámico y configuración visual.
+
+👉 [Documentación completa del módulo Email](epok_toolkit/email/README.md)
+
+---
+
+## 🟢 Django
+Utilidades avanzadas para proyectos Django y DRF: caché, campos personalizados, managers, respuestas, viewsets y utilidades extra.
+
+� [Documentación completa del módulo Django](epok_toolkit/django/README.md)
+
+---
+
+## 💬 Mensajería WhatsApp
+Módulo para envío de mensajes y archivos por WhatsApp, con manejo de conexión y errores.
+
+� [Documentación completa del módulo Messaging](epok_toolkit/messaging/README.md)
+
+---
+
+## 🧾 PDF / Ticket Generator
+Módulo para generación de tickets PDF personalizados usando ReportLab y plantillas gráficas.
+
+� [Documentación completa del módulo PDF](epok_toolkit/pdf/README.md)
+
+---
+
+## ⚙️ Configuración
+
+Toda la configuración se centraliza en `default_settings.py`, permitiendo personalizar colores, datos de empresa, y más.
+
+---
+
+## 🚀 Instalación
+
+```bash
+pip install epok-toolkit
+```
+
+---
+
+¿Quieres agregar ejemplos avanzados o documentación de otro módulo? ¡Solicítalo!

epok_toolkit-1.12.8.dist-info/RECORD

@@ -0,0 +1,32 @@
+epok_toolkit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+epok_toolkit/apps.py,sha256=O3q3CcucJOHjlYIS0VgbKsbtim2hpng_FxpKEG_MlWs,486
+epok_toolkit/default_settings.py,sha256=GdDpwMPzRYNDTDK0zcQKUwgiGYVVhj1Pi1NGAxTE1Io,890
+epok_toolkit/django/__init__.py,sha256=noq8F7jlKE_9ikkOt4VnoYHspxm6zGJ-_N2qF_MvLX4,136
+epok_toolkit/django/cache.py,sha256=gfYCF7HW2ofdJGb1tLTYNQN4f5EVS_izTpHVW3LDqZQ,4121
+epok_toolkit/django/fields.py,sha256=-ajP5qx-4bt9Qz9yW48gTlinTxD1xWPKOEkslqx8cSM,1089
+epok_toolkit/django/manager.py,sha256=3MZcA9wQY4E1KD8XlgZQbzf4wlF9vA8Pntl_gKDWfpA,1350
+epok_toolkit/django/models.py,sha256=E1zj2KetRGszksQvLk3HN5kWkYkEYzJRRmAUOaLJmw8,1090
+epok_toolkit/django/response.py,sha256=O8OHBaKgUQjBeYLLbgTTs669l_4D6swUgAOwswjc-88,1716
+epok_toolkit/django/viewsets.py,sha256=bycP2NyzldHl0pi5vZPHo8x1DzGN7n16kJFTXt_sNZI,3650
+epok_toolkit/django/utils/__init__.py,sha256=zDuoqm_eksZQpL-Bvd_q2KGMtSXfprBjf4TScZiwV6k,25
+epok_toolkit/django/utils/magic_link.py,sha256=GiDuy0kAGdYohGPlBL7rwpKPMpXuB1wJa1k5LTAOm4w,889
+epok_toolkit/email/__init__.py,sha256=pyJwysyVoq6DuYAG72fulsKFoOuAfjw3aBH7FhmYGHc,35
+epok_toolkit/email/email_async.py,sha256=oC0WowWNUpTpXdxo6hJag5gWUaStxI6VBEArEKQxXko,1521
+epok_toolkit/email/engine.py,sha256=IIifqRI9z76pHdrO5oSSZ25aP5txOTAgrj1JuVVPlMY,2387
+epok_toolkit/email/templates.py,sha256=8aQ5E3A0q1Uqc7WZf7Tm_ssj6DgAGNHiLsAd6mrZff4,6136
+epok_toolkit/messaging/__init__.py,sha256=lo0URCOr8tR62ljc0MWTtYZ_YR-tecQaAhhAbyGcOxs,53
+epok_toolkit/messaging/whatsapp.py,sha256=TrMSiKzvnhWOotSDEGil1BGgOJ7jLK7h3MXKdW3zCJw,14114
+epok_toolkit/messaging/whatsapp_instanced.py,sha256=4NVhxkjAi8cxDUwwLWjb6IwjJESSNoVjct8DMiW2SwI,1368
+epok_toolkit/pdf/__init__.py,sha256=Scb1iOYnVIUEiUVHLNaPmcigyD-jOSBs3ws5RmolMKE,33
+epok_toolkit/pdf/ticket_pdf.py,sha256=jktxxjEL4gFfnvXZW7P7y35bllOe9sJ3S-eOkgPcEQw,8913
+epok_toolkit/pdf/fuentes/Kollektif-Bold.ttf,sha256=MiaucCL_aPGhbDl6M0xA2g2nf84MXHGciOd-XSw0XRo,78780
+epok_toolkit/pdf/fuentes/Kollektif-BoldItalic.ttf,sha256=hPMiWYQ0fLFfOKvV_OXFCwAaHnNMYzic_DPiqWPQL5w,71912
+epok_toolkit/pdf/fuentes/Kollektif-Italic.ttf,sha256=1CXPyw43il9u0tQ_7aRzsEaVtg3x3_oJ1vuMMvEaDp8,42048
+epok_toolkit/pdf/fuentes/Kollektif.ttf,sha256=7wTLkVVNUm1giLjIZcWRUH5r2r3o0GjdKic4V1A-pNQ,51128
+epok_toolkit/pdf/plantillas/Ticket_congrats.png,sha256=OSQhVR0j_nLHE6kSJ33BTR-77HM1fNAfJBe2EuX6wVk,157141
+epok_toolkit/pdf/plantillas/Ticket_congrats2.png,sha256=1RBogBdo-8WSMpD3H73HoLgJtr5EC5oVKfOCIWOxPSo,373605
+epok_toolkit-1.12.8.dist-info/licenses/LICENSE,sha256=iLDbGXdLSIOT5OsxzHCvtmxHtonE21GiFlS3LNkug4A,128
+epok_toolkit-1.12.8.dist-info/METADATA,sha256=9vJv3rMmgvtbTBmIP_Pe5-I7wSQUExL4PP61nbl-Al4,2217
+epok_toolkit-1.12.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+epok_toolkit-1.12.8.dist-info/top_level.txt,sha256=Wo72AqIFcfWwBGM5F5iGFw9PrO3WBnTSprFZIJk_pNg,13
+epok_toolkit-1.12.8.dist-info/RECORD,,

epok_toolkit-1.12.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

epok_toolkit-1.12.8.dist-info/licenses/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2025 Fernando León
+
+Permission is hereby granted, free of charge, to any person obtaining a copy...

epok_toolkit-1.12.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+epok_toolkit