# app/modules/orders/services/invoice_pdf_service.py """ Invoice PDF generation service using WeasyPrint. Renders HTML invoice templates to PDF using Jinja2 + WeasyPrint. Stores generated PDFs in the configured storage location. """ import logging from datetime import UTC, datetime from pathlib import Path from jinja2 import Environment, FileSystemLoader from sqlalchemy.orm import Session from app.modules.orders.exceptions import InvoicePDFGenerationException from app.modules.orders.models.invoice import Invoice logger = logging.getLogger(__name__) # Template directory TEMPLATE_DIR = Path(__file__).parent.parent / "templates" / "invoices" # PDF storage directory (relative to project root) PDF_STORAGE_DIR = Path("storage") / "invoices" class InvoicePDFService: """Service for generating invoice PDFs.""" def __init__(self): """Initialize the PDF service with Jinja2 environment.""" self.env = Environment( loader=FileSystemLoader(str(TEMPLATE_DIR)), autoescape=True, ) def _ensure_storage_dir(self, store_id: int) -> Path: """Ensure the storage directory exists for a store.""" storage_path = PDF_STORAGE_DIR / str(store_id) storage_path.mkdir(parents=True, exist_ok=True) return storage_path def _get_pdf_filename(self, invoice: Invoice) -> str: """Generate PDF filename for an invoice.""" safe_number = invoice.invoice_number.replace("/", "-").replace("\\", "-") return f"{safe_number}.pdf" def generate_pdf( self, db: Session, invoice: Invoice, force_regenerate: bool = False, ) -> str: """ Generate PDF for an invoice. Args: db: Database session invoice: Invoice to generate PDF for force_regenerate: If True, regenerate even if PDF already exists Returns: Path to the generated PDF file """ # Check if PDF already exists if invoice.pdf_path and not force_regenerate: if Path(invoice.pdf_path).exists(): logger.debug(f"PDF already exists for invoice {invoice.invoice_number}") return invoice.pdf_path # Ensure storage directory exists storage_dir = self._ensure_storage_dir(invoice.store_id) pdf_filename = self._get_pdf_filename(invoice) pdf_path = storage_dir / pdf_filename # Render HTML template html_content = self._render_html(invoice) # Generate PDF using WeasyPrint try: from weasyprint import HTML html_doc = HTML(string=html_content, base_url=str(TEMPLATE_DIR)) html_doc.write_pdf(str(pdf_path)) logger.info(f"Generated PDF for invoice {invoice.invoice_number} at {pdf_path}") except ImportError: logger.error("WeasyPrint not installed. Install with: pip install weasyprint") raise InvoicePDFGenerationException( invoice_id=invoice.id, reason="WeasyPrint not installed" ) except OSError as e: logger.error(f"Failed to generate PDF for invoice {invoice.invoice_number}: {e}") raise # Update invoice record with PDF path and timestamp invoice.pdf_path = str(pdf_path) invoice.pdf_generated_at = datetime.now(UTC) db.flush() return str(pdf_path) def _render_html(self, invoice: Invoice) -> str: """Render the invoice HTML template.""" template = self.env.get_template("invoice.html") context = { "invoice": invoice, "seller": invoice.seller_details, "buyer": invoice.buyer_details, "line_items": invoice.line_items, "bank_details": invoice.bank_details, "payment_terms": invoice.payment_terms, "footer_text": invoice.footer_text, "now": datetime.now(UTC), } return template.render(**context) def get_pdf_path(self, invoice: Invoice) -> str | None: """Get the PDF path for an invoice if it exists.""" if invoice.pdf_path and Path(invoice.pdf_path).exists(): return invoice.pdf_path return None def delete_pdf(self, invoice: Invoice, db: Session) -> bool: """Delete the PDF file for an invoice.""" if not invoice.pdf_path: return False pdf_path = Path(invoice.pdf_path) if pdf_path.exists(): try: pdf_path.unlink() logger.info(f"Deleted PDF for invoice {invoice.invoice_number}") except OSError as e: logger.error(f"Failed to delete PDF {pdf_path}: {e}") return False invoice.pdf_path = None invoice.pdf_generated_at = None db.flush() return True def regenerate_pdf(self, db: Session, invoice: Invoice) -> str: """Force regenerate PDF for an invoice.""" return self.generate_pdf(db, invoice, force_regenerate=True) # Singleton instance invoice_pdf_service = InvoicePDFService()