Αυτό το άρθρο εξηγεί πως να εξάγετε αρχεία PDF, δυναμικά, χρησιμοποιώντας τα Django views. Αυτό είναι εφικτό, με τη χρήση της εξαιρετικής, ανοιχτού λογισμικου PDF βιβλιοθήκης της Python, ReportLab.
\nΤο πλεονέκτημα της παραγωγής δυναμικών αρχείων PDF είναι ότι μπορείτε να δημιουργείτε παραμετροποιήσιμα PDFs για διαφορετικούς σκοπούς – πχ, για διαφορετικούς χρήστες ή διαφορετικά κομμάτια δεδομένων.
\nΓια παράδειγμα, το Django χρησιμοποιήθηκε στο kusports.com για να παράγει παραμετροποιήσιμα, φιλικά προς εκτύπωση αποτελέσματα αγώνων μπάσκετ (NCAA tournament brackets), ως αρχεία PDF, για αυτούς που συμμετέχουν στον διαγωνισμό March Madness.
\nΗ βιβλιοθήκη ReportLab είναι διαθέσιμη στο PyPI. Ένας οδηγός χρήστη (όχι τυχαία, ένα PDF αρχείο) είναι επίσης διαθέσιμο για download. Μπορείτε να εγκαταστήσετε το ReportLab με το pip:
Linux / macOS
$ pip install reportlab\nWindows
...\\> pip install reportlab\nΕλέγξτε την εγκατάσταση της βιβλιοθήκης κάνοντας την import στο Python interactive shell σας (αν την έχετε εγκαταστήσει globally, τότε σε κονσόλα γράψτε πρώτα python ή python3.x όπου x η έκδοση Python που χρησιμοποιείτε):
>>> import reportlab\nΑν αυτό δεν σας εμφανίσει κάποιο σφάλμα, η βιβλιοθήκη έχει εγκατασταθεί επιτυχώς.
\nThe key to generating PDFs dynamically with Django is that the ReportLab API\nacts on file-like objects, and Django’s FileResponse\nobjects accept file-like objects.
Εδώ φαίνεται το κλασικό παράδειγμα «Hello World»:
\nimport io\nfrom django.http import FileResponse\nfrom reportlab.pdfgen import canvas\n\ndef some_view(request):\n # Create a file-like buffer to receive PDF data.\n buffer = io.BytesIO()\n\n # Create the PDF object, using the buffer as its "file."\n p = canvas.Canvas(buffer)\n\n # Draw things on the PDF. Here's where the PDF generation happens.\n # See the ReportLab documentation for the full list of functionality.\n p.drawString(100, 100, "Hello world.")\n\n # Close the PDF object cleanly, and we're done.\n p.showPage()\n p.save()\n\n # FileResponse sets the Content-Disposition header so that browsers\n # present the option to save the file.\n buffer.seek(0)\n return FileResponse(buffer, as_attachment=True, filename='hello.pdf')\nΠαρόλο που ο κώδικας και τα σχόλια είναι αρκετά επεξηγηματικά, θα πρέπει να αναφέρουμε μερικά πράγματα:
\nThe response will automatically set the MIME type application/pdf\nbased on the filename extension. This tells browsers that the document is a\nPDF file, rather than an HTML file or a generic application/octet-stream\nbinary content.
When as_attachment=True is passed to FileResponse, it sets the\nappropriate Content-Disposition header and that tells Web browsers to\npop-up a dialog box prompting/confirming how to handle the document even if a\ndefault is set on the machine. If the as_attachment parameter is omitted,\nbrowsers will handle the PDF using whatever program/plugin they’ve been\nconfigured to use for PDFs.
You can provide an arbitrary filename parameter. It’ll be used by browsers\nin the «Save as…» dialog.
Hooking into the ReportLab API is easy: The same buffer passed as the first\nargument to canvas.Canvas can be fed to the\nFileResponse class.
Note that all subsequent PDF-generation methods are called on the PDF\nobject (in this case, p) – not on buffer.
Στο τέλος είναι σημαντικό να καλέσετε τις μεθόδους showPage() και save() στο PDF object.
Όπως είδατε, δεν υπάρχει κάτι συγκεκριμένο με το PDF εδώ – μόνο τα κομμάτια που χρησιμοποιούν τη βιβλιοθήκη reportlab. Μπορείτε να χρησιμοποιήσετε κάποια παρόμοια τεχνική για να εξάγετε οποιαδήποτε μορφή τύπου κειμένου, αρκεί να υπάρχει μια Python βιβλιοθήκη που να την υποστηρίζει. Δείτε στο άρθρο εξάγοντας αρχεία CSV με το Django για ένα άλλο παράδειγμα και μερικές τεχνικές που μπορείτε να χρησιμοποιήσετε όταν παράγετε αρχεία με μορφή τύπου κειμένου.