Django公式サイトのチュートリアルを咀嚼しながらやってみる

# 質問
class Question(models.Model):

    #（省略）

    # 最近公開されたものか判別するメソッド (boolean)
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
        # 公開日時が1日前よりあとかどうかだけを見ているので、
        # 未来の日付を設定した場合も True が返される。
        # 本来なら未来の公開日時になっているものは非表示でなければならない。

#（省略）

% python manage.py shell

>>> import datetime
>>> from django.utils import timezone
>>> from polls.models import Question

>>> # create a Question instance with pub_date 30 days in the future
>>> # pub_date が30日分未来になっている Question インスタンスを作成します。
>>> future_question = Question(pub_date=timezone.now() + datetime.timedelta(days=30))

>>> # was it published recently?
>>> # 最近公開されましたか？
>>> future_question.was_published_recently()
True

import datetime

from django.test import TestCase
from django.utils import timezone

from .models import Question

class QuestionModelTests(TestCase):
    def test_was_published_recently_with_future_question(self):
        # was_published_recently() returns False for questions whose pub_date
        # is in the future.
        # was_published_recently() は pub_date が未来の場合は False を返します。

        time = timezone.now() + datetime.timedelta(days=30)
        future_question = Question(pub_date=time)
        self.assertIs(future_question.was_published_recently(), False)
        # unittest --- ユニットテストフレームワーク — Python 3.9.4 ドキュメント
        # https://docs.python.org/ja/3/library/unittest.html#unittest.TestCase.debug

% python manage.py test poll

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
F
======================================================================
FAIL: test_was_published_recently_with_future_question (polls.tests.QuestionModelTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/testsite/mysite/polls/tests.py", line 17, in test_was_published_recently_with_future_question
    self.assertIs(future_question.was_published_recently(), False)
AssertionError: True is not False

----------------------------------------------------------------------
Ran 1 test in 0.002s

FAILED (failures=1)
Destroying test database for alias 'default'...

#（省略）

    # 最近公開されたものか判別するメソッド (boolean)
    def was_published_recently(self):
        now = timezone.now()
        # return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
        return now - datetime.timedelta(days=1) <= self.pub_date <= now
        # 公開日時 pub_date が1日前より未来、かつ、現在より過去であるかどうかを判定する。
        # 1日以内だったら true、そうでなければ false を返す。

#（省略）

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
.
----------------------------------------------------------------------
Ran 1 test in 0.001s

OK
Destroying test database for alias 'default'...

#（省略）

    def test_was_published_recently_with_old_question(self):
        # was_published_recently() returns False for questions whose pub_date
        # is older than 1 day.
        # was_published_recently() は pub_date が1日以上前だった場合に False を返します。
        time = timezone.now() - datetime.timedelta(days=1, seconds=1)
        old_question = Question(pub_date=time)
        self.assertIs(old_question.was_published_recently(), False)

    def test_was_published_recently_with_recent_question(self):
        # was_published_recently() returns True for questions whose pub_date
        # is within the last day.
        # was_published_recently() は pub_date が
        # 最終日中（過去24時間未満）だった場合に True を返します。
        time = timezone.now() - datetime.timedelta(hours=23, minutes=59, seconds=59)
        recent_question = Question(pub_date=time)
        self.assertIs(recent_question.was_published_recently(), True)

#（省略）

% python manage.py shell

>>> # setup_test_environment でテスト環境を作成。
>>> from django.test.utils import setup_test_environment
>>> setup_test_environment()

>>> from django.test import Client
>>> # create an instance of the client for our use
>>> # 使用するクライアントのインスタンスを作成します
>>> client = Client()

>>> # get a response from '/'
>>> # '/' からレスポンスを取得します
>>> response = client.get('/')
Not Found: /

>>> # we should expect a 404 from that address; if you instead see an
>>> # "Invalid HTTP_HOST header" error and a 400 response, you probably
>>> # omitted the setup_test_environment() call described earlier.
>>> # そのアドレスからは404が予期されます。代わりに "Invalid HTTP_HOST header" エラー
>>> # と400レスポンスが表示される場合は、前述のsetup_test_environment（）の呼び出しを
>>> # 省略した可能性があります。
>>> response.status_code
404

>>> # on the other hand we should expect to find something at '/polls/'
>>> # we'll use 'reverse()' rather than a hardcoded URL
>>> # 一方、'/polls/'ではなにか表示されることが予想されます。
>>> # ハードコードされたURLではなく 'reverse()' を使用します。
>>> from django.urls import reverse
>>> response = client.get(reverse('polls:index'))
>>> response.status_code
200
>>> response.content
b'\n    <ul>\n    \n        <li><a href="/polls/1/">What's up?</a></li>\n    \n    </ul>\n'
>>> response.context['latest_question_list']
<QuerySet [<Question: What's up?>]>

from django.http import HttpResponseRedirect
from django.shortcuts import get_object_or_404, render
from django.urls import reverse
from django.views import generic
from django.utils import timezone #追加

from .models import Choice, Question

# インデックス ページ
class IndexView(generic.ListView):

    # （省略）

    # 表示する queryset を設定
    def get_queryset(self):
        # """Return the last five published questions."""
        # return Question.objects.order_by('-pub_date')[:5]

        """
        Return the last five published questions (not including those set to be
        published in the future).
        """
        return Question.objects.filter(
            pub_date__lte = timezone.now()
            # SQLでいうと SELECT ... WHERE pub_date <= timezone.now();
            # QuerySet API reference | Django ドキュメント | Django - Field lookups
            # https://docs.djangoproject.com/ja/3.2/ref/models/querysets/#field-lookups
        ).order_by('-pub_date')[:5]

import datetime

from django.test import TestCase
from django.utils import timezone
from django.urls import reverse #追加

#（省略）

def create_question(question_text, days):
    """
    Create a question with the given `question_text` and published the
    given number of `days` offset to now (negative for questions published
    in the past, positive for questions that have yet to be published).
    与えられた `question_text` で質問を作成し、与えられた `days` のぶんだけ
    現在までオフセットして公開します（過去に公開された質問はマイナス、
    まだ公開されていない質問はプラス）。
    """
    time = timezone.now() + datetime.timedelta(days=days)
    return Question.objects.create(question_text=question_text, pub_date=time)

class QuestionIndexViewTests(TestCase):
    def test_no_questions(self):
        """
        If no questions exist, an appropriate message is displayed.
        質問が存在しない場合は、適切なメッセージが表示されます。
        """
        response = self.client.get(reverse('polls:index'))
        self.assertEqual(response.status_code, 200)
        # レスポンスに指定の文字列が含まれているか
        self.assertContains(response, "No polls are available.")
        # クエリセットのコンテキストに指定のデータが含まれているか
        self.assertQuerysetEqual(
            response.context['latest_question_list'],
            []
        )
    
    def test_past_question(self):
        """
        Questions with a pub_date in the past are displayed on the
        index page.
        過去の pub_date をもつ質問はインデックスページに表示されます。
        """
        question = create_question(question_text="Past question.", days=-30)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_question_list'],
            [question],
        )

    def test_future_question(self):
        """
        Questions with a pub_date in the future aren't displayed on
        the index page.
        未来の pub_date をもつ質問はインデックスページに表示されません。
        """
        create_question(question_text="Future question.", days=30)
        response = self.client.get(reverse('polls:index'))
        self.assertContains(response, "No polls are available.")
        self.assertQuerysetEqual(
            response.context['latest_question_list'],
            []
        )

    def test_future_question_and_past_question(self):
        """
        Even if both past and future questions exist, only past questions
        are displayed.
        過去と未来両方の質問が存在する場合でも、過去の質問のみが表示されます。
        """
        question = create_question(question_text="Past question.", days=-30)
        create_question(question_text="Future question.", days=30)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_question_list'],
            [question],
        )

    def test_two_past_questions(self):
        """
        The questions index page may display multiple questions.
        質問のインデックスページには複数の質問が表示されるはずです。
        """
        question1 = create_question(question_text="Past question 1.", days=-30)
        question2 = create_question(question_text="Past question 2.", days=-5)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_question_list'],
            [question2, question1],
        )

#（省略）

# 詳細 ページ
class DetailView(generic.DetailView):
    model = Question
    template_name = 'polls/detail.html'

    def get_queryset(self):
        """
        Excludes any questions that aren't published yet.
        まだ公開されていない質問を除外します
        """
        return Question.objects.filter(pub_date__lte=timezone.now())

#（省略）

#（省略）

class QuestionDetailViewTests(TestCase):
    def test_future_question(self):
        """
        The detail view of a question with a pub_date in the future
        returns a 404 not found.
        未来のpub_dateを持つ質問の詳細ビューは 404 not found を返します。
        """
        future_question = create_question(question_text='Future question.', days=5)
        url = reverse('polls:detail', args=(future_question.id,))
        response = self.client.get(url)
        self.assertEqual(response.status_code, 404)

    def test_past_question(self):
        """
        The detail view of a question with a pub_date in the past
        displays the question's text.
        過去のpub_dateを持つ質問の詳細ビューは質問のテキストを表示します。
        """
        past_question = create_question(question_text='Past Question.', days=-5)
        url = reverse('polls:detail', args=(past_question.id,))
        response = self.client.get(url)
        self.assertContains(response, past_question.question_text)