このドキュメントでは、Django のビューを使用して PDF ファイルを動的に出力する方法を説明します。これは、優れたオープンソースの Python PDF ライブラリ ReportLab により可能になっています。
\nPDF ファイルを動的に生成する利点は、異なる目的のためにカスタマイズされた PDF を作成できることです。たとえば、異なるユーザーや異なるコンテンツを使用して生成できます。
\nたとえば、kusports.com では、March Madness コンテストに参加する人たちのために、カスタマイズされたプリンター向けの NCAA トーナメントブラケットを PDF ファイルとして生成するのに Django が使われていました。
\nReportLab ライブラリは、PyPI で利用できます。ユーザーガイド (偶然ではなく PDF で提供されています) もダウンロードして利用できます。ReportLab は pip により次のコマンドでインストールできます。
Linux / macOS
$ python -m pip install reportlab\nWindows
...\\> py -m pip install reportlab\nPython の対話的インタープリタ内でインポートすることでインストールをテストします。
\n>>> import reportlab\nこのコマンドが何もエラーを起こさなければ、インストールは機能しています。
\nDjango で PDF を動的に生成するときに重要な点は、ReportLab API がファイルライクなオブジェクトとして振る舞い、Django の FileResponse オブジェクトがファイルライクなオブジェクトを受け取るということです。
ここに、"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")\nコードとコメントが自分自身の意味を説明しているはずですが、いくつかの点には言及しておくべきでしょう。
\nレスポンスはファイル名の拡張子に基づいて自動的にMIMEタイプ application/pdf を設定します。これはブラウザに、ドキュメントがHTMLファイルや一般的な application/octet-stream バイナリコンテンツではなく、PDFファイルであることを伝えます。
as_attachment=True が FileResponse に渡されると、適切な Content-Disposition ヘッダが設定され、ウェブブラウザはそのマシンでデフォルトが設定されていたとしても、そのドキュメントをどのように扱うかを確認するダイアログボックスをポップアップするようになります。もし as_attachment パラメータが省略された場合、ブラウザはPDFを扱うために設定されたプログラムやプラグインを使ってPDFを扱います。
任意の filename パラメータを指定できます。これはブラウザの "名前を付けて保存" ダイアログで使用されます。
ReportLab API にフックできます: canvas.Canvas の第一引数に渡されたバッファと同じバッファを FileResponse クラスに渡すことができます。
後続のPDF生成メソッドはすべて、PDFオブジェクト（この場合は p ）に対して呼び出され、 buffer に対して呼び出されるのではないことに注意してください。
最後に、PDFファイル上で showPage() と save() を呼び出すことが重要です。
これらの例には PDF 固有のものはあまりないことに注意してください -- reportlab を使った部分だけです。同じようなテクニックを使って、Pythonのライブラリがあれば任意のフォーマットを生成できます。また、 CSVを出力する にも別の例とテキストベースのフォーマットを生成するときに使えるテクニックがあります。