Building Software II : commit Add functional_tests.py and user story

https://github.com/poklonas/django_5810164/commit/c705d87a0f288845d8fc0da5079c6d5e925591dc

Building Software II : Test-Driver Development With python Tutorial .2

สิ่งที่ได้เรียนรู้เพิ่มเติมจาก บท

CH4 :

 - Don't test constants and test HTML as text
 - refactoring การปรับปรุง ให้ดียิ่งขึ้น

When refactoring, work on either the code or the tests, but not both at once.
การปรับปรุง เกิดขึ้นในตอน เขียนโค้ด หรือ การทดสอบ แต่ จะไม่เกิดขึ้นพร้อมกัน


ขั้นตอนการทำงาน เพิ่มเติม
  1 . ทำ functional_tests
  2 . Unit tests
  3 . (unit_test / code cycle)
  4 . refactoring ปรับปรุง พัฒนา (เปลี่ยนโค้ด แต่การทำงานเหมือนเดิม)
เช่น a = a + 1 อาจจะเป็น a += 1 ?

ทำฟังก์ชั่นเทส ไม่เจอข้อผิดพลาด ? > จะปรับปรุงโค้ดมั้ย ?
            เจอ ไป ทำการแก้ไขใน Unit test
unit test เจอข้อผิดพลาด > แก้ไข > ปรับปรุงโค้ดมั้ย ?
        ไม่เจอ > ทำ unit test ที่ละเอียดขึ้น
แล้วก็วนไปที่ฟังก์ชั่นเทสใหม่เมื่อจบกระบวนการ

CH 5 :

    import time
    time.sleep(10)

ช่วยในการยื้อเวลาเพื่อช่วยในการ สังเกตุหน้าผลลัพธ์ ได้ ก่อนที่ เบราเซอร์จะปิดลง

{% csrf_token %}

นั้นเป็น input ชนิด hidden (ดังนั้นการเทส จะมีปัญหาเนื่องจากมันจะเป็นการสุ่มตลอด)

render_to_string

ใช้สำหรับแปลง เป็น string โดย ต้องใส่ argument คือ template กับ ตัวแปรที่จะใช้แทนค่า

    return render(request, 'home.html', {
        'new_item_text': request.POST.get('item_text', ''),
    })

เพิ่งรู้ว่าสามารถ กำหนด ค่า default ให้ get ได้ https://docs.python.org/3/library/stdtypes.html#dict.get

Red / Green / Refactor and Triangulation
The unit-test/code cycle

1 . เขียน Unit test (ที่มันเฟล ) (Red)
2 . ทำวิธีที่ง่ายที่จะทำให้มันผ่าน (Green) ถึงแม้ ว่ามันจะเป็นการโกงก็ตาม
3 . ทำให้โค้ดดูเข้าท่ามากกว่าเดิม หรือดูสมเหตุสมผลมากขึ้น

 Object-Relational Mapper (ORM)
Classes map to database tables, attributes map to columns, and an individual instance of the class represents a row of data in the database.

Unit test ไม่ควรจะไปยุ่งกับ Data base

integrated test เป็นการ ทดสอบที่ถูกต้องมากขึ้นโดยจะไม่ได้ตรวจสอบแค่ code แต่จะตรวจสอบอย่างอื่นเช่น data base ด้วย

 an HTTP redirect hould have status code 302


- ในการทดสอบแต่ละครั้ง ควรทดสอบ อย่างเดียวเท่านั้น เพื่อให้ง่ายต่อการตรวจสอบ

Unit test ใน Django ผ่าน ไม่ได้หมายความว่า functional_test จะผ่านด้วยเพราะว่า Django จะสร้าง ฐานข้อมูลพิเศษ สำหรับการใช้งาน TestCase เพื่อทดสอบ Unit test

Building Software II : Test-Driver Development With python Tutorial

http://chimera.labs.oreilly.com/books/1234000000754/ch01.html#_obey_the_testing_goat_do_nothing_until_you_have_a_test

จาก Text Book ด้านบน

สิ่งที่ได้เรียนรู้เพิ่มเติมจากการไปทดลองทำตาม (แบบเหมือนกันทุกขั้นตอน)

เพิ่มเติมคือได้นำไฟล์ geckodriver ไปไว้ใน 

/usr/local/bin

ของเครื่องด้วย

CH1 :

ได้ รู้จักการใช้งาน .gitignore แบบผ่าน commandline

CH2 :

Functional Test - การทดสอบภายใต้ มุมมอง ของผู้ใช้งาน (User โดยไม่รู้อะไรเกี่ยวกับ ระบบด้านในเลย) หรือเรียกได้หลายแบบเช่น Acceptance test , ene to end test ก็ได้เช่นกัน

เขาแนะนำว่า การเขียน คอมเม้น ของการ test แบบ นี้ เราควรจะเขียน ให้ สามารถอ่านได้เข้าใจง่ายว่า ทดสอบอะไรอยู่ อย่างในตัวอย่างเขาจะยกสถาณะการต่างๆ เลยว่า User คิดอย่างไรต้องการอย่างไร และ ทดสอบยังไง (เช่น เธอต้องการให้ title เว็ป เป็น To-Do list เป็นต้น ก็ได้ทำการทดสอบว่า

# She notices the page title and header mention to-do lists
assert 'To-Do' in browser.title

 เราไม่ควร คอมเม้น ในสิ่งที่ไร้สาระเช่น บอกว่า increase a by 1 เพราะ จากโค้ดที่ b += 1 เราก็ทราบอยู่แล้ว แต่เราควรจะบอกไปว่า + 1 เพื่ออะไร ทำใม

assert 'To-Do' in browser.title, "Browser title was " + browser.title

จากโค้ด ด้านบนจะเห็นว่าเราสามารถ ทำให้ AssertError เป็นไปตามที่เราต้องการได้
จากโค้ด ถ้ามัน Error จะขึ้น บอกว่า Browser title was ????


และต่อมา

from selenium import webdriver
import unittest

class NewVisitorTest(unittest.TestCase):  #

    def setUp(self):  #
        self.browser = webdriver.Firefox()

    def tearDown(self):  #
        self.browser.quit()

    def test_can_start_a_list_and_retrieve_it_later(self):  #
        # Edith has heard about a cool new online to-do app. She goes
        # to check out its homepage
        self.browser.get('http://localhost:8000')

        # She notices the page title and header mention to-do lists
        self.assertIn('To-Do', self.browser.title)  #
        self.fail('Finish the test!')  #

        # She is invited to enter a to-do item straight away
        [...rest of comments as before]

if __name__ == '__main__':  #
    unittest.main(warnings='ignore')  #

 
เมื่อเรารันไฟลฺ์ นี้ มันจำทำการ Test ทุกฟังก์ชั่นที่ขึ้นต้น ด้วย test_
และก่อนทำการ test จะใช้ฟังก์ชั่น setUp ก่อนทุกครั้ง และ เมื่อจบการ test หรือ error จะใช้งาน tearDown เมื่อเสร็จ
 ส่วน self.fail จะเป็นการ บังคับให้ error ได้

และได้เรียนรู้ Git -a เพิ่มมา (auto add any track)

User story - เรื่องราวของ ผู้ใช้งาน (เช่นต้องการอะไร เพราะอะไร ทำใม ใช้ในการเขียน comment และ เป็นแนวทางในการทดสอบ ระบบ จากมุมมองของผู้ใช้งาน)

CH3 :

การทดสอบต้องคิดเสมอว่า เราจะทดสอบอะไร ทำใม เพื่ออะไร เพื่อไม้ให้ เราทดสอบผิดพลาด(หรือผิดวัตถุ ประสงค์)

Unit test - เป็นการทดสอบใน มุมมอง ของผู้ พัฒนา หรือ เป็นการทดสอบจากด้านใน สนใจโครงสร้าง ของโค้ด ความถูกต้องของ การทำงาน โดยจะทดสอบ ทีละส่วน ย่อยๆ ของการทำงานเลย

ขั้นตอน คร่าวๆ

 1 ทดสอบจากมุมมองของ User ( functional_test ) พบ Bug ?!!!
 2 ทำการพยายามแก้ไขข้อผิดพลาดนั้น โดยการ ทดสอบในส่วนย่อยๆลงไปของโค้ด เพราะพยายามหาส่วนที่ทำงานผิดพลาดนั้นๆและแก้ไขมัน
 3 ถ้าพบ Unit test ไม่ผ่าน ก็ทำการทดสอบในขนาดที่เล็กลงไปอีก จนกว่าจะแก้ไขได้
[บางครั้งต้องทำ 2 3 วนไปเรื่อยๆ ] 
 4 ลองรัน functional_test อีกรอบ ถ้าผ่านก็ ถือว่าโอเค

ต่อมา เขา พูดถึงบทความว่า

Functional tests should help you build an application with the right functionality, and guarantee you never accidentally break it. Unit tests should help you to write code that’s clean and bug free.

ประมาณว่า functional test เนี่ยจะทำให้ แอผของเราเนี่ยทำงานได้ถูกต้อง และการันตีได้ว่า มันจะไม่มีข้อผิดพลาด ส่วน Unit test จะช่วยให้โค้ดเราเนี่ย มันไม่รก และไม่มีบัคนั้นเอง


ต่อมา พบว่า django มี ส่วนช่วยในการทำ Unit test อยู่แล้ว (ไฟล์ tests.py ใน folder app)
ซึ่งการรัน ทำได้โดยการพิม python3 manage.py test มันจะทำการทดสอบทุกๆฟังก์ชั่นที่ขึ้นต้องด้วย test

MVC ของ django จะแปลกๆ (ที่เรารู้ๆกันอยู่)

 model - model.py
 control - view.py
 view - template

ต่อมา หลังการทดลองไปเรื่อยๆ เขาพยายามจะสอนเราให้พยายามสังเกตุ error และ หาวิธีการแก้ไข ที่สั้นที่สุด(ง่าย) หรือ การค่อยๆปรับโค้ด เมื่อเราเจอ error ต่างๆ เช่นในตอนแรก เรายังไม่มี ฟังก์ชั่นในไฟล์ view เราก็ไปเพิ่มซะแล้วทำสอบต่อเลย ต่อมาก็เจอปัญหาที่ว่าไม่สามารถเปรียบเทียบ ข้อมูลที่เป็น None ได้ ก็ได้ทำให้มันกลายเป็น ฟังก์ชั่น return ข้อมูลกลับมาแทน เป็นต้น คือ ค่อยๆ แก้ไข ที่ละเล็กๆน้อยๆ

We can start to settle into the TDD unit-test/code cycle now:

1. In the terminal, run the unit tests and see how they fail.
2. In the editor, make a minimal code change to address the current test failure.

And repeat!

คือ Cycle ดังนี้

 1 ทำการ รัน UNIT TEST และพบว่ามัน fail

 2 ทำการแก้ไขให้สั้นที่สุด

ทำวนไปเรื่อยๆ

เน้น ว่า แก้ไข ให้สั้นที่สุดหรือน้อยที่สุดเท่าที่จะทำให้มันทำงานได้ !!

จากที่เขาให้ลองทำนั้นคือ เขาพยายาม แก้ไข น้อยมากคือตั้งแต่ พบว่า 

self.assertTrue(response.content.startswith(b'<html>'))

เขา ก็ทำการเพิ่มส่วนหน้า <html> ไปเท่านั้นและทำการทดสอบใหม่ทันทีแม้ว่าจะเห็นว่า มันไม่มีเนื้อหาด้านในอีกก็ได้(ซึ่งควรมี)

ซึ่งเขาก็จะเจอ assert error ที่เตือนว่าไม่มีเนื้อหาด้านในตามที่จะทบสอบ และเขาก็เพิ่มส่วนนั้นเข้าไปและทดสอบต่อทันทีเช่นเดิม

และต่อมาได้ เจอการใช้ git log --oneline เพิ่มขึ้นมาสำหรับดู log แบบบรรทัดเดียวต่อ 1 commit

CH4 :

Soon ..

[ ติดสอบ ] 

 

Building Software II : Tutorial ledger

ได้ ไปทำ Tutorial Ledger มา โดยในตอนนี้สามารถ

ทำให้สามารถสร้าง ผู้ใช้งานและ สร้างรายการ ได้แล้วว

https://github.com/poklonas/tutorial

Building Software II : Import CSV File , commit , Slide 2_3_2560

slide

https://drive.google.com/file/d/0B7asHdbzNieldk5rbmlUU096bms/view?usp=sharing

--------------------------------------------------------------------------------------

https://github.com/poklonas/django_5810164/commit/193fb6f8e9fc2a83097376e1a5fbbc3437e874ec

commit - for add csv to server and update to database

https://github.com/poklonas/django_5810164/commit/9a020f6b98be8697ceea708b9d6abe43ffde0f7c

commit - fix bug about type when dont have type like input

https://github.com/poklonas/django_5810164/commit/732fd565a4b6ab84ee7a5e4b4b95b7e5b1bd2aed

commit - use datetime.date.isoformat for format date