Nick Pope 
								
							 
						 
						
							
							
							
							
								
							
							
								501a8db465 
								
							 
						 
						
							
							
								
								Fixed   #10929  -- Added default argument to aggregates.  
							
							... 
							
							
							
							Thanks to Simon Charette and Adam Johnson for the reviews. 
							
						 
						
							2021-07-19 13:04:27 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Ian Foote 
								
							 
						 
						
							
							
							
							
								
							
							
								f42ccdd835 
								
							 
						 
						
							
							
								
								Fixed   #27021  -- Allowed lookup expressions in annotations, aggregations, and QuerySet.filter().  
							
							... 
							
							
							
							Thanks Hannes Ljungberg and Simon Charette for reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com> 
							
						 
						
							2021-07-09 11:43:06 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Charette 
								
							 
						 
						
							
							
							
							
								
							
							
								9f3cce172f 
								
							 
						 
						
							
							
								
								Refs  #26430  -- Re-introduced empty aggregation optimization.  
							
							... 
							
							
							
							The introduction of the Expression.empty_aggregate_value interface
allows the compilation stage to enable the EmptyResultSet optimization
if all the aggregates expressions implement it.
This also removes unnecessary RegrCount/Count.convert_value() methods.
Disabling the empty result set aggregation optimization when it wasn't
appropriate prevented None returned for a Count aggregation value.
Thanks Nick Pope for the review. 
							
						 
						
							2021-07-02 07:25:42 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Willison 
								
							 
						 
						
							
							
							
							
								
							
							
								e53159747c 
								
							 
						 
						
							
							
								
								Doc'd that RawSQL can be used with __in.  
							
							
							
						 
						
							2021-03-25 10:28:20 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								fdc3d9dcaf 
								
							 
						 
						
							
							
								
								Removed unused import in docs/ref/models/expressions.txt. ( #13879 )  
							
							
							
						 
						
							2021-01-12 10:51:38 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Kevin Marsh 
								
							 
						 
						
							
							
							
							
								
							
							
								45f4282149 
								
							 
						 
						
							
							
								
								Refs  #31792  -- Updated SQL example in Exists() docs.  
							
							... 
							
							
							
							Follow up to 51297a9232 
							
						 
						
							2020-12-10 21:01:57 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Ian Foote 
								
							 
						 
						
							
							
							
							
								
							
							
								8b040e3cbb 
								
							 
						 
						
							
							
								
								Fixed   #25534 ,  Fixed   #31639  -- Added support for transform references in expressions.  
							
							... 
							
							
							
							Thanks Mariusz Felisiak and Simon Charette for reviews. 
							
						 
						
							2020-11-27 20:42:04 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Charette 
								
							 
						 
						
							
							
							
							
								
							
							
								1e38f1191d 
								
							 
						 
						
							
							
								
								Fixed   #30446  -- Resolved Value.output_field for stdlib types.  
							
							... 
							
							
							
							This required implementing a limited form of dynamic dispatch to combine
expressions with numerical output. Refs #26355  should eventually provide
a better interface for that. 
							
						 
						
							2020-07-15 10:58:29 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								4c5236ef93 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 3.0.  
							
							
							
						 
						
							2020-05-13 09:07:51 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								1c2c6f1b51 
								
							 
						 
						
							
							
								
								Fixed a/an typos in "SQL" usage.  
							
							
							
						 
						
							2020-05-06 06:35:26 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Hasan Ramezani 
								
							 
						 
						
							
							
							
							
								
							
							
								6929f13254 
								
							 
						 
						
							
							
								
								Fixed   #31368  -- Doc'd 'expression' parameter of Field.from_db_value()/Expression.convert_value().  
							
							
							
						 
						
							2020-03-18 09:37:05 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								8c1b073b59 
								
							 
						 
						
							
							
								
								Doc'd return values of as_sql() for Func and query expressions.  
							
							
							
						 
						
							2020-03-06 13:02:08 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Taoup 
								
							 
						 
						
							
							
							
							
								
							
							
								cebd41e416 
								
							 
						 
						
							
							
								
								Fixed   #31110  -- Fixed typo in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2019-12-21 20:33:04 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								416c584cab 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 2.2.  
							
							
							
						 
						
							2019-09-10 12:01:00 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tobias Kunze 
								
							 
						 
						
							
							
							
							
								
							
							
								4a954cfd11 
								
							 
						 
						
							
							
								
								Fixed   #30573  -- Rephrased documentation to avoid words that minimise the involved difficulty.  
							
							... 
							
							
							
							This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:
- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous
Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review. 
							
						 
						
							2019-09-06 13:27:46 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Matthew Schinckel 
								
							 
						 
						
							
							
							
							
								
							
							
								4137fc2efc 
								
							 
						 
						
							
							
								
								Fixed   #25367  -- Allowed boolean expressions in QuerySet.filter() and exclude().  
							
							... 
							
							
							
							This allows using expressions that have an output_field that is a
BooleanField to be used directly in a queryset filters, or in the
When() clauses of a Case() expression.
Thanks Josh Smeaton, Tim Graham, Simon Charette, Mariusz Felisiak, and
Adam Johnson for reviews.
Co-Authored-By: NyanKiyoshi <hello@vanille.bid> 
							
						 
						
							2019-08-29 09:45:29 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Matthew Schinckel 
								
							 
						 
						
							
							
							
							
								
							
							
								dba749917f 
								
							 
						 
						
							
							
								
								Doc'd for_save argument of Expression.resolve_expression().  
							
							
							
						 
						
							2019-08-27 16:54:01 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Vyacheslav Ver 
								
							 
						 
						
							
							
							
							
								
							
							
								76b3fc5c8d 
								
							 
						 
						
							
							
								
								Fixed   #30486  -- Fixed the default value of Aggregate.distinct and updated example of custom aggregate functions.  
							
							
							
						 
						
							2019-06-11 11:40:48 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Vyacheslav Ver 
								
							 
						 
						
							
							
							
							
								
							
							
								60b6a7ea9d 
								
							 
						 
						
							
							
								
								Fixed typo in expression documentation.  
							
							
							
						 
						
							2019-05-16 16:03:27 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Daniel Musketa 
								
							 
						 
						
							
							
							
							
								
							
							
								6fd9c9daa6 
								
							 
						 
						
							
							
								
								Fixed   #30365  -- Fixed syntax highlighting in SQL examples.  
							
							... 
							
							
							
							Sphinx interprets some "%[a-z]" in SQL statements as a
"Literal.String.Interpol" which leads to incorrect highlighting. 
							
						 
						
							2019-04-23 12:37:50 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									sage 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								bfae195b0a 
								
							 
						 
						
							
							
								
								Fixed   #30326  -- Doc'd how to avoid persistence of F() assignment.  
							
							
							
						 
						
							2019-04-15 08:57:33 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Charette 
								
							 
						 
						
							
							
							
							
								
							
							
								9dc367dc10 
								
							 
						 
						
							
							
								
								Refs  #30158  -- Added alias argument to Expression.get_group_by_cols().  
							
							
							
						 
						
							2019-03-21 18:47:46 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								ec7e179aeb 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 2.1.  
							
							
							
						 
						
							2019-01-17 10:50:25 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Charette 
								
							 
						 
						
							
							
							
							
								
							
							
								bc05547cd8 
								
							 
						 
						
							
							
								
								Fixed   #28658  -- Added DISTINCT handling to the Aggregate class.  
							
							
							
						 
						
							2019-01-09 17:52:36 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Simon Charette 
								
							 
						 
						
							
							
							
							
								
							
							
								9a7d336c38 
								
							 
						 
						
							
							
								
								Corrected Aggregate docs to reflect that it accepts multiple expressions.  
							
							
							
						 
						
							2018-11-27 09:22:24 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Curtis Maloney 
								
							 
						 
						
							
							
							
							
								
							
							
								c49ea6f591 
								
							 
						 
						
							
							
								
								Refs  #20910  -- Replaced snippet directive with code-block.  
							
							
							
						 
						
							2018-09-10 13:00:34 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									priyanshsaxena 
								
							 
						 
						
							
							
							
							
								
							
							
								83b04d4f88 
								
							 
						 
						
							
							
								
								Fixed   #29048  -- Added **extra_context to database function as_vendor() methods.  
							
							
							
						 
						
							2018-08-23 11:52:09 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mads Jensen 
								
							 
						 
						
							
							
							
							
								
							
							
								ab251fdad2 
								
							 
						 
						
							
							
								
								Refs  #26608  -- Removed incorrect sentence in Expression.contains_over_clause docs.  
							
							
							
						 
						
							2018-07-05 11:12:08 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								7543ab1f8d 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 2.0.  
							
							
							
						 
						
							2018-05-17 11:00:10 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								35319bf12c 
								
							 
						 
						
							
							
								
								Alphabetized imports in various docs.  
							
							... 
							
							
							
							Follow-up of d97cce34097d3fe36c62 
							
						 
						
							2018-05-12 19:37:42 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									drd0013 
								
							 
						 
						
							
							
							
							
								
							
							
								5d923f2d8c 
								
							 
						 
						
							
							
								
								Fixed   #29313  -- Doc'd how to use F() to sort null values.  
							
							
							
						 
						
							2018-04-19 20:07:40 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Matthew Wilkes 
								
							 
						 
						
							
							
							
							
								
							
							
								2162f0983d 
								
							 
						 
						
							
							
								
								Fixed   #24747  -- Allowed transforms in QuerySet.order_by() and distinct(*fields).  
							
							
							
						 
						
							2018-02-10 19:08:55 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									priyanshsaxena 
								
							 
						 
						
							
							
							
							
								
							
							
								617d5f410f 
								
							 
						 
						
							
							
								
								Fixed   #29066  -- Allowed negating query expressions.  
							
							
							
						 
						
							2018-01-31 10:54:19 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Igor Starikov 
								
							 
						 
						
							
							
							
							
								
							
							
								3cc08f4b2b 
								
							 
						 
						
							
							
								
								Fixed typo in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2017-12-05 08:39:57 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Benjamin Bach 
								
							 
						 
						
							
							
							
							
								
							
							
								bf49d9eb0b 
								
							 
						 
						
							
							
								
								Fixed   #28815  -- Fixed ExtractYear imports in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2017-11-17 17:30:21 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								327f0f37ce 
								
							 
						 
						
							
							
								
								Fixed   #28770  -- Warned that quoting a placeholder in a raw SQL string is unsafe.  
							
							... 
							
							
							
							Thanks Hynek Cernoch for the report and review. 
							
						 
						
							2017-11-07 13:07:12 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								1e7dbbdec5 
								
							 
						 
						
							
							
								
								Fixed   #28680  -- Doc'd Func.__init__()'s **extra and as_sql()'s **extra_context aren't escaped.  
							
							... 
							
							
							
							Thanks Hynek Cernoch for the report and review. 
							
						 
						
							2017-11-01 11:34:06 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								5446b72003 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.11.  
							
							
							
						 
						
							2017-09-22 12:51:18 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mads Jensen 
								
							 
						 
						
							
							
							
							
								
							
							
								d549b88050 
								
							 
						 
						
							
							
								
								Fixed   #26608  -- Added support for window expressions (OVER clause).  
							
							... 
							
							
							
							Thanks Josh Smeaton, Mariusz Felisiak, Sergey Fedoseev, Simon Charettes,
Adam Chainz/Johnson and Tim Graham for comments and reviews and Jamie
Cockburn for initial patch. 
							
						 
						
							2017-09-18 09:42:29 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tom 
								
							 
						 
						
							
							
							
							
								
							
							
								b78d100fa6 
								
							 
						 
						
							
							
								
								Fixed   #27849  -- Added filtering support to aggregates.  
							
							
							
						 
						
							2017-08-12 17:58:28 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								487362fa8f 
								
							 
						 
						
							
							
								
								Fixed   #28370  -- Deprecated the context arg of Field.from_db_value() and Expression.convert_value().  
							
							... 
							
							
							
							Unused since a0d166306f 
							
						 
						
							2017-07-20 16:30:08 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tomer Chachamu 
								
							 
						 
						
							
							
							
							
								
							
							
								62917cee5a 
								
							 
						 
						
							
							
								
								Doc'd the need to remove default ordering on Subquery aggregates.  
							
							
							
						 
						
							2017-07-18 08:48:25 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Alasdair Nicol 
								
							 
						 
						
							
							
							
							
								
							
							
								757aefc12b 
								
							 
						 
						
							
							
								
								Removed self from method signatures in docs.  
							
							
							
						 
						
							2017-03-16 20:33:59 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									lb1c 
								
							 
						 
						
							
							
							
							
								
							
							
								36f2262741 
								
							 
						 
						
							
							
								
								Fixed incorrect import in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2017-03-15 08:09:48 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									chillaranand 
								
							 
						 
						
							
							
							
							
								
							
							
								dc165ec8e5 
								
							 
						 
						
							
							
								
								Refs  #23919  -- Replaced super(ClassName, self) with super() in docs.  
							
							
							
						 
						
							2017-01-25 11:53:05 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Paolo Melchiorre 
								
							 
						 
						
							
							
							
							
								
							
							
								5890d6ab03 
								
							 
						 
						
							
							
								
								Fixed typo in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2017-01-25 07:46:18 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								e27e4c0339 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 1.10.  
							
							
							
						 
						
							2017-01-17 20:52:05 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Matthew Schinckel 
								
							 
						 
						
							
							
							
							
								
							
							
								236ebe94bf 
								
							 
						 
						
							
							
								
								Fixed   #27149  -- Added Subquery and Exists database expressions.  
							
							... 
							
							
							
							Thanks Josh Smeaton for Oracle fixes. 
							
						 
						
							2017-01-14 09:12:24 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Yohann Gabory 
								
							 
						 
						
							
							
							
							
								
							
							
								47ef8f31f3 
								
							 
						 
						
							
							
								
								Fixed   #13312  -- Allowed specifying the order of null fields in queries.  
							
							... 
							
							
							
							Thanks Mariusz Felisiak for finishing the patch. 
							
						 
						
							2016-12-08 09:54:07 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								0d6c7cae7c 
								
							 
						 
						
							
							
								
								Inlined a note in docs/ref/models/expressions.txt.  
							
							
							
						 
						
							2016-11-09 08:20:59 -05:00