David Smith 
								
							 
						 
						
							
							
							
							
								
							
							
								1024b5e74a 
								
							 
						 
						
							
							
								
								Fixed 32956 -- Lowercased spelling of "web" and "web framework" where appropriate.  
							
							
							
						 
						
							2021-07-29 06:24:12 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Nick Pope 
								
							 
						 
						
							
							
							
							
								
							
							
								88b3982af3 
								
							 
						 
						
							
							
								
								Fixed a typo in docs/ref/models/fields.txt.  
							
							... 
							
							
							
							datetime.date.utcnow() doesn't exist, should be .today(). 
							
						 
						
							2021-05-12 11:06:29 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Nick Pope 
								
							 
						 
						
							
							
							
							
								
							
							
								41e39c41c9 
								
							 
						 
						
							
							
								
								Refs  #32460  -- Doc'd and tested that property names of model choice enums cannot be used as members.  
							
							
							
						 
						
							2021-03-24 07:45:33 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								d992f4e3c2 
								
							 
						 
						
							
							
								
								Refs  #31369  -- Removed models.NullBooleanField per deprecation timeline.  
							
							
							
						 
						
							2021-01-14 17:50:04 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								b7dd89ed53 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 3.1.  
							
							
							
						 
						
							2021-01-14 17:50:04 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Hasan Ramezani 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								3eb98743dc 
								
							 
						 
						
							
							
								
								Fixed   #32315  -- Doc'd FieldFile.path.  
							
							
							
						 
						
							2021-01-07 12:51:59 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Fabio Sangiovanni 
								
							 
						 
						
							
							
							
							
								
							
							
								2d6c9b97bc 
								
							 
						 
						
							
							
								
								Fixed   #32310  -- Fixed note about reverse accessors for intermediate table for self-referential ManyToManyField.  
							
							
							
						 
						
							2021-01-04 20:16:07 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								74fd233b14 
								
							 
						 
						
							
							
								
								Fixed   #32303  -- Bumped minimum supported SQLite to 3.9.0.  
							
							
							
						 
						
							2020-12-30 09:01:56 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tom Forbes 
								
							 
						 
						
							
							
							
							
								
							
							
								b5e12d490a 
								
							 
						 
						
							
							
								
								Fixed   #31007  -- Allowed specifying type of auto-created primary keys.  
							
							... 
							
							
							
							This also changes the default type of auto-created primary keys
for new apps and projects to BigAutoField. 
							
						 
						
							2020-12-15 11:25:46 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tom Carrick 
								
							 
						 
						
							
							
							
							
								
							
							
								e387f191f7 
								
							 
						 
						
							
							
								
								Fixed   #31777  -- Added support for database collations to Char/TextFields.  
							
							... 
							
							
							
							Thanks Simon Charette and Mariusz Felisiak for reviews. 
							
						 
						
							2020-09-21 18:24:56 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
							
							
								
							
							
								bc4fea92b2 
								
							 
						 
						
							
							
								
								Doc'd Model.MultipleObjectsReturned docs and improved documentation related with models exceptions.  
							
							
							
						 
						
							2020-07-22 14:21:08 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
							
							
								
							
							
								e7fa8aff43 
								
							 
						 
						
							
							
								
								Improved ManyToManyField.through docs.  
							
							
							
						 
						
							2020-07-17 10:29:24 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								4c5236ef93 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 3.0.  
							
							
							
						 
						
							2020-05-13 09:07:51 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									sage 
								
							 
						 
						
							
							
							
							
								
							
							
								6789ded0a6 
								
							 
						 
						
							
							
								
								Fixed   #12990 , Refs  #27694  -- Added JSONField model field.  
							
							... 
							
							
							
							Thanks to Adam Johnson, Carlton Gibson, Mariusz Felisiak, and Raphael
Michel for mentoring this Google Summer of Code 2019 project and
everyone else who helped with the patch.
Special thanks to Mads Jensen, Nick Pope, and Simon Charette for
extensive reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com> 
							
						 
						
							2020-05-08 07:23:31 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								1c2c6f1b51 
								
							 
						 
						
							
							
								
								Fixed a/an typos in "SQL" usage.  
							
							
							
						 
						
							2020-05-06 06:35:26 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
							
							
								
							
							
								d17b380653 
								
							 
						 
						
							
							
								
								Refs  #30573  -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.  
							
							
							
						 
						
							2020-05-04 12:10:47 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
							
							
								
							
							
								787981f9d1 
								
							 
						 
						
							
							
								
								Corrected models.FilePathField signature in docs.  
							
							
							
						 
						
							2020-05-04 12:10:41 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Hasan Ramezani 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								d6db186427 
								
							 
						 
						
							
							
								
								Fixed   #31514  -- Fixed default form widgets in model fields docs.  
							
							
							
						 
						
							2020-04-25 21:20:29 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Schilling 
								
							 
						 
						
							
							
							
							
								
							
							
								a92cc84b4a 
								
							 
						 
						
							
							
								
								Refs  #31369  -- Deprecated models.NullBooleanField in favor of BooleanField(null=True).  
							
							
							
						 
						
							2020-04-24 10:10:45 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								cc70a0343e 
								
							 
						 
						
							
							
								
								Fixed term warning on Sphinx 3.0.1+.  
							
							... 
							
							
							
							"term" role became case sensitive in Sphinx 3.0.1. 
							
						 
						
							2020-04-14 09:32:09 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									miigotu 
								
							 
						 
						
							
							
							
							
								
							
							
								210657b791 
								
							 
						 
						
							
							
								
								Fixed   #28184  -- Allowed using a callable for FileField and ImageField storage.  
							
							
							
						 
						
							2020-04-08 11:26:17 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Adam Johnson 
								
							 
						 
						
							
							
							
							
								
							
							
								1cdfe8d912 
								
							 
						 
						
							
							
								
								Prevented (and corrected) single backtick usage in docs.  
							
							
							
						 
						
							2020-04-01 14:55:11 +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 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Andrey Doroschenko 
								
							 
						 
						
							
							
							
							
								
							
							
								f1016814d8 
								
							 
						 
						
							
							
								
								Fixed   #31313  -- Fixed is_upperclass() example in enumeration types docs.  
							
							
							
						 
						
							2020-02-27 08:33:05 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Daniel Izquierdo 
								
							 
						 
						
							
							
							
							
								
							
							
								89abecc75d 
								
							 
						 
						
							
							
								
								Fixed   #27272  -- Added an on_delete RESTRICT handler to allow cascading deletions while protecting direct ones.  
							
							
							
						 
						
							2019-11-19 10:55:05 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Caio Ariede 
								
							 
						 
						
							
							
							
							
								
							
							
								555bebe774 
								
							 
						 
						
							
							
								
								Fixed   #30987  -- Added models.PositiveBigIntegerField.  
							
							
							
						 
						
							2019-11-19 09:34:11 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
							
							
								
							
							
								343afa7880 
								
							 
						 
						
							
							
								
								Refs  #29915  -- Doc'd limitation of using pattern lookups with UUIDField on PostgreSQL.  
							
							
							
						 
						
							2019-09-23 08:24:00 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Claude Paroz 
								
							 
						 
						
							
							
							
							
								
							
							
								b8dff52f44 
								
							 
						 
						
							
							
								
								Fixed   #29823  -- Doc'd limitation of DecimalField on SQLite.  
							
							
							
						 
						
							2019-09-14 17:10:08 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Nick Pope 
								
							 
						 
						
							
							
							
							
								
							
							
								1c66767d4e 
								
							 
						 
						
							
							
								
								Refs  #27910  -- Improved documentation for model field choice enumeration types.  
							
							
							
						 
						
							2019-09-13 15:37:40 +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 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Shai Berger 
								
							 
						 
						
							
							
							
							
								
							
							
								72ebe85a26 
								
							 
						 
						
							
							
								
								Fixed   #27910  -- Added enumeration helpers for use in Field.choices.  
							
							... 
							
							
							
							These classes can serve as a base class for user enums, supporting
translatable human-readable names, or names automatically inferred
from the enum member name.
Additional properties make it easy to access the list of names, values
and display labels.
Thanks to the following for ideas and reviews:
Carlton Gibson, Fran Hrženjak, Ian Foote, Mariusz Felisiak, Shai Berger.
Co-authored-by: Shai Berger <shai@platonix.com>
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com>
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com> 
							
						 
						
							2019-09-04 14:42:49 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Claude Paroz 
								
							 
						 
						
							
							
							
							
								
							
							
								d1c2e6dd04 
								
							 
						 
						
							
							
								
								Refs  #28428  -- Made FileField.upload_to support pathlib.Path.  
							
							
							
						 
						
							2019-08-18 20:34:58 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Nick Pope 
								
							 
						 
						
							
							
							
							
								
							
							
								194d1dfc18 
								
							 
						 
						
							
							
								
								Fixed   #30661  -- Added models.SmallAutoField.  
							
							
							
						 
						
							2019-08-02 11:39:01 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								5ed20b3aa3 
								
							 
						 
						
							
							
								
								Fixed   #30657  -- Allowed customizing Field's descriptors with a descriptor_class attribute.  
							
							... 
							
							
							
							Allows model fields to override the descriptor class used on the model
instance attribute. 
							
						 
						
							2019-07-25 08:15:20 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Nadège Michel 
								
							 
						 
						
							
							
							
							
								
							
							
								87b1ad6e73 
								
							 
						 
						
							
							
								
								Fixed   #30421  -- Allowed symmetrical intermediate table for self-referential ManyToManyField.  
							
							
							
						 
						
							2019-06-21 15:03:17 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Caio Ariede 
								
							 
						 
						
							
							
							
							
								
							
							
								5248abe9b0 
								
							 
						 
						
							
							
								
								Fixed   #30505  -- Doc'd how changes in the order of Field.choices affect migrations.  
							
							
							
						 
						
							2019-06-04 14:11:41 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								e86cc14bd3 
								
							 
						 
						
							
							
								
								Changed docs to link to Python's description of iterable.  
							
							
							
						 
						
							2019-05-17 17:27:19 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								97d3321e89 
								
							 
						 
						
							
							
								
								Changed tuple choices to list in docs.  
							
							
							
						 
						
							2019-05-15 14:31:42 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mykola Kokalko 
								
							 
						 
						
							
							
							
							
								
							
							
								ef082ebb84 
								
							 
						 
						
							
							
								
								Fixed   #29529  -- Allowed models.fields.FilePathField to accept a callable path.  
							
							
							
						 
						
							2019-05-02 11:11:56 +02:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Mariusz Felisiak 
								
							 
						 
						
							
							
								
								
							
							
							
								
							
							
								b0799f5d86 
								
							 
						 
						
							
							
								
								Fixed documentation of database representation for ManyToManyField.  
							
							
							
						 
						
							2019-02-25 20:05:31 +01:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Tim Graham 
								
							 
						 
						
							
							
							
							
								
							
							
								ec7e179aeb 
								
							 
						 
						
							
							
								
								Removed versionadded/changed annotations for 2.1.  
							
							
							
						 
						
							2019-01-17 10:50:25 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									François Freitag 
								
							 
						 
						
							
							
							
							
								
							
							
								9b15ff08ba 
								
							 
						 
						
							
							
								
								Used auto-numbered lists in documentation.  
							
							
							
						 
						
							2018-11-15 13:54:28 -05:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Andrea Rabbaglietti 
								
							 
						 
						
							
							
							
							
								
							
							
								1b49b792e9 
								
							 
						 
						
							
							
								
								Emphasized that ForeignKey.on_delete doesn't create a SQL constraint.  
							
							
							
						 
						
							2018-10-10 14:56:50 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								b3b47bf515 
								
							 
						 
						
							
							
								
								Added tests for using bytearray with BinaryField and corrected docs.  
							
							
							
						 
						
							2018-10-01 09:16:16 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								fb2964a410 
								
							 
						 
						
							
							
								
								Added test of filtering on BinaryField and corrected docs.  
							
							
							
						 
						
							2018-09-26 14:38:12 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jon Dufresne 
								
							 
						 
						
							
							
							
							
								
							
							
								8c3e0eb1c1 
								
							 
						 
						
							
							
								
								Normalized spelling of "lowercase" and "lowercased".  
							
							
							
						 
						
							2018-09-25 10:30:18 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Curtis Maloney 
								
							 
						 
						
							
							
							
							
								
							
							
								c49ea6f591 
								
							 
						 
						
							
							
								
								Refs  #20910  -- Replaced snippet directive with code-block.  
							
							
							
						 
						
							2018-09-10 13:00:34 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Matt Wiens 
								
							 
						 
						
							
							
							
							
								
							
							
								c122a7c53c 
								
							 
						 
						
							
							
								
								Fixed typo in docs/ref/models/fields.txt.  
							
							
							
						 
						
							2018-08-28 07:53:09 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Jeff 
								
							 
						 
						
							
							
							
							
								
							
							
								3fa3de5415 
								
							 
						 
						
							
							
								
								Fixed   #29646  -- Doc'd the validators that each model and form field uses.  
							
							
							
						 
						
							2018-08-16 17:03:28 -04:00 
							
								 
							
							
								 
							
						 
					 
				
					
						
							
								
								
									Claude Paroz 
								
							 
						 
						
							
							
							
							
								
							
							
								6e78e10549 
								
							 
						 
						
							
							
								
								Added doc links for django.utils.html.escape().  
							
							
							
						 
						
							2018-07-18 11:32:27 -04:00