2020-06-13 00:36:45 +02:00
<!DOCTYPE html>
2020-06-14 21:48:02 +02:00
2020-10-15 01:31:30 +02:00
< html >
2020-06-15 21:52:33 +02:00
< head >
< meta charset = "utf-8" / >
2020-10-15 01:31:30 +02:00
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" / >
2020-06-15 21:52:33 +02:00
< title > django.db.models.query_utils — Evennia 1.0-dev documentation< / title >
< link rel = "stylesheet" href = "../../../../_static/nature.css" type = "text/css" / >
< link rel = "stylesheet" href = "../../../../_static/pygments.css" type = "text/css" / >
< script id = "documentation_options" data-url_root = "../../../../" src = "../../../../_static/documentation_options.js" > < / script >
< script src = "../../../../_static/jquery.js" > < / script >
< script src = "../../../../_static/underscore.js" > < / script >
< script src = "../../../../_static/doctools.js" > < / script >
< script src = "../../../../_static/language_data.js" > < / script >
< link rel = "shortcut icon" href = "../../../../_static/favicon.ico" / >
< link rel = "index" title = "Index" href = "../../../../genindex.html" / >
< link rel = "search" title = "Search" href = "../../../../search.html" / >
< / head > < body >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../../../../genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "right" >
< a href = "../../../../py-modindex.html" title = "Python Module Index"
>modules< / a > |< / li >
2020-07-14 00:21:00 +02:00
< li class = "nav-item nav-item-0" > < a href = "../../../../index.html" > Evennia 1.0-dev< / a > » < / li >
2020-10-15 01:31:30 +02:00
< li class = "nav-item nav-item-1" > < a href = "../../../index.html" accesskey = "U" > Module code< / a > » < / li >
< li class = "nav-item nav-item-this" > < a href = "" > django.db.models.query_utils< / a > < / li >
2020-06-15 21:52:33 +02:00
< / ul >
2020-11-14 11:55:52 +01:00
< div class = "develop" > develop branch< / div >
2020-06-15 21:52:33 +02:00
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" role = "main" >
2020-06-13 00:36:45 +02:00
< h1 > Source code for django.db.models.query_utils< / h1 > < div class = "highlight" > < pre >
< span > < / span > < span class = "sd" > " " " < / span >
< span class = "sd" > Various data structures used in query construction.< / span >
< span class = "sd" > Factored out from django.db.models.query to avoid making the main module very< / span >
< span class = "sd" > large and/or so that they can be used by other modules without getting into< / span >
< span class = "sd" > circular import difficulties.< / span >
< span class = "sd" > " " " < / span >
< span class = "kn" > import< / span > < span class = "nn" > copy< / span >
< span class = "kn" > import< / span > < span class = "nn" > functools< / span >
< span class = "kn" > import< / span > < span class = "nn" > inspect< / span >
< span class = "kn" > from< / span > < span class = "nn" > collections< / span > < span class = "k" > import< / span > < span class = "n" > namedtuple< / span >
< span class = "kn" > from< / span > < span class = "nn" > django.db.models.constants< / span > < span class = "k" > import< / span > < span class = "n" > LOOKUP_SEP< / span >
< span class = "kn" > from< / span > < span class = "nn" > django.utils< / span > < span class = "k" > import< / span > < span class = "n" > tree< / span >
< span class = "c1" > # PathInfo is used when converting lookups (fk__somecol). The contents< / span >
< span class = "c1" > # describe the relation in Model terms (model Options and Fields for both< / span >
< span class = "c1" > # sides of the relation. The join_field is the field backing the relation.< / span >
< span class = "n" > PathInfo< / span > < span class = "o" > =< / span > < span class = "n" > namedtuple< / span > < span class = "p" > (< / span > < span class = "s1" > ' PathInfo' < / span > < span class = "p" > ,< / span > < span class = "s1" > ' from_opts to_opts target_fields join_field m2m direct filtered_relation' < / span > < span class = "p" > )< / span >
< span class = "k" > class< / span > < span class = "nc" > InvalidQuery< / span > < span class = "p" > (< / span > < span class = "ne" > Exception< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " The query passed to raw() isn' t a safe query to use with raw()." " " < / span >
< span class = "k" > pass< / span >
< span class = "k" > def< / span > < span class = "nf" > subclasses< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ):< / span >
< span class = "k" > yield< / span > < span class = "bp" > cls< / span >
< span class = "k" > for< / span > < span class = "n" > subclass< / span > < span class = "ow" > in< / span > < span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > __subclasses__< / span > < span class = "p" > ():< / span >
< span class = "k" > yield from< / span > < span class = "n" > subclasses< / span > < span class = "p" > (< / span > < span class = "n" > subclass< / span > < span class = "p" > )< / span >
< span class = "k" > class< / span > < span class = "nc" > QueryWrapper< / span > < span class = "p" > :< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > A type that indicates the contents are an SQL fragment and the associate< / span >
< span class = "sd" > parameters. Can be used to pass opaque data to a where-clause, for example.< / span >
< span class = "sd" > " " " < / span >
< span class = "n" > contains_aggregate< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span >
< span class = "k" > def< / span > < span class = "nf" > __init__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > sql< / span > < span class = "p" > ,< / span > < span class = "n" > params< / span > < span class = "p" > ):< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > data< / span > < span class = "o" > =< / span > < span class = "n" > sql< / span > < span class = "p" > ,< / span > < span class = "nb" > list< / span > < span class = "p" > (< / span > < span class = "n" > params< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > as_sql< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > compiler< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ,< / span > < span class = "n" > connection< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > data< / span >
< span class = "k" > class< / span > < span class = "nc" > Q< / span > < span class = "p" > (< / span > < span class = "n" > tree< / span > < span class = "o" > .< / span > < span class = "n" > Node< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Encapsulate filters as objects that can then be combined logically (using< / span >
< span class = "sd" > `& ` and `|`).< / span >
< span class = "sd" > " " " < / span >
< span class = "c1" > # Connection types< / span >
< span class = "n" > AND< / span > < span class = "o" > =< / span > < span class = "s1" > ' AND' < / span >
< span class = "n" > OR< / span > < span class = "o" > =< / span > < span class = "s1" > ' OR' < / span >
< span class = "n" > default< / span > < span class = "o" > =< / span > < span class = "n" > AND< / span >
< span class = "n" > conditional< / span > < span class = "o" > =< / span > < span class = "kc" > True< / span >
< span class = "k" > def< / span > < span class = "nf" > __init__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "o" > *< / span > < span class = "n" > args< / span > < span class = "p" > ,< / span > < span class = "n" > _connector< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ,< / span > < span class = "n" > _negated< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span > < span class = "p" > ,< / span > < span class = "o" > **< / span > < span class = "n" > kwargs< / span > < span class = "p" > ):< / span >
< span class = "nb" > super< / span > < span class = "p" > ()< / span > < span class = "o" > .< / span > < span class = "fm" > __init__< / span > < span class = "p" > (< / span > < span class = "n" > children< / span > < span class = "o" > =< / span > < span class = "p" > [< / span > < span class = "o" > *< / span > < span class = "n" > args< / span > < span class = "p" > ,< / span > < span class = "o" > *< / span > < span class = "nb" > sorted< / span > < span class = "p" > (< / span > < span class = "n" > kwargs< / span > < span class = "o" > .< / span > < span class = "n" > items< / span > < span class = "p" > ())],< / span > < span class = "n" > connector< / span > < span class = "o" > =< / span > < span class = "n" > _connector< / span > < span class = "p" > ,< / span > < span class = "n" > negated< / span > < span class = "o" > =< / span > < span class = "n" > _negated< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > _combine< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "n" > conn< / span > < span class = "p" > ):< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "nb" > isinstance< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "n" > Q< / span > < span class = "p" > ):< / span >
< span class = "k" > raise< / span > < span class = "ne" > TypeError< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > )< / span >
< span class = "c1" > # If the other Q() is empty, ignore it and just use `self`.< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "n" > other< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "n" > copy< / span > < span class = "o" > .< / span > < span class = "n" > deepcopy< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > )< / span >
< span class = "c1" > # Or if this Q is empty, ignore it and just use `other`.< / span >
< span class = "k" > elif< / span > < span class = "ow" > not< / span > < span class = "bp" > self< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "n" > copy< / span > < span class = "o" > .< / span > < span class = "n" > deepcopy< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > )< / span >
< span class = "n" > obj< / span > < span class = "o" > =< / span > < span class = "nb" > type< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > )()< / span >
< span class = "n" > obj< / span > < span class = "o" > .< / span > < span class = "n" > connector< / span > < span class = "o" > =< / span > < span class = "n" > conn< / span >
< span class = "n" > obj< / span > < span class = "o" > .< / span > < span class = "n" > add< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > conn< / span > < span class = "p" > )< / span >
< span class = "n" > obj< / span > < span class = "o" > .< / span > < span class = "n" > add< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "n" > conn< / span > < span class = "p" > )< / span >
< span class = "k" > return< / span > < span class = "n" > obj< / span >
< span class = "k" > def< / span > < span class = "nf" > __or__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > other< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > _combine< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > OR< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > __and__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > other< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > _combine< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > AND< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > __invert__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ):< / span >
< span class = "n" > obj< / span > < span class = "o" > =< / span > < span class = "nb" > type< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > )()< / span >
< span class = "n" > obj< / span > < span class = "o" > .< / span > < span class = "n" > add< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > AND< / span > < span class = "p" > )< / span >
< span class = "n" > obj< / span > < span class = "o" > .< / span > < span class = "n" > negate< / span > < span class = "p" > ()< / span >
< span class = "k" > return< / span > < span class = "n" > obj< / span >
< span class = "k" > def< / span > < span class = "nf" > resolve_expression< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > query< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ,< / span > < span class = "n" > allow_joins< / span > < span class = "o" > =< / span > < span class = "kc" > True< / span > < span class = "p" > ,< / span > < span class = "n" > reuse< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ,< / span > < span class = "n" > summarize< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span > < span class = "p" > ,< / span > < span class = "n" > for_save< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span > < span class = "p" > ):< / span >
< span class = "c1" > # We must promote any new joins to left outer joins so that when Q is< / span >
< span class = "c1" > # used as an expression, rows aren' t filtered due to joins.< / span >
< span class = "n" > clause< / span > < span class = "p" > ,< / span > < span class = "n" > joins< / span > < span class = "o" > =< / span > < span class = "n" > query< / span > < span class = "o" > .< / span > < span class = "n" > _add_q< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > reuse< / span > < span class = "p" > ,< / span > < span class = "n" > allow_joins< / span > < span class = "o" > =< / span > < span class = "n" > allow_joins< / span > < span class = "p" > ,< / span > < span class = "n" > split_subq< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span > < span class = "p" > )< / span >
< span class = "n" > query< / span > < span class = "o" > .< / span > < span class = "n" > promote_joins< / span > < span class = "p" > (< / span > < span class = "n" > joins< / span > < span class = "p" > )< / span >
< span class = "k" > return< / span > < span class = "n" > clause< / span >
< span class = "k" > def< / span > < span class = "nf" > deconstruct< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ):< / span >
< span class = "n" > path< / span > < span class = "o" > =< / span > < span class = "s1" > ' < / span > < span class = "si" > %s< / span > < span class = "s1" > .< / span > < span class = "si" > %s< / span > < span class = "s1" > ' < / span > < span class = "o" > %< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "vm" > __class__< / span > < span class = "o" > .< / span > < span class = "vm" > __module__< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "vm" > __class__< / span > < span class = "o" > .< / span > < span class = "vm" > __name__< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > path< / span > < span class = "o" > .< / span > < span class = "n" > startswith< / span > < span class = "p" > (< / span > < span class = "s1" > ' django.db.models.query_utils' < / span > < span class = "p" > ):< / span >
< span class = "n" > path< / span > < span class = "o" > =< / span > < span class = "n" > path< / span > < span class = "o" > .< / span > < span class = "n" > replace< / span > < span class = "p" > (< / span > < span class = "s1" > ' django.db.models.query_utils' < / span > < span class = "p" > ,< / span > < span class = "s1" > ' django.db.models' < / span > < span class = "p" > )< / span >
< span class = "n" > args< / span > < span class = "p" > ,< / span > < span class = "n" > kwargs< / span > < span class = "o" > =< / span > < span class = "p" > (),< / span > < span class = "p" > {}< / span >
< span class = "k" > if< / span > < span class = "nb" > len< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > children< / span > < span class = "p" > )< / span > < span class = "o" > ==< / span > < span class = "mi" > 1< / span > < span class = "ow" > and< / span > < span class = "ow" > not< / span > < span class = "nb" > isinstance< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > children< / span > < span class = "p" > [< / span > < span class = "mi" > 0< / span > < span class = "p" > ],< / span > < span class = "n" > Q< / span > < span class = "p" > ):< / span >
< span class = "n" > child< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > children< / span > < span class = "p" > [< / span > < span class = "mi" > 0< / span > < span class = "p" > ]< / span >
< span class = "n" > kwargs< / span > < span class = "o" > =< / span > < span class = "p" > {< / span > < span class = "n" > child< / span > < span class = "p" > [< / span > < span class = "mi" > 0< / span > < span class = "p" > ]:< / span > < span class = "n" > child< / span > < span class = "p" > [< / span > < span class = "mi" > 1< / span > < span class = "p" > ]}< / span >
< span class = "k" > else< / span > < span class = "p" > :< / span >
< span class = "n" > args< / span > < span class = "o" > =< / span > < span class = "nb" > tuple< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > children< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > connector< / span > < span class = "o" > !=< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > default< / span > < span class = "p" > :< / span >
< span class = "n" > kwargs< / span > < span class = "o" > =< / span > < span class = "p" > {< / span > < span class = "s1" > ' _connector' < / span > < span class = "p" > :< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > connector< / span > < span class = "p" > }< / span >
< span class = "k" > if< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > negated< / span > < span class = "p" > :< / span >
< span class = "n" > kwargs< / span > < span class = "p" > [< / span > < span class = "s1" > ' _negated' < / span > < span class = "p" > ]< / span > < span class = "o" > =< / span > < span class = "kc" > True< / span >
< span class = "k" > return< / span > < span class = "n" > path< / span > < span class = "p" > ,< / span > < span class = "n" > args< / span > < span class = "p" > ,< / span > < span class = "n" > kwargs< / span >
< span class = "k" > class< / span > < span class = "nc" > DeferredAttribute< / span > < span class = "p" > :< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > A wrapper for a deferred-loading field. When the value is read from this< / span >
< span class = "sd" > object the first time, the query is executed.< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > def< / span > < span class = "nf" > __init__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > field_name< / span > < span class = "p" > ):< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "o" > =< / span > < span class = "n" > field_name< / span >
< span class = "k" > def< / span > < span class = "nf" > __get__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > instance< / span > < span class = "p" > ,< / span > < span class = "bp" > cls< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Retrieve and caches the value from the datastore on the first lookup.< / span >
< span class = "sd" > Return the cached value.< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > if< / span > < span class = "n" > instance< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span >
< span class = "n" > data< / span > < span class = "o" > =< / span > < span class = "n" > instance< / span > < span class = "o" > .< / span > < span class = "vm" > __dict__< / span >
< span class = "k" > if< / span > < span class = "n" > data< / span > < span class = "o" > .< / span > < span class = "n" > get< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "p" > )< / span > < span class = "ow" > is< / span > < span class = "bp" > self< / span > < span class = "p" > :< / span >
< span class = "c1" > # Let' s see if the field is part of the parent chain. If so we< / span >
< span class = "c1" > # might be able to reuse the already loaded value. Refs #18343.< / span >
< span class = "n" > val< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > _check_parent_chain< / span > < span class = "p" > (< / span > < span class = "n" > instance< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > val< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "p" > :< / span >
< span class = "n" > instance< / span > < span class = "o" > .< / span > < span class = "n" > refresh_from_db< / span > < span class = "p" > (< / span > < span class = "n" > fields< / span > < span class = "o" > =< / span > < span class = "p" > [< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > ])< / span >
< span class = "n" > val< / span > < span class = "o" > =< / span > < span class = "nb" > getattr< / span > < span class = "p" > (< / span > < span class = "n" > instance< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > )< / span >
< span class = "n" > data< / span > < span class = "p" > [< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > ]< / span > < span class = "o" > =< / span > < span class = "n" > val< / span >
< span class = "k" > return< / span > < span class = "n" > data< / span > < span class = "p" > [< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > field_name< / span > < span class = "p" > ]< / span >
< span class = "k" > def< / span > < span class = "nf" > _check_parent_chain< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > instance< / span > < span class = "p" > ,< / span > < span class = "n" > name< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Check if the field value can be fetched from a parent field already< / span >
< span class = "sd" > loaded in the instance. This can be done if the to-be fetched< / span >
< span class = "sd" > field is a primary key field.< / span >
< span class = "sd" > " " " < / span >
< span class = "n" > opts< / span > < span class = "o" > =< / span > < span class = "n" > instance< / span > < span class = "o" > .< / span > < span class = "n" > _meta< / span >
< span class = "n" > f< / span > < span class = "o" > =< / span > < span class = "n" > opts< / span > < span class = "o" > .< / span > < span class = "n" > get_field< / span > < span class = "p" > (< / span > < span class = "n" > name< / span > < span class = "p" > )< / span >
< span class = "n" > link_field< / span > < span class = "o" > =< / span > < span class = "n" > opts< / span > < span class = "o" > .< / span > < span class = "n" > get_ancestor_link< / span > < span class = "p" > (< / span > < span class = "n" > f< / span > < span class = "o" > .< / span > < span class = "n" > model< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > f< / span > < span class = "o" > .< / span > < span class = "n" > primary_key< / span > < span class = "ow" > and< / span > < span class = "n" > f< / span > < span class = "o" > !=< / span > < span class = "n" > link_field< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "nb" > getattr< / span > < span class = "p" > (< / span > < span class = "n" > instance< / span > < span class = "p" > ,< / span > < span class = "n" > link_field< / span > < span class = "o" > .< / span > < span class = "n" > attname< / span > < span class = "p" > )< / span >
< span class = "k" > return< / span > < span class = "kc" > None< / span >
< span class = "k" > class< / span > < span class = "nc" > RegisterLookupMixin< / span > < span class = "p" > :< / span >
< span class = "nd" > @classmethod< / span >
< span class = "k" > def< / span > < span class = "nf" > _get_lookup< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ,< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > get_lookups< / span > < span class = "p" > ()< / span > < span class = "o" > .< / span > < span class = "n" > get< / span > < span class = "p" > (< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ,< / span > < span class = "kc" > None< / span > < span class = "p" > )< / span >
< span class = "nd" > @classmethod< / span >
< span class = "nd" > @functools< / span > < span class = "o" > .< / span > < span class = "n" > lru_cache< / span > < span class = "p" > (< / span > < span class = "n" > maxsize< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > get_lookups< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ):< / span >
< span class = "n" > class_lookups< / span > < span class = "o" > =< / span > < span class = "p" > [< / span > < span class = "n" > parent< / span > < span class = "o" > .< / span > < span class = "vm" > __dict__< / span > < span class = "o" > .< / span > < span class = "n" > get< / span > < span class = "p" > (< / span > < span class = "s1" > ' class_lookups' < / span > < span class = "p" > ,< / span > < span class = "p" > {})< / span > < span class = "k" > for< / span > < span class = "n" > parent< / span > < span class = "ow" > in< / span > < span class = "n" > inspect< / span > < span class = "o" > .< / span > < span class = "n" > getmro< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > )]< / span >
< span class = "k" > return< / span > < span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > merge_dicts< / span > < span class = "p" > (< / span > < span class = "n" > class_lookups< / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > get_lookup< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ):< / span >
< span class = "kn" > from< / span > < span class = "nn" > django.db.models.lookups< / span > < span class = "k" > import< / span > < span class = "n" > Lookup< / span >
< span class = "n" > found< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > _get_lookup< / span > < span class = "p" > (< / span > < span class = "n" > lookup_name< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > found< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "ow" > and< / span > < span class = "nb" > hasattr< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "s1" > ' output_field' < / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > output_field< / span > < span class = "o" > .< / span > < span class = "n" > get_lookup< / span > < span class = "p" > (< / span > < span class = "n" > lookup_name< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > found< / span > < span class = "ow" > is< / span > < span class = "ow" > not< / span > < span class = "kc" > None< / span > < span class = "ow" > and< / span > < span class = "ow" > not< / span > < span class = "nb" > issubclass< / span > < span class = "p" > (< / span > < span class = "n" > found< / span > < span class = "p" > ,< / span > < span class = "n" > Lookup< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "kc" > None< / span >
< span class = "k" > return< / span > < span class = "n" > found< / span >
< span class = "k" > def< / span > < span class = "nf" > get_transform< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ):< / span >
< span class = "kn" > from< / span > < span class = "nn" > django.db.models.lookups< / span > < span class = "k" > import< / span > < span class = "n" > Transform< / span >
< span class = "n" > found< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > _get_lookup< / span > < span class = "p" > (< / span > < span class = "n" > lookup_name< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > found< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "ow" > and< / span > < span class = "nb" > hasattr< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "s1" > ' output_field' < / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > output_field< / span > < span class = "o" > .< / span > < span class = "n" > get_transform< / span > < span class = "p" > (< / span > < span class = "n" > lookup_name< / span > < span class = "p" > )< / span >
< span class = "k" > if< / span > < span class = "n" > found< / span > < span class = "ow" > is< / span > < span class = "ow" > not< / span > < span class = "kc" > None< / span > < span class = "ow" > and< / span > < span class = "ow" > not< / span > < span class = "nb" > issubclass< / span > < span class = "p" > (< / span > < span class = "n" > found< / span > < span class = "p" > ,< / span > < span class = "n" > Transform< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "kc" > None< / span >
< span class = "k" > return< / span > < span class = "n" > found< / span >
< span class = "nd" > @staticmethod< / span >
< span class = "k" > def< / span > < span class = "nf" > merge_dicts< / span > < span class = "p" > (< / span > < span class = "n" > dicts< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Merge dicts in reverse to preference the order of the original list. e.g.,< / span >
< span class = "sd" > merge_dicts([a, b]) will preference the keys in ' a' over those in ' b' .< / span >
< span class = "sd" > " " " < / span >
< span class = "n" > merged< / span > < span class = "o" > =< / span > < span class = "p" > {}< / span >
< span class = "k" > for< / span > < span class = "n" > d< / span > < span class = "ow" > in< / span > < span class = "nb" > reversed< / span > < span class = "p" > (< / span > < span class = "n" > dicts< / span > < span class = "p" > ):< / span >
< span class = "n" > merged< / span > < span class = "o" > .< / span > < span class = "n" > update< / span > < span class = "p" > (< / span > < span class = "n" > d< / span > < span class = "p" > )< / span >
< span class = "k" > return< / span > < span class = "n" > merged< / span >
< span class = "nd" > @classmethod< / span >
< span class = "k" > def< / span > < span class = "nf" > _clear_cached_lookups< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ):< / span >
< span class = "k" > for< / span > < span class = "n" > subclass< / span > < span class = "ow" > in< / span > < span class = "n" > subclasses< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ):< / span >
< span class = "n" > subclass< / span > < span class = "o" > .< / span > < span class = "n" > get_lookups< / span > < span class = "o" > .< / span > < span class = "n" > cache_clear< / span > < span class = "p" > ()< / span >
< span class = "nd" > @classmethod< / span >
< span class = "k" > def< / span > < span class = "nf" > register_lookup< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ,< / span > < span class = "n" > lookup< / span > < span class = "p" > ,< / span > < span class = "n" > lookup_name< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ):< / span >
< span class = "k" > if< / span > < span class = "n" > lookup_name< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "p" > :< / span >
< span class = "n" > lookup_name< / span > < span class = "o" > =< / span > < span class = "n" > lookup< / span > < span class = "o" > .< / span > < span class = "n" > lookup_name< / span >
< span class = "k" > if< / span > < span class = "s1" > ' class_lookups' < / span > < span class = "ow" > not< / span > < span class = "ow" > in< / span > < span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "vm" > __dict__< / span > < span class = "p" > :< / span >
< span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > class_lookups< / span > < span class = "o" > =< / span > < span class = "p" > {}< / span >
< span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > class_lookups< / span > < span class = "p" > [< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ]< / span > < span class = "o" > =< / span > < span class = "n" > lookup< / span >
< span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > _clear_cached_lookups< / span > < span class = "p" > ()< / span >
< span class = "k" > return< / span > < span class = "n" > lookup< / span >
< span class = "nd" > @classmethod< / span >
< span class = "k" > def< / span > < span class = "nf" > _unregister_lookup< / span > < span class = "p" > (< / span > < span class = "bp" > cls< / span > < span class = "p" > ,< / span > < span class = "n" > lookup< / span > < span class = "p" > ,< / span > < span class = "n" > lookup_name< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Remove given lookup from cls lookups. For use in tests only as it' s< / span >
< span class = "sd" > not thread-safe.< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > if< / span > < span class = "n" > lookup_name< / span > < span class = "ow" > is< / span > < span class = "kc" > None< / span > < span class = "p" > :< / span >
< span class = "n" > lookup_name< / span > < span class = "o" > =< / span > < span class = "n" > lookup< / span > < span class = "o" > .< / span > < span class = "n" > lookup_name< / span >
< span class = "k" > del< / span > < span class = "bp" > cls< / span > < span class = "o" > .< / span > < span class = "n" > class_lookups< / span > < span class = "p" > [< / span > < span class = "n" > lookup_name< / span > < span class = "p" > ]< / span >
< span class = "k" > def< / span > < span class = "nf" > select_related_descend< / span > < span class = "p" > (< / span > < span class = "n" > field< / span > < span class = "p" > ,< / span > < span class = "n" > restricted< / span > < span class = "p" > ,< / span > < span class = "n" > requested< / span > < span class = "p" > ,< / span > < span class = "n" > load_fields< / span > < span class = "p" > ,< / span > < span class = "n" > reverse< / span > < span class = "o" > =< / span > < span class = "kc" > False< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Return True if this field should be used to descend deeper for< / span >
< span class = "sd" > select_related() purposes. Used by both the query construction code< / span >
< span class = "sd" > (sql.query.fill_related_selections()) and the model instance creation code< / span >
< span class = "sd" > (query.get_klass_info()).< / span >
< span class = "sd" > Arguments:< / span >
< span class = "sd" > * field - the field to be checked< / span >
< span class = "sd" > * restricted - a boolean field, indicating if the field list has been< / span >
< span class = "sd" > manually restricted using a requested clause)< / span >
< span class = "sd" > * requested - The select_related() dictionary.< / span >
< span class = "sd" > * load_fields - the set of fields to be loaded on this model< / span >
< span class = "sd" > * reverse - boolean, True if we are checking a reverse select related< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > remote_field< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span >
< span class = "k" > if< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > remote_field< / span > < span class = "o" > .< / span > < span class = "n" > parent_link< / span > < span class = "ow" > and< / span > < span class = "ow" > not< / span > < span class = "n" > reverse< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span >
< span class = "k" > if< / span > < span class = "n" > restricted< / span > < span class = "p" > :< / span >
< span class = "k" > if< / span > < span class = "n" > reverse< / span > < span class = "ow" > and< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > related_query_name< / span > < span class = "p" > ()< / span > < span class = "ow" > not< / span > < span class = "ow" > in< / span > < span class = "n" > requested< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "n" > reverse< / span > < span class = "ow" > and< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > name< / span > < span class = "ow" > not< / span > < span class = "ow" > in< / span > < span class = "n" > requested< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "n" > restricted< / span > < span class = "ow" > and< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > null< / span > < span class = "p" > :< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span >
< span class = "k" > if< / span > < span class = "n" > load_fields< / span > < span class = "p" > :< / span >
< span class = "k" > if< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > attname< / span > < span class = "ow" > not< / span > < span class = "ow" > in< / span > < span class = "n" > load_fields< / span > < span class = "p" > :< / span >
< span class = "k" > if< / span > < span class = "n" > restricted< / span > < span class = "ow" > and< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > name< / span > < span class = "ow" > in< / span > < span class = "n" > requested< / span > < span class = "p" > :< / span >
< span class = "k" > raise< / span > < span class = "n" > InvalidQuery< / span > < span class = "p" > (< / span > < span class = "s2" > " Field < / span > < span class = "si" > %s< / span > < span class = "s2" > .< / span > < span class = "si" > %s< / span > < span class = "s2" > cannot be both deferred" < / span >
< span class = "s2" > " and traversed using select_related" < / span >
< span class = "s2" > " at the same time." < / span > < span class = "o" > %< / span >
< span class = "p" > (< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > model< / span > < span class = "o" > .< / span > < span class = "n" > _meta< / span > < span class = "o" > .< / span > < span class = "n" > object_name< / span > < span class = "p" > ,< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > name< / span > < span class = "p" > ))< / span >
< span class = "k" > return< / span > < span class = "kc" > True< / span >
< span class = "k" > def< / span > < span class = "nf" > refs_expression< / span > < span class = "p" > (< / span > < span class = "n" > lookup_parts< / span > < span class = "p" > ,< / span > < span class = "n" > annotations< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Check if the lookup_parts contains references to the given annotations set.< / span >
< span class = "sd" > Because the LOOKUP_SEP is contained in the default annotation names, check< / span >
< span class = "sd" > each prefix of the lookup_parts for a match.< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > for< / span > < span class = "n" > n< / span > < span class = "ow" > in< / span > < span class = "nb" > range< / span > < span class = "p" > (< / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span > < span class = "nb" > len< / span > < span class = "p" > (< / span > < span class = "n" > lookup_parts< / span > < span class = "p" > )< / span > < span class = "o" > +< / span > < span class = "mi" > 1< / span > < span class = "p" > ):< / span >
< span class = "n" > level_n_lookup< / span > < span class = "o" > =< / span > < span class = "n" > LOOKUP_SEP< / span > < span class = "o" > .< / span > < span class = "n" > join< / span > < span class = "p" > (< / span > < span class = "n" > lookup_parts< / span > < span class = "p" > [< / span > < span class = "mi" > 0< / span > < span class = "p" > :< / span > < span class = "n" > n< / span > < span class = "p" > ])< / span >
< span class = "k" > if< / span > < span class = "n" > level_n_lookup< / span > < span class = "ow" > in< / span > < span class = "n" > annotations< / span > < span class = "ow" > and< / span > < span class = "n" > annotations< / span > < span class = "p" > [< / span > < span class = "n" > level_n_lookup< / span > < span class = "p" > ]:< / span >
< span class = "k" > return< / span > < span class = "n" > annotations< / span > < span class = "p" > [< / span > < span class = "n" > level_n_lookup< / span > < span class = "p" > ],< / span > < span class = "n" > lookup_parts< / span > < span class = "p" > [< / span > < span class = "n" > n< / span > < span class = "p" > :]< / span >
< span class = "k" > return< / span > < span class = "kc" > False< / span > < span class = "p" > ,< / span > < span class = "p" > ()< / span >
< span class = "k" > def< / span > < span class = "nf" > check_rel_lookup_compatibility< / span > < span class = "p" > (< / span > < span class = "n" > model< / span > < span class = "p" > ,< / span > < span class = "n" > target_opts< / span > < span class = "p" > ,< / span > < span class = "n" > field< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > Check that self.model is compatible with target_opts. Compatibility< / span >
< span class = "sd" > is OK if:< / span >
< span class = "sd" > 1) model and opts match (where proxy inheritance is removed)< / span >
< span class = "sd" > 2) model is parent of opts' model or the other way around< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > def< / span > < span class = "nf" > check< / span > < span class = "p" > (< / span > < span class = "n" > opts< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "p" > (< / span >
< span class = "n" > model< / span > < span class = "o" > .< / span > < span class = "n" > _meta< / span > < span class = "o" > .< / span > < span class = "n" > concrete_model< / span > < span class = "o" > ==< / span > < span class = "n" > opts< / span > < span class = "o" > .< / span > < span class = "n" > concrete_model< / span > < span class = "ow" > or< / span >
< span class = "n" > opts< / span > < span class = "o" > .< / span > < span class = "n" > concrete_model< / span > < span class = "ow" > in< / span > < span class = "n" > model< / span > < span class = "o" > .< / span > < span class = "n" > _meta< / span > < span class = "o" > .< / span > < span class = "n" > get_parent_list< / span > < span class = "p" > ()< / span > < span class = "ow" > or< / span >
< span class = "n" > model< / span > < span class = "ow" > in< / span > < span class = "n" > opts< / span > < span class = "o" > .< / span > < span class = "n" > get_parent_list< / span > < span class = "p" > ()< / span >
< span class = "p" > )< / span >
< span class = "c1" > # If the field is a primary key, then doing a query against the field' s< / span >
< span class = "c1" > # model is ok, too. Consider the case:< / span >
< span class = "c1" > # class Restaurant(models.Model):< / span >
< span class = "c1" > # place = OnetoOneField(Place, primary_key=True):< / span >
< span class = "c1" > # Restaurant.objects.filter(pk__in=Restaurant.objects.all()).< / span >
< span class = "c1" > # If we didn' t have the primary key check, then pk__in (== place__in) would< / span >
< span class = "c1" > # give Place' s opts as the target opts, but Restaurant isn' t compatible< / span >
< span class = "c1" > # with that. This logic applies only to primary keys, as when doing __in=qs,< / span >
< span class = "c1" > # we are going to turn this into __in=qs.values(' pk' ) later on.< / span >
< span class = "k" > return< / span > < span class = "p" > (< / span >
< span class = "n" > check< / span > < span class = "p" > (< / span > < span class = "n" > target_opts< / span > < span class = "p" > )< / span > < span class = "ow" > or< / span >
< span class = "p" > (< / span > < span class = "nb" > getattr< / span > < span class = "p" > (< / span > < span class = "n" > field< / span > < span class = "p" > ,< / span > < span class = "s1" > ' primary_key' < / span > < span class = "p" > ,< / span > < span class = "kc" > False< / span > < span class = "p" > )< / span > < span class = "ow" > and< / span > < span class = "n" > check< / span > < span class = "p" > (< / span > < span class = "n" > field< / span > < span class = "o" > .< / span > < span class = "n" > model< / span > < span class = "o" > .< / span > < span class = "n" > _meta< / span > < span class = "p" > ))< / span >
< span class = "p" > )< / span >
< span class = "k" > class< / span > < span class = "nc" > FilteredRelation< / span > < span class = "p" > :< / span >
< span class = "sd" > " " " Specify custom filtering in the ON clause of SQL joins." " " < / span >
< span class = "k" > def< / span > < span class = "nf" > __init__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > relation_name< / span > < span class = "p" > ,< / span > < span class = "o" > *< / span > < span class = "p" > ,< / span > < span class = "n" > condition< / span > < span class = "o" > =< / span > < span class = "n" > Q< / span > < span class = "p" > ()):< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "n" > relation_name< / span > < span class = "p" > :< / span >
< span class = "k" > raise< / span > < span class = "ne" > ValueError< / span > < span class = "p" > (< / span > < span class = "s1" > ' relation_name cannot be empty.' < / span > < span class = "p" > )< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > relation_name< / span > < span class = "o" > =< / span > < span class = "n" > relation_name< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > alias< / span > < span class = "o" > =< / span > < span class = "kc" > None< / span >
< span class = "k" > if< / span > < span class = "ow" > not< / span > < span class = "nb" > isinstance< / span > < span class = "p" > (< / span > < span class = "n" > condition< / span > < span class = "p" > ,< / span > < span class = "n" > Q< / span > < span class = "p" > ):< / span >
< span class = "k" > raise< / span > < span class = "ne" > ValueError< / span > < span class = "p" > (< / span > < span class = "s1" > ' condition argument must be a Q() instance.' < / span > < span class = "p" > )< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > condition< / span > < span class = "o" > =< / span > < span class = "n" > condition< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > path< / span > < span class = "o" > =< / span > < span class = "p" > []< / span >
< span class = "k" > def< / span > < span class = "nf" > __eq__< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > other< / span > < span class = "p" > ):< / span >
< span class = "k" > return< / span > < span class = "p" > (< / span >
< span class = "nb" > isinstance< / span > < span class = "p" > (< / span > < span class = "n" > other< / span > < span class = "p" > ,< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "vm" > __class__< / span > < span class = "p" > )< / span > < span class = "ow" > and< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > relation_name< / span > < span class = "o" > ==< / span > < span class = "n" > other< / span > < span class = "o" > .< / span > < span class = "n" > relation_name< / span > < span class = "ow" > and< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > alias< / span > < span class = "o" > ==< / span > < span class = "n" > other< / span > < span class = "o" > .< / span > < span class = "n" > alias< / span > < span class = "ow" > and< / span >
< span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > condition< / span > < span class = "o" > ==< / span > < span class = "n" > other< / span > < span class = "o" > .< / span > < span class = "n" > condition< / span >
< span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > clone< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ):< / span >
< span class = "n" > clone< / span > < span class = "o" > =< / span > < span class = "n" > FilteredRelation< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > relation_name< / span > < span class = "p" > ,< / span > < span class = "n" > condition< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > condition< / span > < span class = "p" > )< / span >
< span class = "n" > clone< / span > < span class = "o" > .< / span > < span class = "n" > alias< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > alias< / span >
< span class = "n" > clone< / span > < span class = "o" > .< / span > < span class = "n" > path< / span > < span class = "o" > =< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > path< / span > < span class = "p" > [:]< / span >
< span class = "k" > return< / span > < span class = "n" > clone< / span >
< span class = "k" > def< / span > < span class = "nf" > resolve_expression< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "o" > *< / span > < span class = "n" > args< / span > < span class = "p" > ,< / span > < span class = "o" > **< / span > < span class = "n" > kwargs< / span > < span class = "p" > ):< / span >
< span class = "sd" > " " " < / span >
< span class = "sd" > QuerySet.annotate() only accepts expression-like arguments< / span >
< span class = "sd" > (with a resolve_expression() method).< / span >
< span class = "sd" > " " " < / span >
< span class = "k" > raise< / span > < span class = "ne" > NotImplementedError< / span > < span class = "p" > (< / span > < span class = "s1" > ' FilteredRelation.resolve_expression() is unused.' < / span > < span class = "p" > )< / span >
< span class = "k" > def< / span > < span class = "nf" > as_sql< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "p" > ,< / span > < span class = "n" > compiler< / span > < span class = "p" > ,< / span > < span class = "n" > connection< / span > < span class = "p" > ):< / span >
< span class = "c1" > # Resolve the condition in Join.filtered_relation.< / span >
< span class = "n" > query< / span > < span class = "o" > =< / span > < span class = "n" > compiler< / span > < span class = "o" > .< / span > < span class = "n" > query< / span >
< span class = "n" > where< / span > < span class = "o" > =< / span > < span class = "n" > query< / span > < span class = "o" > .< / span > < span class = "n" > build_filtered_relation_q< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > condition< / span > < span class = "p" > ,< / span > < span class = "n" > reuse< / span > < span class = "o" > =< / span > < span class = "nb" > set< / span > < span class = "p" > (< / span > < span class = "bp" > self< / span > < span class = "o" > .< / span > < span class = "n" > path< / span > < span class = "p" > ))< / span >
< span class = "k" > return< / span > < span class = "n" > compiler< / span > < span class = "o" > .< / span > < span class = "n" > compile< / span > < span class = "p" > (< / span > < span class = "n" > where< / span > < span class = "p" > )< / span >
< / pre > < / div >
2020-10-15 01:31:30 +02:00
< div class = "clearer" > < / div >
2020-06-13 00:36:45 +02:00
< / div >
< / div >
< / div >
2020-06-15 21:52:33 +02:00
< div class = "sphinxsidebar" role = "navigation" aria-label = "main navigation" >
< div class = "sphinxsidebarwrapper" >
< p class = "logo" > < a href = "../../../../index.html" >
< img class = "logo" src = "../../../../_static/evennia_logo.png" alt = "Logo" / >
< / a > < / p >
< div id = "searchbox" style = "display: none" role = "search" >
< h3 id = "searchlabel" > Quick search< / h3 >
< div class = "searchformwrapper" >
< form class = "search" action = "../../../../search.html" method = "get" >
< input type = "text" name = "q" aria-labelledby = "searchlabel" / >
< input type = "submit" value = "Go" / >
< / form >
< / div >
< / div >
< script > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
< h3 > Versions< / h3 >
< ul >
< li > < a href = "query_utils.html" > 1.0-dev (develop branch)< / a > < / li >
2020-10-11 22:19:29 +02:00
< li > < a href = "../../../../../0.9.5/index.html" > 0.9.5 (master branch)< / a > < / li >
2020-06-15 21:52:33 +02:00
< / ul >
2020-06-13 00:36:45 +02:00
2020-06-15 21:52:33 +02:00
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../../../../genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "right" >
< a href = "../../../../py-modindex.html" title = "Python Module Index"
>modules< / a > |< / li >
2020-07-14 00:21:00 +02:00
< li class = "nav-item nav-item-0" > < a href = "../../../../index.html" > Evennia 1.0-dev< / a > » < / li >
2020-10-15 01:31:30 +02:00
< li class = "nav-item nav-item-1" > < a href = "../../../index.html" > Module code< / a > » < / li >
< li class = "nav-item nav-item-this" > < a href = "" > django.db.models.query_utils< / a > < / li >
2020-06-15 21:52:33 +02:00
< / ul >
2020-11-14 11:55:52 +01:00
< div class = "develop" > develop branch< / div >
2020-06-15 21:52:33 +02:00
< / div >
< div class = "footer" role = "contentinfo" >
© Copyright 2020, The Evennia developer community.
2020-10-15 01:31:30 +02:00
Created using < a href = "https://www.sphinx-doc.org/" > Sphinx< / a > 3.2.1.
2020-06-15 21:52:33 +02:00
< / div >
< / body >
2020-06-13 00:36:45 +02:00
< / html >
