summaryrefslogtreecommitdiff
path: root/docs/ref/models/instances.txt
AgeCommit message (Collapse)Author
2026-01-19Fixed unbalanced parentheses in docs.Clifford Gama
2025-10-29Fixed #36329 -- Removed non-code custom link text when cross-referencing ↵Clifford Gama
Python objects. Thanks Bruno Alla, Sarah Boyce, and Jacob Walls for reviews. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2025-10-18Fixed #21961 -- Added support for database-level delete options for ForeignKey.Mariusz Felisiak
Thanks Simon Charette for pair programming. Co-authored-by: Nick Stefan <NickStefan12@gmail.com> Co-authored-by: Akash Kumar Sen <71623442+Akash-Kumar-Sen@users.noreply.github.com> Co-authored-by: Simon Charette <charette.s@gmail.com>
2025-10-16Fixed #28586 -- Added model field fetch modes.Adam Johnson
May your database queries be much reduced with minimal effort. co-authored-by: Andreas Pelme <andreas@pelme.se> co-authored-by: Simon Charette <charette.s@gmail.com> co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
2025-09-17Removed versionadded/changed annotations for 5.2.Jacob Walls
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
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-25Refs #36485 -- Removed unnecessary parentheses in :meth: and :func: roles in ↵David Smith
docs.
2025-07-23Removed double spaces after periods and within phrases.Sarah Boyce
2025-04-15Fixed #36311 -- Unified spelling of "hardcode" and its variants in docs.Ahmed Nassar
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2025-03-10Fixed #33579 -- Specialized exception raised on forced update failures.Simon Charette
Raising DatabaseError directly made it harder than it should to differentiate between IntegrityError when a forced update resulted in no affected rows. Introducing a specialized exception allows for callers to more easily silence, log, or turn them update failures into user facing exceptions (e.g. 404s). Thanks Mariusz for the review.
2025-01-15Refs #35060 -- Removed passing positional arguments to Model.save()/asave() ↵Sarah Boyce
per deprecation timeline.
2025-01-15Removed versionadded/changed annotations for 5.1.Sarah Boyce
This also removes remaining versionadded/changed annotations for older versions.
2025-01-15Refs #36070 -- Referred to pk as an attribute when a composite primary key ↵Jacob Walls
is defined. This is to avoid confusion that a field is often associated with having a single associated database column.
2025-01-13Fixed #36077 -- Corrected docs on pk value where Model.save() executes an ↵Jacob Walls
UPDATE. The empty string is no longer special-cased since c2ba59fc1da5287d6286e2c2aca4083d5bafe056.
2024-09-09Refs #373 -- Added Model._is_pk_set() abstraction to check if a Model's PK ↵Csirmaz Bendegúz
is set.
2024-05-30Made cosmetic edits to code snippets reformatted with blacken-docs.Mariusz Felisiak
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-03-18Refs #34059, Refs #34060 -- Removed outdated warning about validation of ↵Mariusz Felisiak
JSONField constraints. Known issues have been fixed in: - 0d8fbe2ade29f1b7bd9e6ba7a0281f5478603a43, - c991602ce5798385261381025c06698d7fd30dc5, and - 26aae5614487f58ddb1df5726224393887373ecd.
2024-01-15Fixed #28344 -- Allowed customizing queryset in ↵Aivars Kalvans
Model.refresh_from_db()/arefresh_from_db(). The from_queryset parameter can be used to: - use a custom Manager - lock the row until the end of transaction - select additional related objects
2024-01-02Fixed #35060 -- Deprecated passing positional arguments to Model.save()/asave().Salvo Polizzi
2023-10-05Refs #31435 -- Doc'd potential infinite recursion when accessing model ↵David Sanders
fields in __init__.
2023-09-18Removed versionadded/changed annotations for 4.2.Mariusz Felisiak
This also removes remaining versionadded/changed annotations for older versions.
2023-08-30 Fixed #31262 -- Added support for mappings on model fields and ↵Nick Pope
ChoiceField's choices.
2023-06-29Fixed #30382 -- Allowed specifying parent classes in force_insert of ↵Akash Kumar Sen
Model.save().
2023-05-12Fixed #470 -- Added support for database defaults on fields.Ian Foote
Special thanks to Hannes Ljungberg for finding multiple implementation gaps. Thanks also to Simon Charette, Adam Johnson, and Mariusz Felisiak for reviews.
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2023-01-20Fixed #34242 -- Doc'd that primary key is set to None when deleting objects.noFFENSE
2023-01-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
2022-11-10Updated documentation and comments for RFC updates.Nick Pope
- Updated references to RFC 1123 to RFC 5322 - Only partial as RFC 5322 sort of sub-references RFC 1123. - Updated references to RFC 2388 to RFC 7578 - Except RFC 2388 Section 5.3 which has no equivalent. - Updated references to RFC 2396 to RFC 3986 - Updated references to RFC 2616 to RFC 9110 - Updated references to RFC 3066 to RFC 5646 - Updated references to RFC 7230 to RFC 9112 - Updated references to RFC 7231 to RFC 9110 - Updated references to RFC 7232 to RFC 9110 - Updated references to RFC 7234 to RFC 9111 - Tidied up style of text when referring to RFC documents
2022-11-10Improved readability of string interpolation in frequently used examples in ↵Trey Hunner
docs.
2022-11-02Fixed #34112 -- Added async-compatible interface to Model methods.DevilsAutumn
Thanks Adam Johnson for the review.
2022-10-12Refs #34059 -- Doc'd lack of support for validation of constraints with ↵Mariusz Felisiak
JSONFields. Thanks Dan LaManna for the report.
2022-09-28Changed note about update_fields and pre_save() to admonition.Mariusz Felisiak
Follow up to bf47c719719d0e190a99fa2e7f959d5bbb7caf8a.
2022-09-27Doc'd when pre_save() is called with Model.save()'s update_fields.sarahboyce
2022-08-30Refs #30947 -- Changed tuples to lists where appropriate.Alex Morega
2022-05-24Fixed #33724 -- Doc'd exclude argument changes in model validation.Mariusz Felisiak
Thanks אורי for the report. Follow up to 1ea7e3157d1f9b4db71e768d75ea57e47dbd49f9.
2022-05-18Refs #30581 -- Updated count of steps in model validation docs.Joachim Jablon
Follow-up to 667105877e6723c6985399803a364848891513cc.
2022-05-10Fixed #30581 -- Added support for Meta.constraints validation.Gagaro
Thanks Simon Charette, Keryn Knight, and Mariusz Felisiak for reviews.
2022-05-06Fixed #33680 -- Corrected example of customizing model loading in docs.Ali Toosi
2021-07-29Fixed 32956 -- Lowercased spelling of "web" and "web framework" where ↵David Smith
appropriate.
2021-07-26Fixed #32957 -- Improved visibility of arguments sections in Model.save() docs.abhiabhi94
2021-05-18Fixed #32755 -- Corrected Model.get_absolute_url() example in docs.Girish Sontakke
2021-01-14Removed versionadded/changed annotations for 3.1.Mariusz Felisiak
2020-12-15Added backticks to code literals in various docs.Jon Dufresne
2020-07-22Refs #24763 -- Moved DoesNotExist to Model class docs.Adam Johnson
2020-07-08Fixed #31502 -- Documented Model._state.db and Model._state.addingTim Park
2020-05-13Removed versionadded/changed annotations for 3.0.Mariusz Felisiak
2020-05-04Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and ↵Adam Johnson
comments.
2020-01-17Added missing backtick in instances docs.Claude Paroz