Commit Graph

288 Commits

Author SHA1 Message Date
Hasan Ramezani 2b443cb6c2 [3.1.x] Fixed #32315 -- Doc'd FieldFile.path.
Backport of 3eb98743dc from master
2021-01-07 12:53:04 +01:00
Fabio Sangiovanni 6d3a623f71 [3.1.x] Fixed #32310 -- Fixed note about reverse accessors for intermediate table for self-referential ManyToManyField.
Backport of 2d6c9b97bc from master
2021-01-04 22:21:17 +01:00
Adam Johnson 2b3ca7a5f1 [3.1.x] Doc'd Model.MultipleObjectsReturned docs and improved documentation related with models exceptions.
Backport of bc4fea92b2 from master
2020-07-22 20:21:06 +02:00
Adam Johnson 32e22f0531 [3.1.x] Improved ManyToManyField.through docs.
Backport of e7fa8aff43 from master
2020-07-17 10:48:13 +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
Tim Graham 8b1d361f28
Fixed #29549 -- Doc'd that Field.choices are enforced by model validation. 2018-07-09 15:06:36 -04:00
Srinivas Reddy Thatiparthy 4c35a173e8 Fixed #29423 -- Documented Field.value_from_object(). 2018-05-25 15:10:45 -04:00
Tim Graham e038f98bf3 Fixed #29398 -- Doc'd that cascade deletion doesn't call delete() of related models. 2018-05-18 18:08:37 -04:00
Tim Graham 5fa4f40f45 Fixed #29227 -- Allowed BooleanField to be null=True.
Thanks Lynn Cyrin for contributing to the patch, and Nick Pope for review.
2018-03-20 12:10:10 -04:00
Cameron Curry 622ead6aaf Fixed #28937 -- Allowed BinaryField to be editable=True. 2017-12-22 16:31:46 -05:00
Tim Graham 5446b72003 Removed versionadded/changed annotations for 1.11. 2017-09-22 12:51:18 -04:00
Tim Graham 6e4a34580d Fixed #28557 -- Fixed ForeignKey/OneToOneField/ManyToManyField argument name in docs. 2017-09-01 20:03:32 -04:00
Tim Graham 50a97edc1a Fixed #28466 -- Clarified the definition of a lazy relationship. 2017-08-07 15:51:46 -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