2007-03-01 13:11:08 +00:00
"""
2007-03-23 20:17:04 +00:00
37. Fixtures .
2007-03-01 13:11:08 +00:00
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
Fixtures are a way of loading data into the database in bulk . Fixure data
can be stored in any serializable format ( including JSON and XML ) . Fixtures
2007-03-01 13:11:08 +00:00
are identified by name , and are stored in either a directory named ' fixtures '
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
in the application directory , on in one of the directories named in the
2008-08-12 14:15:38 +00:00
` ` FIXTURE_DIRS ` ` setting .
2007-03-01 13:11:08 +00:00
"""
from django . db import models
2007-09-16 10:04:03 +00:00
from django . conf import settings
2007-03-01 13:11:08 +00:00
2009-02-28 05:35:22 +00:00
class Category ( models . Model ) :
title = models . CharField ( max_length = 100 )
description = models . TextField ( )
def __unicode__ ( self ) :
return self . title
class Meta :
ordering = ( ' title ' , )
2007-03-01 13:11:08 +00:00
class Article ( models . Model ) :
2007-08-05 05:14:46 +00:00
headline = models . CharField ( max_length = 100 , default = ' Default headline ' )
2007-03-01 13:11:08 +00:00
pub_date = models . DateTimeField ( )
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
def __unicode__ ( self ) :
2007-03-01 13:11:08 +00:00
return self . headline
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
2007-03-01 13:11:08 +00:00
class Meta :
ordering = ( ' -pub_date ' , ' headline ' )
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
2007-03-01 13:11:08 +00:00
__test__ = { ' API_TESTS ' : """
>> > from django . core import management
>> > from django . db . models import get_app
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
# Reset the database representation of this app.
2007-03-01 13:11:08 +00:00
# This will return the database to a clean initial state.
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
2007-03-01 13:11:08 +00:00
# Syncdb introduces 1 initial data object from initial_data.json.
>> > Article . objects . all ( )
[ < Article : Python program becomes self aware > ]
# Load fixture 1. Single JSON file, with two objects.
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' fixture1.json ' , verbosity = 0 )
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : Time to reform copyright > , < Article : Poker has no place on ESPN > , < Article : Python program becomes self aware > ]
2009-02-28 05:35:22 +00:00
# Dump the current contents of the database as a JSON fixture
>> > management . call_command ( ' dumpdata ' , ' fixtures ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# Try just dumping the contents of fixtures.Category
>> > management . call_command ( ' dumpdata ' , ' fixtures.Category ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } ]
# ...and just fixtures.Article
>> > management . call_command ( ' dumpdata ' , ' fixtures.Article ' , format = ' json ' )
[ { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# ...and both
>> > management . call_command ( ' dumpdata ' , ' fixtures.Category ' , ' fixtures.Article ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# Specify a specific model twice
>> > management . call_command ( ' dumpdata ' , ' fixtures.Article ' , ' fixtures.Article ' , format = ' json ' )
[ { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# Specify a dump that specifies Article both explicitly and implicitly
>> > management . call_command ( ' dumpdata ' , ' fixtures.Article ' , ' fixtures ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# Same again, but specify in the reverse order
>> > management . call_command ( ' dumpdata ' , ' fixtures ' , ' fixtures.Article ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
# Specify one model from one application, and an entire other application.
>> > management . call_command ( ' dumpdata ' , ' fixtures.Category ' , ' sites ' , format = ' json ' )
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 1 , " model " : " sites.site " , " fields " : { " domain " : " example.com " , " name " : " example.com " } } ]
2007-03-01 13:11:08 +00:00
# Load fixture 2. JSON file imported by default. Overwrites some existing objects
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' fixture2.json ' , verbosity = 0 )
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : Django conquers world ! > , < Article : Copyright is fine the way it is > , < Article : Poker has no place on ESPN > , < Article : Python program becomes self aware > ]
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
# Load fixture 3, XML format.
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' fixture3.xml ' , verbosity = 0 )
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : XML identified as leading cause of cancer > , < Article : Django conquers world ! > , < Article : Copyright is fine the way it is > , < Article : Poker on TV is great ! > , < Article : Python program becomes self aware > ]
# Load a fixture that doesn't exist
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' unknown.json ' , verbosity = 0 )
2007-03-01 13:11:08 +00:00
# object list is unaffected
>> > Article . objects . all ( )
[ < Article : XML identified as leading cause of cancer > , < Article : Django conquers world ! > , < Article : Copyright is fine the way it is > , < Article : Poker on TV is great ! > , < Article : Python program becomes self aware > ]
2007-09-16 10:04:03 +00:00
""" }
2007-03-01 13:11:08 +00:00
2007-09-16 10:49:27 +00:00
# Database flushing does not work on MySQL with the default storage engine
# because it requires transaction support.
2008-07-18 17:38:53 +00:00
if settings . DATABASE_ENGINE != ' mysql ' :
2007-09-16 10:04:03 +00:00
__test__ [ ' API_TESTS ' ] + = \
"""
2007-03-01 13:11:08 +00:00
# Reset the database representation of this app. This will delete all data.
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : Python program becomes self aware > ]
# Load fixture 1 again, using format discovery
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' fixture1 ' , verbosity = 0 )
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : Time to reform copyright > , < Article : Poker has no place on ESPN > , < Article : Python program becomes self aware > ]
# Try to load fixture 2 using format discovery; this will fail
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
# because there are two fixture2's in the fixtures directory
2007-08-16 06:06:55 +00:00
>> > management . call_command ( ' loaddata ' , ' fixture2 ' , verbosity = 0 ) # doctest: +ELLIPSIS
2007-03-13 00:33:15 +00:00
Multiple fixtures named ' fixture2 ' in ' ...fixtures ' . Aborting .
2007-03-01 13:11:08 +00:00
2008-11-24 20:42:09 +00:00
# object list is unaffected
2007-03-01 13:11:08 +00:00
>> > Article . objects . all ( )
[ < Article : Time to reform copyright > , < Article : Poker has no place on ESPN > , < Article : Python program becomes self aware > ]
# Dump the current contents of the database as a JSON fixture
2007-08-17 14:02:40 +00:00
>> > management . call_command ( ' dumpdata ' , ' fixtures ' , format = ' json ' )
2009-02-28 05:35:22 +00:00
[ { " pk " : 1 , " model " : " fixtures.category " , " fields " : { " description " : " Latest news stories " , " title " : " News Stories " } } , { " pk " : 3 , " model " : " fixtures.article " , " fields " : { " headline " : " Time to reform copyright " , " pub_date " : " 2006-06-16 13:00:00 " } } , { " pk " : 2 , " model " : " fixtures.article " , " fields " : { " headline " : " Poker has no place on ESPN " , " pub_date " : " 2006-06-16 12:00:00 " } } , { " pk " : 1 , " model " : " fixtures.article " , " fields " : { " headline " : " Python program becomes self aware " , " pub_date " : " 2006-06-16 11:00:00 " } } ]
2008-11-24 20:42:09 +00:00
# Load fixture 4 (compressed), using format discovery
>> > management . call_command ( ' loaddata ' , ' fixture4 ' , verbosity = 0 )
>> > Article . objects . all ( )
[ < Article : Django pets kitten > , < Article : Time to reform copyright > , < Article : Poker has no place on ESPN > , < Article : Python program becomes self aware > ]
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
# Load fixture 4 (compressed), using format specification
>> > management . call_command ( ' loaddata ' , ' fixture4.json ' , verbosity = 0 )
>> > Article . objects . all ( )
[ < Article : Django pets kitten > , < Article : Python program becomes self aware > ]
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
# Load fixture 5 (compressed), using format *and* compression specification
>> > management . call_command ( ' loaddata ' , ' fixture5.json.zip ' , verbosity = 0 )
>> > Article . objects . all ( )
[ < Article : WoW subscribers now outnumber readers > , < Article : Python program becomes self aware > ]
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
# Load fixture 5 (compressed), only compression specification
>> > management . call_command ( ' loaddata ' , ' fixture5.zip ' , verbosity = 0 )
>> > Article . objects . all ( )
[ < Article : WoW subscribers now outnumber readers > , < Article : Python program becomes self aware > ]
>> > management . call_command ( ' flush ' , verbosity = 0 , interactive = False )
# Try to load fixture 5 using format and compression discovery; this will fail
# because there are two fixture5's in the fixtures directory
>> > management . call_command ( ' loaddata ' , ' fixture5 ' , verbosity = 0 ) # doctest: +ELLIPSIS
Multiple fixtures named ' fixture5 ' in ' ...fixtures ' . Aborting .
2009-02-28 05:35:22 +00:00
2007-09-16 10:04:03 +00:00
"""
2007-03-01 13:11:08 +00:00
from django . test import TestCase
class SampleTestCase ( TestCase ) :
fixtures = [ ' fixture1.json ' , ' fixture2.json ' ]
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 12:11:04 +00:00
2007-03-01 13:11:08 +00:00
def testClassFixtures ( self ) :
" Check that test case has installed 4 fixture objects "
self . assertEqual ( Article . objects . count ( ) , 4 )
self . assertEquals ( str ( Article . objects . all ( ) ) , " [<Article: Django conquers world!>, <Article: Copyright is fine the way it is>, <Article: Poker has no place on ESPN>, <Article: Python program becomes self aware>] " )
