mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-07 20:38:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Refs #27656 -- Updated django.db docstring verbs according to PEP 257.

Browse source
This commit is contained in:
Anton Samarchyan 2017-01-24 18:04:12 -05:00 • committed by Tim Graham
parent d6e26e5b7c
commit 60e52a047e
63 changed files with 934 additions and 1266 deletions
Download patch file Download diff file Expand all files Collapse all files

19
django/db/models/query_utils.py
View file

@ -19,9 +19,7 @@ PathInfo = namedtuple('PathInfo', 'from_opts to_opts target_fields join_field m2
class InvalidQuery(Exception):
"""
The query passed to raw isn't a safe query to use with raw.
"""
"""The query passed to raw() isn't a safe query to use with raw()."""
pass
@ -47,7 +45,7 @@ class QueryWrapper:
class Q(tree.Node):
"""
Encapsulates filters as objects that can then be combined logically (using
Encapsulate filters as objects that can then be combined logically (using
`&` and `|`).
"""
# Connection types
@ -112,8 +110,8 @@ class DeferredAttribute:
def __get__(self, instance, cls=None):
"""
Retrieves and caches the value from the datastore on the first lookup.
Returns the cached value.
Retrieve and caches the value from the datastore on the first lookup.
Return the cached value.
"""
if instance is None:
return self
@ -211,7 +209,7 @@ class RegisterLookupMixin:
def select_related_descend(field, restricted, requested, load_fields, reverse=False):
"""
Returns True if this field should be used to descend deeper for
Return True if this field should be used to descend deeper for
select_related() purposes. Used by both the query construction code
(sql.query.fill_related_selections()) and the model instance creation code
(query.get_klass_info()).
@ -247,10 +245,9 @@ def select_related_descend(field, restricted, requested, load_fields, reverse=Fa
def refs_expression(lookup_parts, annotations):
"""
A helper method to check if the lookup_parts contains references
to the given annotations set. Because the LOOKUP_SEP is contained in the
default annotation names we must check each prefix of the lookup_parts
for a match.
Check if the lookup_parts contains references to the given annotations set.
Because the LOOKUP_SEP is contained in the default annotation names, check
each prefix of the lookup_parts for a match.
"""
for n in range(len(lookup_parts) + 1):
level_n_lookup = LOOKUP_SEP.join(lookup_parts[0:n])