วันพุธที่ 1 มกราคม พ.ศ. 2557

Django Tutorial Part 5 - Automated Testing

     การทำ Web Application นั้นย่อมมีโอกาสที่จะเกิด Bug ต่างๆขึ้นได้ซึ่งถ้าหากเราต้องนั่งตรวจสอบเองทั้งหมดก็ย่อมทำได้ แต่หาก Web Application ของเรามีขนาดใหญ่ มีความซับซ้อนสูง การที่จะนั่งตรวจสอบเองย่อมไม่ใช่เรื่องง่าย ดังนั้นจึงมีวิธีในการตรวจสอบอย่างง่ายๆโดยการเขียน Test

---Automated Testing---

1.มาทดลองการทดสอบ Bug ด้วยตัวเองกันก่อน เริ่มต้นให้ใช้ Shell แล้วพิมคำสั่งดังนี้


    จะเห็นได้ว่า future_poll นั้นจะเป็น Poll ที่มีวันที่ในการ Published เป็นอีก 30 วันข้างหน้าและเมื่อเราเรียก was_published_recently นั้นควรจะได้ Output เป็น True ก็ต่อเมื่อเวลาที่ Published กับเวลา ณ ตอนเรียก was_published_recently นั้นห่างกันไม่เกิน 1 วันแต่เวลาที่ Published ของ future_poll นั้นเป็นอีก 30 วันข้างหน้าซึ่งไม่ควรจะได้ True แบบนี้นั่นเอง

2.แก้ไขไฟล์ tests.py ที่อยู่ในโฟลเดอร์ของ Poll ให้เป็นดังนี้
import datetime

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

from polls.models import Poll

class PollMethodTests(TestCase):

    def test_was_published_recently_with_future_poll(self):
        """
        was_published_recently() should return False for polls whose
        pub_date is in the future
        """
        future_poll = Poll(pub_date=timezone.now() + datetime.timedelta(days=30))
        self.assertEqual(future_poll.was_published_recently(), False)
    จาก โค้ดใน tests.py ที่เขียนไปนั้นเป็นการประกาศ future_poll ซึ่งให้วันที่ published เป็นอีก 30 วันข้างหน้าจากนั้น self.assertEqual นั้นจะนำเอา Output ที่ได้จากการเรียก future_poll.was_published_recently() มาเทียบว่าได้ False หรือไม่หากได้ False ก็จะเทสผ่าน หากไม่ได้ False ก็จะเกิด Error ฟ้อง Fail ขึ้น

จากนั้นใน terminal ลองพิมคำสั่ง python manage.py test polls จะได้ผลลัพธ์ดังนี้


    เหตุผลที่ FAIL นั้นก็เพราะ Test ที่เราเขียนกับผลของ was_published_recently นั้นไม่เป็นตามที่เรากำหนดไว้ซึ่งควรจะเป็น False แต่ได้ True นั่นเอง

3.แก้ไข Bug ของ was_published_recently โดยเข้าไปแก้ไข models.py ดังนี้
def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <  now
    จาก was_published_recently() ที่แก้ไขไปนั้นจะเป็นการเช็คว่าเวลาที่ published ไว้นั้นยังไม่เกินเวลาปัจจุบัน และยังไม่เกิน 1 วันก็จะ Return True แต่หากไม่เข้ากรณีใดกรณีนึงก็จะ Return False ทันที

จากนั้นลองพิมคำสั่ง python manage.py test polls จะได้ผลลัพธ์ดังนี้


    จากการที่เราแก้ไขใน was_published_recently() ไปแล้วนั้นทำให้ผลลัพธ์ที่ออกมานั้นถูกต้องผลการรัน tests เลยผ่านไม่เกิด Fail แบบในรอบที่แล้ว

4.เพิ่ม Test อีก 2 กรณีให้ Poll โดยแก้ไขไฟล์ tests.py ดังนี้
def test_was_published_recently_with_old_poll(self):
    """
    was_published_recently() should return False for polls whose pub_date
    is older than 1 day
    """
    old_poll = Poll(pub_date=timezone.now() - datetime.timedelta(days=30))
    self.assertEqual(old_poll.was_published_recently(), False)

def test_was_published_recently_with_recent_poll(self):
    """
    was_published_recently() should return True for polls whose pub_date
    is within the last day
    """
    recent_poll = Poll(pub_date=timezone.now() - datetime.timedelta(hours=1))
    self.assertEqual(recent_poll.was_published_recently(), True)
    ใน test_was_published_recently_with_old_poll นั้นสร้างตัวแปรชื่อ old_poll โดย published เป็นเวลา ณ ปัจจุบันแล้วลบออกไป 30 วัน ซึ่งผลลัพธ์ที่ได้ควรจะเป็น False
    ส่วน  test_was_published_recently_with_recent_poll จะมีตัวแปรชื่อ recent_poll ซึ่งเอาเวลาปัจจุบันลบออกไป 1 ชั่วโมงซึ่งผลลัพธ์ที่ควรได้จะเป็น True นั่นเอง

5.ลองทดสอบ Client ผ่าน Shell โดยพิมคำสั่งตามนี้







    จาก shell ที่รันนั้นจะเป็นการ get status จากการเรียกไปยัง Server ตาม html ที่กำหนดแล้วแสดงผลออกมาพร้อมกับสร้าง poll ขึ้นมาใหม่ 1 อันชื่อ Who is your favorite Beatle แล้วบันทึกลงใน DB ของเรา

6.ปรับปรุง view จะเห็นได้ว่ามีกรณีที่ published นั้นอาจจะอยู่ในอนาคตได้ดังนั้น published ที่อยู่ในอนาคตก็ไม่ควรจะแสดงผลในตอนนี้เช่นกัน ให้เข้าไปแก้ไข IndexView views.py ดังนี้

def get_queryset(self):
    """
    Return the last five published polls (not including those set to be
    published in the future).
    """
    return Poll.objects.filter(pub_date__lte=timezone.now()).order_by('-pub_date')[:5]
และเพิ่ม from django.utils import timezone เข้าไปด้วย
และเพิ่มส่วนทดสอบในไฟล์ tests.py เข้าไปด้วยดังนี้
from django.core.urlresolvers import reverse
def create_poll(question, days):
    """
    Creates a poll with the given `question` published the given number of
    `days` offset to now (negative for polls published in the past,
    positive for polls that have yet to be published).
    """
    return Poll.objects.create(question=question,
        pub_date=timezone.now() + datetime.timedelta(days=days))

class PollViewTests(TestCase):
    def test_index_view_with_no_polls(self):
        """
        If no polls exist, an appropriate message should be 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_poll_list'], [])

    def test_index_view_with_a_past_poll(self):
        """
        Polls with a pub_date in the past should be displayed on the index page.
        """
        create_poll(question="Past poll.", days=-30)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_poll_list'],
            ['<Poll: Past poll.>']
        )

    def test_index_view_with_a_future_poll(self):
        """
        Polls with a pub_date in the future should not be displayed on the
        index page.
        """
        create_poll(question="Future poll.", days=30)
        response = self.client.get(reverse('polls:index'))
        self.assertContains(response, "No polls are available.", status_code=200)
        self.assertQuerysetEqual(response.context['latest_poll_list'], [])

    def test_index_view_with_future_poll_and_past_poll(self):
        """
        Even if both past and future polls exist, only past polls should be
        displayed.
        """
        create_poll(question="Past poll.", days=-30)
        create_poll(question="Future poll.", days=30)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_poll_list'],
            ['<Poll: Past poll.>']
        )

    def test_index_view_with_two_past_polls(self):
        """
        The polls index page may display multiple polls.
        """
        create_poll(question="Past poll 1.", days=-30)
        create_poll(question="Past poll 2.", days=-5)
        response = self.client.get(reverse('polls:index'))
        self.assertQuerysetEqual(
            response.context['latest_poll_list'],
             ['<Poll: Past poll 2.>', '<Poll: Past poll 1.>']
        )
    โดย test_index_view_with_no_polls, test_index_view_with_a_future_poll ผลลัพธ์ที่ได้ต้องออกมาเป็น [] เพราะ Future ไม่ควรแสดงผล และ no_polls ย่อมต้องไม่มีอะไรมาแสดงแน่นอน

    ในส่วนของ test_index_view_with_future_poll_and_past_poll, test_index_view_with_a_past_poll ผลลัพธ์ที่ออกก็จะได้เป็น ['<Poll: Past poll.>'] เนื่องจากการแสดงผลจะต้องแสดงเฉพาะ poll ที่ published แล้วและวันที่ published ไม่ได้อยู่ในอนาคต

    สุดท้าย test_index_view_with_two_past_polls เมื่อมี poll 2 ที่ถูก published แล้ววันที่ published นั้นไม่ได้อยู่ในอนาคตผลลัพธ์ก็จะได้ออกมาเป็น ['<Poll: Past poll 2.>', '<Poll: Past poll 1.>']

    จากข้างต้นหาก test กรณีไหนแล้วไม่เป็นไปตามข้างต้นแล้วนะผลการ test จะออกมาก Fail แต่หากกรณีไหนตรงก็จะผ่านได้ซึ่งถ้ามีกรณีไหนผิดเราก็สามารถกลับไปแก้ไขในส่วนของ views.py ได้

7.ทดสอบ DetailView เริ่มโดยการเพิ่ม method เข้าไปใน Class DetailView ที่อยู่ภายใน views.py ดังนี้
def get_queryset(self):
    """
    Excludes any polls that aren't published yet.
    """
    return Poll.objects.filter(pub_date__lte=timezone.now())
และเพิ่มโค้ดเข้าไปใน tests.py ดังนี้
class PollIndexDetailTests(TestCase):
    def test_detail_view_with_a_future_poll(self):
        """
        The detail view of a poll with a pub_date in the future should
        return a 404 not found.
        """
        future_poll = create_poll(question='Future poll.', days=5)
        response = self.client.get(reverse('polls:detail', args=(future_poll.id,)))
        self.assertEqual(response.status_code, 404)

    def test_detail_view_with_a_past_poll(self):
        """
        The detail view of a poll with a pub_date in the past should display
        the poll's question.
        """
        past_poll = create_poll(question='Past Poll.', days=-5)
        response = self.client.get(reverse('polls:detail', args=(past_poll.id,)))
        self.assertContains(response, past_poll.question, status_code=200)
     เริ่มต้นที่ test_detail_view_with_a_future_poll ผลลัพทธ์ที่ได้ต้องได้ status_code เป็น 404 เพราะ future poll เราต้องไม่แสดงผลนั่นเอง

    จากนั้น test_detail_view_with_a_past_poll หากเป็น past poll นั้นผลลัพธ์ที่ได้ต้องได้ status_code เป็น 200 และแสดง question ด้วย

    จากข้างต้นหาก test กรณีไหนแล้วไม่เป็นไปตามข้างต้นแล้วนะผลการ test จะออกมาก Fail แต่หากกรณีไหนตรงก็จะผ่านได้ซึ่งถ้ามีกรณีไหนผิดเราก็สามารถกลับไปแก้ไขใน ส่วนของ views.py ได้

    จาก Tutorial Part 5 ที่ได้ทำมานั้นเราสามารถเขียนโค้ดเพื่อใช้ในการทดสอบว่า Web Application ของเรานั้นมี Bug หรือปัญหาที่ส่วนใดรึเปล่าซึ่งจะสะดวกมากในอนาคตหากโปรแกรมของเรามีขนาดใหญ่ ถ้าหากการแก้ไขจุดๆเดียวมีผลกับหลายๆที่ก็จะช่วยย่นระยะเวลาในการตรวจสอบโปรแกรมของเราลงไปได้อีกด้วย

ไม่มีความคิดเห็น:

แสดงความคิดเห็น