Tweak some examples.

"Area man/woman" is confusing to people not familiar with the
conventions of American journalism (like me).
This commit is contained in:
Aymeric Augustin 2015-08-22 20:05:54 +02:00
parent 0eb846605e
commit 491d01b7e9
5 changed files with 29 additions and 29 deletions

View File

@ -426,13 +426,13 @@ probably use:
:lookup:`exact` :lookup:`exact`
An "exact" match. For example:: An "exact" match. For example::
>>> Entry.objects.get(headline__exact="Man bites dog") >>> Entry.objects.get(headline__exact="Cat bites dog")
Would generate SQL along these lines: Would generate SQL along these lines:
.. code-block:: sql .. code-block:: sql
SELECT ... WHERE headline = 'Man bites dog'; SELECT ... WHERE headline = 'Cat bites dog';
If you don't provide a lookup type -- that is, if your keyword argument If you don't provide a lookup type -- that is, if your keyword argument
doesn't contain a double underscore -- the lookup type is assumed to be doesn't contain a double underscore -- the lookup type is assumed to be

View File

@ -25,7 +25,7 @@ class ModelInstanceCreationTests(TestCase):
def test_object_is_not_written_to_database_until_save_was_called(self): def test_object_is_not_written_to_database_until_save_was_called(self):
a = Article( a = Article(
id=None, id=None,
headline='Area man programs in Python', headline='Parrot programs in Python',
pub_date=datetime(2005, 7, 28), pub_date=datetime(2005, 7, 28),
) )
self.assertIsNone(a.id) self.assertIsNone(a.id)
@ -130,7 +130,7 @@ class ModelInstanceCreationTests(TestCase):
def test_querysets_checking_for_membership(self): def test_querysets_checking_for_membership(self):
headlines = [ headlines = [
'Area man programs in Python', 'Second article', 'Third article'] 'Parrot programs in Python', 'Second article', 'Third article']
some_pub_date = datetime(2014, 5, 16, 12, 1) some_pub_date = datetime(2014, 5, 16, 12, 1)
for headline in headlines: for headline in headlines:
Article(headline=headline, pub_date=some_pub_date).save() Article(headline=headline, pub_date=some_pub_date).save()
@ -437,7 +437,7 @@ class ModelLookupTest(TestCase):
# Create an Article. # Create an Article.
self.a = Article( self.a = Article(
id=None, id=None,
headline='Area woman programs in Python', headline='Swallow programs in Python',
pub_date=datetime(2005, 7, 28), pub_date=datetime(2005, 7, 28),
) )
# Save it into the database. You have to call save() explicitly. # Save it into the database. You have to call save() explicitly.
@ -445,17 +445,17 @@ class ModelLookupTest(TestCase):
def test_all_lookup(self): def test_all_lookup(self):
# Change values by changing the attributes, then calling save(). # Change values by changing the attributes, then calling save().
self.a.headline = 'Area man programs in Python' self.a.headline = 'Parrot programs in Python'
self.a.save() self.a.save()
# Article.objects.all() returns all the articles in the database. # Article.objects.all() returns all the articles in the database.
self.assertQuerysetEqual(Article.objects.all(), self.assertQuerysetEqual(Article.objects.all(),
['<Article: Area man programs in Python>']) ['<Article: Parrot programs in Python>'])
def test_rich_lookup(self): def test_rich_lookup(self):
# Django provides a rich database lookup API. # Django provides a rich database lookup API.
self.assertEqual(Article.objects.get(id__exact=self.a.id), self.a) self.assertEqual(Article.objects.get(id__exact=self.a.id), self.a)
self.assertEqual(Article.objects.get(headline__startswith='Area woman'), self.a) self.assertEqual(Article.objects.get(headline__startswith='Swallow'), self.a)
self.assertEqual(Article.objects.get(pub_date__year=2005), self.a) self.assertEqual(Article.objects.get(pub_date__year=2005), self.a)
self.assertEqual(Article.objects.get(pub_date__year=2005, pub_date__month=7), self.a) self.assertEqual(Article.objects.get(pub_date__year=2005, pub_date__month=7), self.a)
self.assertEqual(Article.objects.get(pub_date__year=2005, pub_date__month=7, pub_date__day=28), self.a) self.assertEqual(Article.objects.get(pub_date__year=2005, pub_date__month=7, pub_date__day=28), self.a)
@ -464,11 +464,11 @@ class ModelLookupTest(TestCase):
def test_equal_lookup(self): def test_equal_lookup(self):
# The "__exact" lookup type can be omitted, as a shortcut. # The "__exact" lookup type can be omitted, as a shortcut.
self.assertEqual(Article.objects.get(id=self.a.id), self.a) self.assertEqual(Article.objects.get(id=self.a.id), self.a)
self.assertEqual(Article.objects.get(headline='Area woman programs in Python'), self.a) self.assertEqual(Article.objects.get(headline='Swallow programs in Python'), self.a)
self.assertQuerysetEqual( self.assertQuerysetEqual(
Article.objects.filter(pub_date__year=2005), Article.objects.filter(pub_date__year=2005),
['<Article: Area woman programs in Python>'], ['<Article: Swallow programs in Python>'],
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
Article.objects.filter(pub_date__year=2004), Article.objects.filter(pub_date__year=2004),
@ -476,12 +476,12 @@ class ModelLookupTest(TestCase):
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
Article.objects.filter(pub_date__year=2005, pub_date__month=7), Article.objects.filter(pub_date__year=2005, pub_date__month=7),
['<Article: Area woman programs in Python>'], ['<Article: Swallow programs in Python>'],
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
Article.objects.filter(pub_date__week_day=5), Article.objects.filter(pub_date__week_day=5),
['<Article: Area woman programs in Python>'], ['<Article: Swallow programs in Python>'],
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
Article.objects.filter(pub_date__week_day=6), Article.objects.filter(pub_date__week_day=6),
@ -522,7 +522,7 @@ class ModelLookupTest(TestCase):
# pk can be used as a shortcut for the primary key name in any query. # pk can be used as a shortcut for the primary key name in any query.
self.assertQuerysetEqual(Article.objects.filter(pk__in=[self.a.id]), self.assertQuerysetEqual(Article.objects.filter(pk__in=[self.a.id]),
["<Article: Area woman programs in Python>"]) ["<Article: Swallow programs in Python>"])
# Model instances of the same type and same ID are considered equal. # Model instances of the same type and same ID are considered equal.
a = Article.objects.get(pk=self.a.id) a = Article.objects.get(pk=self.a.id)
@ -533,7 +533,7 @@ class ModelLookupTest(TestCase):
# Create a very similar object # Create a very similar object
a = Article( a = Article(
id=None, id=None,
headline='Area man programs in Python', headline='Swallow bites Python',
pub_date=datetime(2005, 7, 28), pub_date=datetime(2005, 7, 28),
) )
a.save() a.save()
@ -547,7 +547,7 @@ class ModelLookupTest(TestCase):
MultipleObjectsReturned, MultipleObjectsReturned,
"get\(\) returned more than one Article -- it returned 2!", "get\(\) returned more than one Article -- it returned 2!",
Article.objects.get, Article.objects.get,
headline__startswith='Area', headline__startswith='Swallow',
) )
six.assertRaisesRegex( six.assertRaisesRegex(
self, self,

View File

@ -10,7 +10,7 @@ from .models import Article
class MethodsTests(TestCase): class MethodsTests(TestCase):
def test_custom_methods(self): def test_custom_methods(self):
a = Article.objects.create( a = Article.objects.create(
headline="Area man programs in Python", pub_date=date(2005, 7, 27) headline="Parrot programs in Python", pub_date=date(2005, 7, 27)
) )
b = Article.objects.create( b = Article.objects.create(
headline="Beatles reunite", pub_date=date(2005, 7, 27) headline="Beatles reunite", pub_date=date(2005, 7, 27)
@ -32,13 +32,13 @@ class MethodsTests(TestCase):
self.assertQuerysetEqual( self.assertQuerysetEqual(
b.articles_from_same_day_1(), [ b.articles_from_same_day_1(), [
"Area man programs in Python", "Parrot programs in Python",
], ],
lambda a: a.headline, lambda a: a.headline,
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
b.articles_from_same_day_2(), [ b.articles_from_same_day_2(), [
"Area man programs in Python", "Parrot programs in Python",
], ],
lambda a: a.headline lambda a: a.headline
) )

View File

@ -15,13 +15,13 @@ class M2MMultipleTests(TestCase):
] ]
a1 = Article.objects.create( a1 = Article.objects.create(
headline="Area man steals", pub_date=datetime(2005, 11, 27) headline="Parrot steals", pub_date=datetime(2005, 11, 27)
) )
a1.primary_categories.add(c2, c3) a1.primary_categories.add(c2, c3)
a1.secondary_categories.add(c4) a1.secondary_categories.add(c4)
a2 = Article.objects.create( a2 = Article.objects.create(
headline="Area man runs", pub_date=datetime(2005, 11, 28) headline="Parrot runs", pub_date=datetime(2005, 11, 28)
) )
a2.primary_categories.add(c1, c2) a2.primary_categories.add(c1, c2)
a2.secondary_categories.add(c4) a2.secondary_categories.add(c4)
@ -48,7 +48,7 @@ class M2MMultipleTests(TestCase):
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
c1.primary_article_set.all(), [ c1.primary_article_set.all(), [
"Area man runs", "Parrot runs",
], ],
lambda a: a.headline lambda a: a.headline
) )
@ -57,8 +57,8 @@ class M2MMultipleTests(TestCase):
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
c2.primary_article_set.all(), [ c2.primary_article_set.all(), [
"Area man steals", "Parrot steals",
"Area man runs", "Parrot runs",
], ],
lambda a: a.headline lambda a: a.headline
) )
@ -67,7 +67,7 @@ class M2MMultipleTests(TestCase):
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
c3.primary_article_set.all(), [ c3.primary_article_set.all(), [
"Area man steals", "Parrot steals",
], ],
lambda a: a.headline lambda a: a.headline
) )
@ -79,8 +79,8 @@ class M2MMultipleTests(TestCase):
) )
self.assertQuerysetEqual( self.assertQuerysetEqual(
c4.secondary_article_set.all(), [ c4.secondary_article_set.all(), [
"Area man steals", "Parrot steals",
"Area man runs", "Parrot runs",
], ],
lambda a: a.headline lambda a: a.headline
) )

View File

@ -15,11 +15,11 @@ class SimpleTests(TestCase):
@skipIf(six.PY3, "tests a __str__ method returning unicode under Python 2") @skipIf(six.PY3, "tests a __str__ method returning unicode under Python 2")
def test_basic(self): def test_basic(self):
a = Article.objects.create( a = Article.objects.create(
headline=b'Area man programs in Python', headline=b'Parrot programs in Python',
pub_date=datetime.datetime(2005, 7, 28) pub_date=datetime.datetime(2005, 7, 28)
) )
self.assertEqual(str(a), str('Area man programs in Python')) self.assertEqual(str(a), str('Parrot programs in Python'))
self.assertEqual(repr(a), str('<Article: Area man programs in Python>')) self.assertEqual(repr(a), str('<Article: Parrot programs in Python>'))
def test_international(self): def test_international(self):
a = InternationalArticle.objects.create( a = InternationalArticle.objects.create(