Este documnto explica como gerar arquivos PDF dinamicamente usando “views” Django. Isso é possível através da excelente, biblioteca Python de código-aberto RepostLab .
\nA vantagem de gerar arquivos PDF dinamicamente é que você pode criar PDFs personalizados para diferentes propósitos – vamos dizer, para diferentes usuários ou diferentes partes de conteúdo.
\nPor exemplo, o DJango foi usado no kusports.com para gerar relatórios personalizados, prontos para impressão, de pontuação de torneio da NCAA, como arquivos PDF, para pessoas que participam do concurso March Madness.
\nThe ReportLab library is available on PyPI. A user guide\n(not coincidentally, 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\nSe o comando não emitir nenhum erro, a instalação funciona.
\nA chave para gerar PDFs dinamicamente com Django é que a API do ReportLab atua em objetos tipo arquivo, e objetos da classe do Django FileResponse aceitam objetivos tipo arquivo.
Aqui um exemplo “Hello World”:
\nimport io\nfrom django.http import FileResponse\nfrom reportlab.pdfgen import canvas\n\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")\nO código e comentário devem ser auto-explanaveis, mas algumas coisas merecem uma menção.
\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.
Você pode fornecer um parâmetro filename arbitrário. Ele será usado para os navegadores na caixa de diálogo “Salvar como…”.
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 que todas os methods de geração de PDF subsequentes são chamados no objeto PDF (nesse caso, p) – não no buffer.
E finalmente, é importante chamar showPage() e o save() no arquivo PDF.
Note que não tem muito nestes exemplos que seja especificamente sobre PDF – apenas as partes usando reportlab. Você pode usar técnicas similares para gerar qualquer outro formato arbitrário para a qual você encontre uma bilioteca Python. Veja também How to create CSV output para outro exemplo e algumas técnicas que você pode usar quando quiser gerar fomatos baseados em texto.