Djangoで各オブジェクトに格納されている値を確認したい（＝デバッグしたい）

Question

##■質問
以下、app名/templates/diary_list.htmlというテンプレートの{% for diary in diary_list %}という記述の、diary_listという変数にどんな値が入っているのか確認する方法（＝デバッグ方法）やヒントを教えていただけますでしょうか。

正しいデバッグ方法も知らない素人ですが、説明不足な点などは適宜追記して参りますので、どうぞよろしくお願い申し上げます。

<!-- diary/templates/diary_list.html-->

{% for diary in diary_list %}
  <div class="post-preview">
    <a href="{% url 'diary:diary_detail' diary.pk %}">
      <h2 class="post-title">
        {{ diary.title }}
      </h2>
      <h3 class="post-subtitle">
        {{ diary.content|truncatechars:20 }}
      </h3>
    </a>
    <p class="post-meta">{{ diary.created_at }}</p>
  </div>
  <hr>
    {% empty %}
  <p>日記がありません</p>
{% endfor %}

##■やってみたこと
試しにmanage.py runserverでDjangoを起動中にpython manage.py shellコマンドでprint(diary_list)してみましたが未定義エラーが出ます。

>>> print(diary_list)
Traceback (most recent call last):
  File "<console>", line 1, in <module>
NameError: name 'diary_list' is not defined

#####きっかけ
以下の構成で、なぜviews.pyでcontextも指定されていないのにtemplateのdiary_list変数でDiaryモデルのリストオブジェクトが取得できるのか、わかりませんでしたので、まずはdiary_list変数に格納されている値をprintでシンプルに表示したいと考えました。

# diary/urls.py

（略）

app_name = 'diary'
urlpatterns = [
（略）
    path('diary-list/', views.DiaryListView.as_view(), name="diary_list"),   
（略）
]

# diary/views.py

（略）
class DiaryListView(LoginRequiredMixin, generic.ListView):
    model = Diary
    template_name = 'diary_list.html' 
（略）    

# diary/models.py

class Diary(models.Model):
    user = models.ForeignKey(CustomUser, verbose_name='ユーザー', on_delete=models.PROTECT)
    title = models.CharField(verbose_name='タイトル', max_length=40)
    content = models.TextField(verbose_name='本文', blank=True, null=True)
    photo1 = models.ImageField(verbose_name='写真1', blank=True, null=True)
    photo2 = models.ImageField(verbose_name='写真2', blank=True, null=True)
    photo3 = models.ImageField(verbose_name='写真3', blank=True, null=True)
    created_at = models.DateTimeField(verbose_name='作成日時', auto_now_add=True)
    updated_at = models.DateTimeField(verbose_name='更新日時', auto_now=True)
    
    class Meta:
        verbose_name_plural = 'Diary'

    def __str__(self):
        return self.title

#####参考: 現状での私の認識

• urls.pyでdiary_listというname属性が定義され、DiaryListViewというビューと、diary-list/というURLが、そのname属性に紐付けられている
• print(diary_list)をエラーなく実行できれば、おそらくdiary_listに格納されたリストオブジェクトが返ってくると想像
• diary_list変数でDiaryモデルを参照できる理由がよくわからない（DiaryListViewの中で、Diaryモデルがmodel変数に設定されて、間接的にdiary_list変数 - DiaryListView - Diaryテーブルという構造で結びついているから？）

Answer 1

本題: リクエスト処理のデバッグ

Djangoにはdjango shellなどに使えるClientクラスが存在します。
django-shell実行中にこれを使って中で定義したURLにリクエストを行うことで、
通常のレスポンスコンテンツだけでなくテンプレートに渡す内容などの確認も出来ます。

>>> from django.test import Client
>>> from django.urls import reverse
>>> client = Client()
>>> response = client.get(reverse("diary:diary_list"))
>>> response.context["diary_list"]

Djangoドキュメントのチュートリアルにはviewsのテストについてのセクションもあるので、読んでみるとよいかと思います。

なお、shell上での動作確認だけだと、コードの修正確認が手間になるので、ある程度したら挙動確認用にテストコードを書く方法をお勧めします。
※チュートリアルにはテストの書き方や実行のガイドが載っています

補題: DiaryListView(modelを利用するクラスview)はどのようにしてテンプレート変数を決めているか

DjangoのクラスベースViewがテンプレートに何を渡すかを見たいときは、そのクラスにあるget_context_dataというメソッドを追うと良いです。

今回のクラスだと、

DiaryListView -> ListView -> BaseListView -> MultipleObjectMixin

と追うことができます。
（ListViewから先は、djangoのソースです。GitHubだとここ）

MultipleObjectMixinで初めてget_context_dataを見つけることが出来ます。
この処理の過程で、Viewに指定したmodelを元に、xxxx_listという変数を用意していることがわかります。
（context_object_nameという部分です）

Comments

[fukazume]

お返事が遅くなり、大変申し訳ございません。素晴らしいご回答をいただき誠にありがとうございます！django shell、存じ上げませんでした！これで自分の想像だけで値を仮定して闇雲にrunserverを連発してエラー潰ししている現状を劇的に改善できそうな気がします！

補題の件、おそらくobject_listという変数名が既定なんですね。こういった暗黙の命名規則？に関して現在演習に使っている教則本では一切触れられていなかったのでattakeiさんのアドバイスが大変参考になりました！

感謝感謝でございます！m(._.)m

[fukazume]

結果だけでなく、どうしてこうなるかという論理プロセスも順序立ててご解説いただくには相応のお時間を要されたと想像いたします。改めてありがとうございました！