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