このチュートリアルは チュートリアル その7 の続きです。ここまでに、Web 投票アプリケーションを構築したので、次はサードパーティのパッケージを見てみましょう。Django の強みの一つは、サードパーティ製パッケージの豊富なエコシステムです。サードパーティパッケージはコミュニティが開発したパッケージで、 アプリケーションの機能セットを素早く改善するために利用することができます。
\nこのチュートリアルでは、よく使われるサードパーティパッケージである、 Django Debug Toolbar の追加方法を紹介します。 Django Debug Toolbar は、近年の Django Developers Survery において、もっともよく利用されたサードパーティパッケージのトップ3にランクインしています。
\n\nDjango Debug ToolbarはDjango Webアプリケーションをデバッグするのに有用なツールです。このサードパーティ製パッケージは、 Jazzband という組織によって保守されています。ツールバーでは現在のリクエストとレスポンスに関するデバッグ情報を提供するパネルが表示されます。これらのパネルは、アプリケーションの機能を理解し、問題を特定するのに役立ちます。
\nこのツールバーのようなサードパーティ製パッケージをインストールするためには、有効化した仮想環境内で、以下に示すコマンドを実行して、パッケージをインストールする必要があります。これは、以前の Djangoのインストール のステップと似ています。
\nLinux / macOS
$ python -m pip install django-debug-toolbar\nWindows
...\\> py -m pip install django-debug-toolbar\nDjangoと統合するサードパーティ製パッケージは、あなたのプロジェクトと統合するために、インストール後にいくつか設定を追加する必要があります。多くの場合、パッケージに含まれるDjangoアプリケーションを INSTALLED_APPS 設定に追加する必要があります。URFconf (urls.py)への追加のように、それ以外の変更を必要とするパッケージもあります。
Django Debug Toolbar の利用には、いくつかのセットアップ手順が必要です。 パッケージのインストールガイド に従ってください。サードパーティ製パッケージはDjangoの予定とは独立して変更が加えられるので、インストールガイドが示す手順はチュートリアルの内容とは重複しません。
\nインストール後、投票アプリケーションをリロードすると、ブラウザウインドウの右側にDjDTの"ハンドル"が表示されるようになります。これをクリックするとデバッグツールバーが開き、各パネルのツールを使うことができます。パネルに表示される項目の詳細については、パネルのドキュメントページ を参照してください。
\n例えば、ツールバーがレンダリングされない、などの問題が発生することがあります。こうした問題が発生し、自分で解決できない場合、次の方法を試すことができます。
\n特定のパッケージに発生する問題であれば、そのパッケージのドキュメントにトラブルシューティングのFAQがあるかどうか確認してください。例えば、Django Debug Toolbarでは ヒントセクション にトラブルシューティングの方法がまとめられています。
パッケージの課題トラッカーに、類似の課題を検索してみてください。Django Debug Toolbarの場合は、 GitHub 上にあります。
Djangoフォーラム で相談してください。
Django Discord サーバー に参加してください。
Libera.chat の#Django IRC チャンネルに参加してください。
他にもたくさんのサードパーティ製パッケージを、素晴らしいDjangoリソースである Django Packages で見つけることができます。
\nどのようなサードパーティ製パッケージを使うべきかを判断するのは難しいかもしれません。これは、あなたのニーズや目標によります。アルファ版のパッケージを使うこともできます。また、本番環境で使えるかどうかを確認する必要がある場合もあります。 アダム・ジョンソン氏のブログ に、パッケージが「よく保守されているか」を判断するための特徴をまとめています。Django Packages では、パッケージの最終更新日など、これらの特徴のいくつかのデータを表示しています。
\nアダムが彼の投稿で指摘しているように、挙げられている問いに対する答えが一つでも「ノー」であれば、それはパッケージに貢献するチャンスです。
\nこれで、初めての人のためのチュートリアルはおしまいです。次のステップへ では、ここから進める場所について説明しています。
\nPython のパッケージングについて知っていて、polls アプリケーションを「再利用可能なアプリケーション」へと変える方法について学びたい場合は、チュートリアル 応用編: 再利用可能なアプリケーションの書き方 を読んでみてください。
\n