#28680: Document that Func's.__init__()'s **extra and as_sql()'s **extra_context
aren't escaped
--------------------------------------+------------------------------------
     Reporter:  Hynek Cernoch         |                    Owner:  nobody
         Type:  Cleanup/optimization  |                   Status:  new
    Component:  Documentation         |                  Version:  1.11
     Severity:  Normal                |               Resolution:
     Keywords:                        |             Triage Stage:  Accepted
    Has patch:  0                     |      Needs documentation:  0
  Needs tests:  0                     |  Patch needs improvement:  0
Easy pickings:  0                     |                    UI/UX:  0
--------------------------------------+------------------------------------

Comment (by Tim Graham):

 Marc Tamlyn says, "An admonition in
 [https://docs.djangoproject.com/en/dev/ref/models/expressions/#func-
 expressions the docs for Func()] should be sufficient I think. At present
 those docs are mostly about using the "simple" template syntax rather than
 handling SQL and params "the long way" and returning `(sql, params)` from
 the `as_sql()` method. I think this might be a dangerous approach to the
 docs and we should be more explicit earlier about separating params from
 chunks of sql. There's a warning in the docs for `RawSQL` but it's not
 really discussed enough in the expressions reference IMO."

-- 
Ticket URL: <https://code.djangoproject.com/ticket/28680#comment:1>
Django <https://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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/066.ca348c6212f1c7b4a162aab7a440c6ac%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to