summaryrefslogtreecommitdiff
path: root/docs/ref/models
AgeCommit message (Collapse)Author
2013-11-27Added a bulk option to RelatedManager remove() and clear() methodsLoic Bistuer
Refs #21169
2013-11-27Fixed #21169 -- Reworked RelatedManager methods use default filteringLoic Bistuer
The `remove()` and `clear()` methods of the related managers created by `ForeignKey`, `GenericForeignKey`, and `ManyToManyField` suffered from a number of issues. Some operations ran multiple data modifying queries without wrapping them in a transaction, and some operations didn't respect default filtering when it was present (i.e. when the default manager on the related model implemented a custom `get_queryset()`). Fixing the issues introduced some backward incompatible changes: - The implementation of `remove()` for `ForeignKey` related managers changed from a series of `Model.save()` calls to a single `QuerySet.update()` call. The change means that `pre_save` and `post_save` signals aren't called anymore. - The `remove()` and `clear()` methods for `GenericForeignKey` related managers now perform bulk delete so `Model.delete()` isn't called anymore. - The `remove()` and `clear()` methods for `ManyToManyField` related managers perform nested queries when filtering is involved, which may or may not be an issue depending on the database and the data itself. Refs. #3871, #21174. Thanks Anssi Kääriäinen and Tim Graham for the reviews.
2013-11-26Fixed a typo in the documentationAlex Gaynor
2013-11-25Fixed #21507 -- Corrected default widget information for FileFieldLudwik Trammer
2013-11-23Add missing commas in Prefetch docsThomas Orozco
2013-11-23Fixed #21491 -- Removed documented workaround for a known issue.Loic Bistuer
The issue was that two M2M hidden reverse managers (related_name ending with a '+') could clash with each other. Refs #21375 and #15932. Thanks Baptiste.
2013-11-21Fixed #21479 -- Favor 'migrate' over 'syncdb' in the docs.Loic Bistuer
2013-11-21Fixed #21427 -- Clearly state integer field value ranges in docsMarkus Amalthea Magnuson
Added an explicit mention of the exact value ranges for integer type fields that are safe in all databases supported by Django. Also, put all value numbers inside double ticks.
2013-11-07Fixed #17001 -- Custom querysets for prefetch_related.Loic Bistuer
This patch introduces the Prefetch object which allows customizing prefetch operations. This enables things like filtering prefetched relations, calling select_related from a prefetched relation, or prefetching the same relation multiple times with different querysets. When a Prefetch instance specifies a to_attr argument, the result is stored in a list rather than a QuerySet. This has the fortunate consequence of being significantly faster. The preformance improvement is due to the fact that we save the costly creation of a QuerySet instance. Thanks @akaariai for the original patch and @bmispelon and @timgraham for the reviews.
2013-11-06Fixed typos in documentation.Baptiste Mispelon
2013-10-28Fixed #21344 -- Typo in docs/ref/models/queries.txtTim Graham
2013-10-23Fixed #13245: Explained Oracle's behavior w.r.t db_tableShai Berger
and how to prevent table-name truncation Thanks russellm & timo for discussion, and timo for review.
2013-10-22Fixed #17027 -- Added support for the power operator in F expressions.Florian Hahn
Thanks dan at dlo.me for the initial patch. - Added __pow__ and __rpow__ to ExpressionNode - Added oracle and mysql specific power expressions - Added used-defined power function for sqlite
2013-10-18Fixed #21212 -- Documented the reverse name for OneToOneField.Juergen Schackmann
Thanks bjb at credil.org for the report.
2013-10-15Fixed #16855 -- select_related() chains as expected.Marc Tamlyn
select_related('foo').select_related('bar') is now equivalent to select_related('foo', 'bar'). Also reworded docs to recommend select_related(*fields) over select_related()
2013-10-11Fixed #8918 -- Made FileField.upload_to optional.Tim Graham
Thanks leahculver for the suggestion and dc and vajrasky for work on the patch.
2013-10-10Whitespace cleanup.Tim Graham
* Removed trailing whitespace. * Added newline to EOF if missing. * Removed blank lines at EOF. * Removed some stray tabs.
2013-10-02Fixed #10913 -- Documented how related_name affects QuerySet filteringTim Graham
Thanks neithere for the suggestion.
2013-09-28Fixed #20439 -- Started deprecation of IPAddressFieldErik Romijn
2013-09-21Correct very minor typomlissner
Just changed as to has.
2013-09-13Fixed #21095 -- Documented new requirement for dates lookups.Matt Austin
Day, month, and week_day lookups now require time zone definitions in the database.
2013-09-09Fixed spelling; refs #16895.Tim Graham
Thanks Panagiotis Issaris for the report.
2013-09-09Fixed #16895 -- Warned about cost of QuerySet orderinge0ne
Thanks outofculture at gmail.com for the suggestion.
2013-09-07Fixed #20409 -- Clarified how unique_for_date works when USE_TZ is set.Aymeric Augustin
2013-09-06Merge pull request #1567 from technivore/ticket_20970Tim Graham
re-indented method documentation within RelatedManager
2013-09-06re-indented method documentation within RelatedManagerMatthew Rich
2013-09-06Merge pull request #1544 from evildmp/ticket_20920_rebaseDaniele Procida
Fixed #20920 -- Consolidated F() and Q() documentation
2013-09-06Consolidated documentation for F() and Q()evildmp
2013-09-06documented RelatedManager calling save() behind the scenes, added section on ↵Matthew Rich
direct replacement of related object set
2013-09-05Fixed #21035 -- Changed docs to treat the acronym SQL phonetically.Eric Boersma
The documentation and comments now all use 'an' to refer to the word SQL and not 'a'.
2013-08-30Fixed typo in docs/ref/models/options.txtTim Graham
2013-08-30Fixed #20988 -- Added model meta option select_on_saveAnssi Kääriäinen
The option can be used to force pre 1.6 style SELECT on save behaviour. This is needed in case the database returns zero updated rows even if there is a matching row in the DB. One such case is PostgreSQL update trigger that returns NULL. Reviewed by Tim Graham. Refs #16649
2013-08-23Merge remote-tracking branch 'core/master' into schema-alterationAndrew Godwin
Conflicts: django/db/backends/oracle/base.py django/db/backends/postgresql_psycopg2/base.py django/db/models/signals.py tests/queries/tests.py
2013-08-22Fixed model.__eq__ and __hash__ for no pk value casesAnssi Kääriäinen
The __eq__ method now considers two instances without primary key value equal only when they have same id(). The __hash__ method raises TypeError for no primary key case. Fixed #18864, fixed #18250 Thanks to Tim Graham for docs review.
2013-08-21Documentation - Noted that OneToOneField doesn't respect unique.Kevin Christopher Henry
Added OneToOneField to the list of model fields for which the unique argument isn't valid. (OneToOneFields are inherently unique, and if the user supplies a value for unique it is ignored / overwritten.)
2013-08-21Documentation -- Corrected error about Model.full_clean()Kevin Christopher Henry
Although the ModelForm validation code was changed to call Model.full_clean(), the documentation still said otherwise. The offending phrase was removed.
2013-08-20Documentation - Noted that OneToOneField doesn't respect unique.Kevin Christopher Henry
Added OneToOneField to the list of model fields for which the unique argument isn't valid. (OneToOneFields are inherently unique, and if the user supplies a value for unique it is ignored / overwritten.)
2013-08-19Merge remote-tracking branch 'core/master' into schema-alterationAndrew Godwin
Conflicts: docs/ref/django-admin.txt
2013-08-19Removed versionadded/changed annotations for 1.5Tim Graham
2013-08-19Fixed #20777 -- Admin proxy model deletion regressionAnssi Kääriäinen
Added proxy_models tests by Harm Geerts <github@geertswei.nl>.
2013-08-19Made Model.__eq__ consider proxy models equivalentAnssi Kääriäinen
Fixed #11892, fixed #16458, fixed #14492.
2013-08-15Fixed some ReST errors regarding backticksTim Graham
2013-08-09Merge remote-tracking branch 'core/master' into schema-alterationAndrew Godwin
Conflicts: django/db/models/options.py
2013-08-09Fixed #9057 -- Added default_permissions model meta option.Tim Graham
Thanks hvendelbo for the suggestion and koenb for the draft patch.
2013-08-09Merge remote-tracking branch 'core/master' into schema-alterationAndrew Godwin
Conflicts: django/core/management/commands/flush.py django/core/management/commands/syncdb.py django/db/models/loading.py docs/internals/deprecation.txt docs/ref/django-admin.txt docs/releases/1.7.txt
2013-08-07Merge pull request #1453 from chrismedrela/ticket20484-improvementPreston Holmes
Fixed #20484 again -- added note to field documentation
2013-08-07Fixed #20484 again -- added note to field documentationChristopher Medrela
2013-08-06Fixed #20852 - Fixed incorrectly generated left quotes in docs.Dominic Rodger
Sphinx generates left single quotes for apostrophes after code markup, when right single quotes are required. The easiest way to fix this is just by inserting the unicode character for a right single quote. Instances of the problem were found by looking for ">&#8216;" in the generated HTML.
2013-08-05Fixed #20859 - Clarified Model.clean() example.Jimmy Song
2013-08-04Fixed #20842 and #20845 - Added a note on order_by() and improved ↵Daniele Procida
prefetch_related() docs.