This document explains how to output PDF files dynamically using Django views.\nThis is made possible by the excellent, open-source ReportLab Python PDF\nlibrary.
\nThe advantage of generating PDF files dynamically is that you can create\ncustomized PDFs for different purposes – say, for different users or different\npieces of content.
\nFor example, Django was used at kusports.com to generate customized,\nprinter-friendly NCAA tournament brackets, as PDF files, for people\nparticipating in a March Madness contest.
\nThe ReportLab library is available on PyPI. A user guide (not\ncoincidentally, a PDF file) is also available for download.\nYou can install ReportLab with pip:
Linux / macOS
$ python -m pip install reportlab\nWindows
...\\> py -m pip install reportlab\nTest your installation by importing it in the Python interactive interpreter:
\n>>> import reportlab\nJeśli to polecenie nie pokazało żadnego błędu, instalacja przebiegła pomyślnie.
\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.
Oto przykład „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')\nThe code and comments should be self-explanatory, but a few things deserve a\nmention:
\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\napplication/octet-stream binary 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.
You can hook into the ReportLab API: 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.
Ostatecznie, to ważne, aby wywołać showPage() i save() na pliku PDF
Notice that there isn’t a lot in these examples that’s PDF-specific – just the\nbits using reportlab. You can use a similar technique to generate any\narbitrary format that you can find a Python library for. Also see\nTworzenie plików CSV w Django for another example and some techniques you can use\nwhen generated text-based formats.