#5646: Add Testing Section
-------------------------------------+--------------------------------------
Reporter: [EMAIL PROTECTED] | Owner: nobody
Status: new | Component: Documentation
Version: SVN | Keywords:
Stage: Unreviewed | Has_patch: 0
-------------------------------------+--------------------------------------
As part of the "Your First App" - right after creating a model, a short
section should be included on how to set up and use a unit test. Here's
an example writeup of what we did (though we used the example of James
Bennett's to do list tutorial).
== Testing Your Models ==
Now that you have created a few models, it is important to create unit
tests to insure they work. This becomes more important later when you
make changes to your application and want to insure the changes work
before you upload them to the web. Django has built in unit testing that
makes this easy.
In your application directory, you need to create a "tests.py" file. In
this file you can include the following code:
import unittest
from todo.models import List
from todo.models import Item
class ListTestCase(unittest.TestCase):
def setUp(self):
self.testlist = List.objects.create(name='TestList')
def test_Name(self):
self.assertEquals(self.testlist.name, 'TestList')
class ItemTestCase(unittest.TestCase):
def setUp(self):
self.testlist = List.objects.create(name='TestList')
self.testitem = Count.objects.create(name="TestItem",
todo_list = self.testlist)
def test_Name(self):
self.assertEquals(self.testitem.name, 'TestItem')
The "def setUp(self)" function can be used to create an instance of the
model that can be used in the test functions that follow. So for the List
model, we create an instance named "testlist" and have set the object name
field with "TestList".
Actual test functions begin with "test" (an underscore is not necessary
but makes for easy code reading). In the test function, different
"assert" functions can be used - in this case an "assertEquals" function
is used to make a comparison of the name field in the created object
(testlist) with the actual phrase "TestList".
Now you run the tests at the command line by typing:
python manage.py test
If the object was created correctly, the names should match and you should
get a test passed response like :
Ran 2 tests in 0.003s
OK
otherwise Python and Django gives you pretty specific error messages.
Note that for the Item class test, you need to create an instance of a
List object, then create an Item object and fill in the "todo_list"
foreign key field with the name of the newly created list object. Note
that an object created in the first class does not extend to the 2nd
class. You don't need to create separate classes for each model but it
results in cleaner testing and coding.
--
Ticket URL: <http://code.djangoproject.com/ticket/5646>
Django Code <http://code.djangoproject.com/>
The web framework for perfectionists with deadlines
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
