aj2s 
							
						 
					 
					
						
						
							
						
						f715bc8990 
					 
					
						
						
							
							Fixed   #36669  -- Doc'd that negative indexes are not supported in F() slices.  
						
						
						
						
					 
					
						2025-10-17 10:20:23 -04:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						00a84fc6f3 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.2.  
						
						
						
						
					 
					
						2025-09-17 15:17:05 -03:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						94680437a4 
					 
					
						
						
							
							Fixed   #27222  -- Refreshed model field values assigned expressions on save().  
						
						... 
						
						
						
						Removed the can_return_columns_from_insert skip gates on existing
field_defaults tests to confirm the expected number of queries are
performed and that returning field overrides are respected. 
						
						
					 
					
						2025-09-14 00:27:50 +02:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						21603c5b50 
					 
					
						
						
							
							Removed unused import in docs/ref/models/expressions.txt example.  
						
						
						
						
					 
					
						2025-08-31 08:15:13 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						56955636e6 
					 
					
						
						
							
							Ensured :doc: role uses absolute targets in docs.  
						
						
						
						
					 
					
						2025-08-28 13:48:32 -03:00 
						 
				 
			
				
					
						
							
							
								SaJH 
							
						 
					 
					
						
						
							
						
						3c0c54351b 
					 
					
						
						
							
							Fixed   #36570  -- Removed unnecessary :py domain from documentation roles.  
						
						... 
						
						
						
						Signed-off-by: SaJH <wogur981208@gmail.com > 
						
						
					 
					
						2025-08-28 08:52:43 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						f81e6e3a53 
					 
					
						
						
							
							Refs  #36485  -- Rewrapped docs to 79 columns line length.  
						
						... 
						
						
						
						Lines in the docs files were manually adjusted to conform to the
79 columns limit per line (plus newline), improving readability and
consistency across the content. 
						
						
					 
					
						2025-08-25 10:51:10 -03:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						6f8e23d1c1 
					 
					
						
						
							
							Refs  #36485  -- Removed unnecessary parentheses in :meth: and :func: roles in docs.  
						
						
						
						
					 
					
						2025-08-25 10:51:10 -03:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						8914f4703c 
					 
					
						
						
							
							Fixed   #35972  -- Fixed lookup crashes after subquery annotations.  
						
						
						
						
					 
					
						2025-08-04 10:14:01 +02:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						1ecf6889ca 
					 
					
						
						
							
							Removed double spaces after periods and within phrases.  
						
						
						
						
					 
					
						2025-07-23 10:09:43 -03:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						efe3ca09e0 
					 
					
						
						
							
							Fixed incorrect formatting for inline pluralized code references in docs.  
						
						
						
						
					 
					
						2025-03-13 15:18:35 -03:00 
						 
				 
			
				
					
						
							
							
								Chris Muthig 
							
						 
					 
					
						
						
							
						
						4b977a5d72 
					 
					
						
						
							
							Fixed   #35444  -- Added generic support for Aggregate.order_by.  
						
						... 
						
						
						
						This moves the behaviors of `order_by` used in Postgres aggregates into
the `Aggregate` class. This allows for creating aggregate functions that
support this behavior across all database engines. This is shown by
moving the `StringAgg` class into the shared `aggregates` module and
adding support for all databases. The Postgres `StringAgg` class is now
a thin wrapper on the new shared `StringAgg` class.
Thank you Simon Charette for the review. 
						
						
					 
					
						2025-03-03 11:37:00 +01:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						810edfd742 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.1.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2025-01-15 22:28:37 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						d206d4c200 
					 
					
						
						
							
							Fixed   #36051  -- Declared arity on aggregate functions.  
						
						... 
						
						
						
						Follow-up to 4a66a69239 
						
						
					 
					
						2025-01-14 16:47:07 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						470e5545e5 
					 
					
						
						
							
							Refs  #36042  -- Raised ValueError when providing composite expressions to aggregates.  
						
						
						
						
					 
					
						2025-01-07 11:42:06 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						2b9f0b79bc 
					 
					
						
						
							
							Fixed typo in docs/ref/models/expressions.txt.  
						
						
						
						
					 
					
						2024-08-28 09:08:16 -03:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						fed11ba461 
					 
					
						
						
							
							Fixed typo in docs/ref/models/expressions.txt.  
						
						
						
						
					 
					
						2024-08-28 09:08:16 -03:00 
						 
				 
			
				
					
						
							
							
								Devin Cox 
							
						 
					 
					
						
						
							
						
						e03083917d 
					 
					
						
						
							
							Fixed   #35586  -- Added support for set-returning database functions.  
						
						... 
						
						
						
						Aggregation optimization didn't account for not referenced set-returning annotations on Postgres.
Co-authored-by: Simon Charette <charette.s@gmail.com > 
						
						
					 
					
						2024-08-12 15:35:19 +02:00 
						 
				 
			
				
					
						
							
							
								Natalia 
							
						 
					 
					
						
						
							
						
						05cce083ad 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.0.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2024-05-22 15:44:07 -03:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						f030236a86 
					 
					
						
						
							
							Fixed   #35275  -- Fixed Meta.constraints validation crash on UniqueConstraint with OpClass().  
						
						... 
						
						
						
						This also introduces Expression.constraint_validation_compatible that
allows specifying that expression should be ignored during a constraint
validation. 
						
						
					 
					
						2024-05-14 10:34:30 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						94b6f101f7 
					 
					
						
						
							
							Fixed   #29049  -- Added slicing notation to F expressions.  
						
						... 
						
						
						
						Co-authored-by: Priyansh Saxena <askpriyansh@gmail.com >
Co-authored-by: Niclas Olofsson <n@niclasolofsson.se >
Co-authored-by: David Smith <smithdc@gmail.com >
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com >
Co-authored-by: Abhinav Yadav <abhinav.sny.2002@gmail.com > 
						
						
					 
					
						2023-12-30 08:24:30 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						0be6dde817 
					 
					
						
						
							
							Corrected code-block directives in docs.  
						
						
						
						
					 
					
						2023-12-28 19:52:15 +01:00 
						 
				 
			
				
					
						
							
							
								Viicos 
							
						 
					 
					
						
						
							
						
						e28bd6776d 
					 
					
						
						
							
							Added missing import in docs/ref/models/expressions.txt.  
						
						
						
						
					 
					
						2023-12-15 11:17:06 +01:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						e4d012ca05 
					 
					
						
						
							
							Refs  #29850  -- Added exclusion support to window frames.  
						
						
						
						
					 
					
						2023-10-30 12:04:55 +01:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						6375cee490 
					 
					
						
						
							
							Refs  #29850  -- Added RowRange support for positive integer start and negative integer end.  
						
						
						
						
					 
					
						2023-10-28 15:16:07 +02:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						8992a0489c 
					 
					
						
						
							
							Fixed typos in docs/ref/models/expressions.txt.  
						
						
						
						
					 
					
						2023-10-28 14:21:15 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						295467c04a 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.2.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2023-09-18 22:12:40 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						b719688b21 
					 
					
						
						
							
							Fixed   #34761  -- Dropped support for MySQL < 8.0.11.  
						
						
						
						
					 
					
						2023-08-03 18:54:29 +02:00 
						 
				 
			
				
					
						
							
							
								Almaz Kunpeissov 
							
						 
					 
					
						
						
							
						
						5a3725594f 
					 
					
						
						
							
							Corrected pycon formatting in some docs.  
						
						
						
						
					 
					
						2023-08-01 08:46:44 +02:00 
						 
				 
			
				
					
						
							
							
								nessita 
							
						 
					 
					
						
						
							
						
						6799288342 
					 
					
						
						
							
							Added dedicated section for output_field in query expressions docs.  
						
						
						
						
					 
					
						2023-06-27 15:05:08 -03:00 
						 
				 
			
				
					
						
							
							
								Ian Foote 
							
						 
					 
					
						
						
							
						
						7414704e88 
					 
					
						
						
							
							Fixed   #470  -- Added support for database defaults on fields.  
						
						... 
						
						
						
						Special thanks to Hannes Ljungberg for finding multiple implementation
gaps.
Thanks also to Simon Charette, Adam Johnson, and Mariusz Felisiak for
reviews. 
						
						
					 
					
						2023-05-12 19:11:40 +02:00 
						 
				 
			
				
					
						
							
							
								django-bot 
							
						 
					 
					
						
						
							
						
						14459f80ee 
					 
					
						
						
							
							Fixed   #34140  -- Reformatted code blocks in docs with blacken-docs.  
						
						
						
						
					 
					
						2023-03-01 13:03:56 +01:00 
						 
				 
			
				
					
						
							
							
								Joseph Victor Zammit 
							
						 
					 
					
						
						
							
						
						ba755ca131 
					 
					
						
						
							
							Refs  #34140  -- Corrected rst code-block and various formatting issues in docs.  
						
						
						
						
					 
					
						2023-02-28 12:21:37 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						534ac48297 
					 
					
						
						
							
							Refs  #34140  -- Applied rst code-block to non-Python examples.  
						
						... 
						
						
						
						Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for
reviews. 
						
						
					 
					
						2023-02-10 19:19:13 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						94ad46e9d8 
					 
					
						
						
							
							Refs  #33543  -- Made Expression.asc()/desc() and OrderBy raise ValueError when nulls_first/nulls_last=False is passed.  
						
						... 
						
						
						
						Per deprecation timeline. 
						
						
					 
					
						2023-01-17 11:49:15 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						490cccbe7e 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.1.  
						
						
						
						
					 
					
						2023-01-17 11:49:15 +01:00 
						 
				 
			
				
					
						
							
							
								David Wobrock 
							
						 
					 
					
						
						
							
						
						a320aab512 
					 
					
						
						
							
							Fixed   #16211  -- Added logical NOT support to F expressions.  
						
						
						
						
					 
					
						2022-10-31 09:55:51 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						c6350d594c 
					 
					
						
						
							
							Refs  #30158  -- Removed alias argument for Expression.get_group_by_cols().  
						
						... 
						
						
						
						Recent refactors allowed GROUP BY aliasing allowed for aliasing to be
entirely handled by the sql.Query.set_group_by and compiler layers. 
						
						
					 
					
						2022-10-06 12:04:00 +02:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						f387d024fc 
					 
					
						
						
							
							Refs  #28333  -- Added partial support for filtering against window functions.  
						
						... 
						
						
						
						Adds support for joint predicates against window annotations through
subquery wrapping while maintaining errors for disjointed filter
attempts.
The "qualify" wording was used to refer to predicates against window
annotations as it's the name of a specialized Snowflake extension to
SQL that is to window functions what HAVING is to aggregates.
While not complete the implementation should cover most of the common
use cases for filtering against window functions without requiring
the complex subquery pushdown and predicate re-aliasing machinery to
deal with disjointed predicates against columns, aggregates, and window
functions.
A complete disjointed filtering implementation should likely be
deferred until proper QUALIFY support lands or the ORM gains a proper
subquery pushdown interface. 
						
						
					 
					
						2022-08-15 08:26:26 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						ac90529cc5 
					 
					
						
						
							
							Fixed docs build with sphinxcontrib-spelling 7.5.0+.  
						
						... 
						
						
						
						sphinxcontrib-spelling 7.5.0+ includes captions of figures in the set
of nodes for which the text is checked. 
						
						
					 
					
						2022-05-31 11:17:01 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						ca1c3151c3 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.0.  
						
						
						
						
					 
					
						2022-05-17 14:22:06 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						68da6b389c 
					 
					
						
						
							
							Fixed   #33543  -- Deprecated passing nulls_first/nulls_last=False to OrderBy and Expression.asc()/desc().  
						
						... 
						
						
						
						Thanks Allen Jonathan David for the initial patch. 
						
						
					 
					
						2022-05-12 11:30:03 +02:00 
						 
				 
			
				
					
						
							
							
								David 
							
						 
					 
					
						
						
							
						
						ce586ed693 
					 
					
						
						
							
							Removed hyphen from pre-/re- prefixes.  
						
						... 
						
						
						
						"prepopulate", "preload", and "preprocessing" are already in the
spelling_wordlist.
This also removes hyphen from double "e" combinations with "pre" and
"re", e.g. preexisting, preempt, reestablish, or reenter.
See also:
- https://ahdictionary.com/word/search.html?q=rerun 
- https://ahdictionary.com/word/search.html?q=recreate 
- https://ahdictionary.com/word/search.html?q=predetermined 
- https://ahdictionary.com/word/search.html?q=reuse 
- https://ahdictionary.com/word/search.html?q=reopening  
						
						
					 
					
						2022-04-28 10:44:14 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						847f46e9bf 
					 
					
						
						
							
							Removed redundant QuerySet.all() calls in docs and tests.  
						
						... 
						
						
						
						Most QuerySet methods are mapped onto the Manager and, in general,
it isn't necessary to call .all() on the manager. 
						
						
					 
					
						2022-02-22 10:29:38 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						4400d8568a 
					 
					
						
						
							
							Fixed   #33391  -- Clarified Aggregate.empty_result_set_value docs.  
						
						
						
						
					 
					
						2021-12-31 06:49:10 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						aec71aaa5b 
					 
					
						
						
							
							Fixed   #33304  -- Allowed passing string expressions to Window(order_by).  
						
						
						
						
					 
					
						2021-11-23 07:58:44 +01:00 
						 
				 
			
				
					
						
							
							
								David Wobrock 
							
						 
					 
					
						
						
							
						
						ad36a198a1 
					 
					
						
						
							
							Fixed   #33141  -- Renamed Expression.empty_aggregate_value to empty_result_set_value.  
						
						
						
						
					 
					
						2021-09-29 12:58:01 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						97237ad3fe 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.2.  
						
						
						
						
					 
					
						2021-09-20 21:23:01 +02:00 
						 
				 
			
				
					
						
							
							
								David Sanders 
							
						 
					 
					
						
						
							
						
						ecf76cc1fb 
					 
					
						
						
							
							Clarified type of Window()'s partition_by and order_by arguments.  
						
						
						
						
					 
					
						2021-09-10 11:49:51 +02:00 
						 
				 
			
				
					
						
							
							
								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