e1aa932802
Added missing import in ref/models/database-functions.txt.
2019-10-02 09:58:14 +02:00
343afa7880
Refs #29915 -- Doc'd limitation of using pattern lookups with UUIDField on PostgreSQL.
2019-09-23 08:24:00 +02:00
b8dff52f44
Fixed #29823 -- Doc'd limitation of DecimalField on SQLite.
2019-09-14 17:10:08 +02:00
1c66767d4e
Refs #27910 -- Improved documentation for model field choice enumeration types.
2019-09-13 15:37:40 +02:00
0ddb4ebf7b
Refs #14357 -- Made Meta.ordering not affect GROUP BY queries.
...
Per deprecation timeline.
2019-09-10 12:01:00 +02:00
416c584cab
Removed versionadded/changed annotations for 2.2.
2019-09-10 12:01:00 +02:00
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
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
4137fc2efc
Fixed #25367 -- Allowed boolean expressions in QuerySet.filter() and exclude().
...
This allows using expressions that have an output_field that is a
BooleanField to be used directly in a queryset filters, or in the
When() clauses of a Case() expression.
Thanks Josh Smeaton, Tim Graham, Simon Charette, Mariusz Felisiak, and
Adam Johnson for reviews.
Co-Authored-By: NyanKiyoshi <hello@vanille.bid>
2019-08-29 09:45:29 +02:00
29adcd215f
Fixed #30733 -- Doc'd that datetime lookups require time zone definitions in the database.
...
Note was missing for date, year, iso_year, week, time, hour, minute,
and second lookups.
2019-08-28 08:42:55 +02:00
dba749917f
Doc'd for_save argument of Expression.resolve_expression().
2019-08-27 16:54:01 +02:00
d1c2e6dd04
Refs #28428 -- Made FileField.upload_to support pathlib.Path.
2019-08-18 20:34:58 +02:00
514efa3129
Fixed #30688 -- Clarified base_manager_name docs.
2019-08-09 10:08:06 +02:00
194d1dfc18
Fixed #30661 -- Added models.SmallAutoField.
2019-08-02 11:39:01 +02:00
5f24e7158e
Fixed #30665 -- Added support for distinct argument to Avg() and Sum().
2019-07-31 11:22:50 +02:00
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
230d75f59c
Refs #30547 -- Clarified that partial UniqueConstraints don't affect model validation.
2019-07-18 12:56:25 +02:00
febe136d4c
Fixed #30397 -- Added app_label/class interpolation for names of indexes and constraints.
2019-07-08 14:57:56 +02:00
2f91e7832f
Fixed typo in docs/ref/models/indexes.txt.
2019-06-24 08:58:56 +02:00
8590726a5d
Removed unneeded non-breaking spaces added in 00169bc36
2019-06-22 10:26:14 +02:00
87b1ad6e73
Fixed #30421 -- Allowed symmetrical intermediate table for self-referential ManyToManyField.
2019-06-21 15:03:17 +02:00
9aeac29949
Removed unnecessary backslashes from docs.
2019-06-20 14:04:36 +02:00
00169bc361
Fixed #30547 -- Doc'd how Meta.constraints affect model validation.
2019-06-20 10:44:02 +02:00
76b3fc5c8d
Fixed #30486 -- Fixed the default value of Aggregate.distinct and updated example of custom aggregate functions.
2019-06-11 11:40:48 +02:00
5248abe9b0
Fixed #30505 -- Doc'd how changes in the order of Field.choices affect migrations.
2019-06-04 14:11:41 +02:00
67b6cb7723
Fixed #30491 -- Clarified when save() on object with pk executes INSERT.
2019-05-28 11:02:26 +02:00
b6c4766f53
Refs #29548 -- Updated docs for MariaDB support.
2019-05-27 19:59:49 +02:00
5402061c80
Refs #30062 -- Corrected UniqueConstraint signature in docs.
2019-05-20 10:52:57 +02:00
e86cc14bd3
Changed docs to link to Python's description of iterable.
2019-05-17 17:27:19 +02:00
1686dce06c
Fixed #30199 -- Adjusted QuerySet.get_or_create() docs to highlight atomicity warning.
2019-05-17 12:23:10 +02:00
60b6a7ea9d
Fixed typo in expression documentation.
2019-05-16 16:03:27 +02:00
97d3321e89
Changed tuple choices to list in docs.
2019-05-15 14:31:42 +02:00
a44a21a22f
Fixed #26678 -- Doc'd that RelatedManager.add()/remove()/set() accepts the field the relation points to.
2019-05-07 08:55:45 +02:00
ef082ebb84
Fixed #29529 -- Allowed models.fields.FilePathField to accept a callable path.
2019-05-02 11:11:56 +02:00
5df3301aab
Fixed #30362 -- Noted partial indexes and constraints restrictions with abstract base classes.
...
Thanks Carlton Gibson for the review.
2019-04-25 07:36:07 +02:00
f8f0f92ed9
Fixed UniqueConstraint example in ref/models/constraints.txt.
2019-04-25 07:36:07 +02:00
0c916255eb
Changed tuple Mate.unique_together/permissions to lists in docs.
2019-04-24 10:06:00 +02:00
6fd9c9daa6
Fixed #30365 -- Fixed syntax highlighting in SQL examples.
...
Sphinx interprets some "%[a-z]" in SQL statements as a
"Literal.String.Interpol" which leads to incorrect highlighting.
2019-04-23 12:37:50 +02:00
03db5fddfd
Fixed typos in docs, comments, and exception messages.
2019-04-18 09:33:53 +02:00
516d858e7a
Fixed typo in docs/ref/models/instances.txt.
2019-04-16 08:26:11 +02:00
bfae195b0a
Fixed #30326 -- Doc'd how to avoid persistence of F() assignment.
2019-04-15 08:57:33 +02:00
198a2a9381
Removed unnecessary /static from links to PostgreSQL docs.
2019-03-29 21:49:44 -04:00
d26b242443
Fixed #30271 -- Added the Sign database function.
2019-03-22 12:52:39 +01:00
9dc367dc10
Refs #30158 -- Added alias argument to Expression.get_group_by_cols().
2019-03-21 18:47:46 -04:00
0b70985f42
Fixed #30240 -- Added SHA1, SHA224, SHA256, SHA384, and SHA512 database functions.
...
Thanks Mariusz Felisiak and Tim Graham for reviews.
2019-03-20 19:30:43 +01:00
1025e76429
Fixed #30253 -- Doc'd how to order nulls in QuerySet.order_by().
2019-03-18 10:32:38 -04:00
d527639804
Fixed #29754 -- Added is_dst parameter to Trunc database functions.
2019-03-07 10:02:18 -05:00
b0799f5d86
Fixed documentation of database representation for ManyToManyField.
2019-02-25 20:05:31 +01:00
9ff18c08c3
Refs #28643 -- Added MD5 database function.
...
Thanks Tim Graham, Nick Pope and Simon Charette for reviews.
2019-02-21 10:52:51 +01:00
759a9b710c
Updated Oracle docs links to Oracle 18c.
2019-02-07 09:59:47 +01:00
24b82cd201
Fixed #30159 -- Removed unneeded use of OrderedDict.
...
Dicts preserve order since Python 3.6.
2019-02-06 13:48:39 -05:00
39ebdf5a3c
Fixed #30155 -- Dropped support for PostgreSQL 9.4 and PostGIS 2.1.
2019-02-04 18:07:02 -05:00
ba7a420012
Corrected output of Prefetch.to_attr example.
2019-01-31 09:09:08 -05:00
51fa59f0b3
Fixed typo in QuerySet.bulk_update documentation ( #10859 )
...
Looks like an accidental carry over from the pre-existing
QuerySet.bulk_create documentation.
2019-01-17 12:31:48 -05:00
ec7e179aeb
Removed versionadded/changed annotations for 2.1.
2019-01-17 10:50:25 -05:00
769355c765
Fixed #9475 -- Allowed RelatedManager.add(), create(), etc. for m2m with a through model.
2019-01-15 11:12:17 -05:00
6d4efa8e6a
Refs #28643 -- Changed Variance() to use NumericOutputFieldMixin.
...
Keeps precision instead of forcing DecimalField to FloatField.
2019-01-14 14:39:46 -05:00
e85afa5943
Refs #28643 -- Changed StdDev() to use NumericOutputFieldMixin.
...
Keeps precision instead of forcing DecimalField to FloatField.
2019-01-14 14:38:00 -05:00
c690afb873
Refs #28643 -- Changed Avg() to use NumericOutputFieldMixin.
...
Keeps precision instead of forcing DecimalField to FloatField.
2019-01-14 14:35:41 -05:00
abf8e390a4
Refs #28643 -- Added Reverse database function.
...
Thanks Mariusz Felisiak for Oracle advice and review.
2019-01-12 10:45:48 -05:00
b69f8eb04c
Fixed #30062 -- Added support for unique conditional constraints.
2019-01-12 09:50:20 -05:00
cf1fe22009
Fixed typos in docs/ref/models/constraints.txt.
2019-01-10 18:52:42 -05:00
4b9d72210f
Refs #28643 -- Added NullIf database function.
...
Thanks Nick Pope, Mariusz Felisiak, and Tim Graham for reviews.
2019-01-10 12:10:12 -05:00
52d06d3041
Fixed #29968 -- Doc'd that QuerySet.bulk_update() doesn't check for duplicates.
2019-01-09 17:54:46 -05:00
bc05547cd8
Fixed #28658 -- Added DISTINCT handling to the Aggregate class.
2019-01-09 17:52:36 -05:00
bdf3863bdd
Fixed #30063 -- Doc'd that Meta.unique_together may be deprecated in favor of Meta.constraints.
2018-12-29 20:01:29 -05:00
83677faf86
Fixed #30056 -- Added SQLite support for StdDev and Variance functions.
2018-12-24 11:14:58 -05:00
e626a3f993
Renamed Sqlite and Sqlite3 references to SQLite.
2018-12-22 18:52:54 -05:00
926fa7116f
Fixed #29317 -- Doc'd filter argument in contrib.postgres aggregates.
2018-11-27 11:20:23 -05:00
9a7d336c38
Corrected Aggregate docs to reflect that it accepts multiple expressions.
2018-11-27 09:22:24 -05:00
9b15ff08ba
Used auto-numbered lists in documentation.
2018-11-15 13:54:28 -05:00
db13bca60a
Fixed #29641 -- Added support for unique constraints in Meta.constraints.
...
This constraint is similar to Meta.unique_together but also allows
specifying a name.
Co-authored-by: Ian Foote <python@ian.feete.org>
2018-11-13 17:57:27 -05:00
8eae094638
Generalized check constraint docs for other constraints.
2018-11-13 17:57:27 -05:00
d48662122c
Corrected docs regarding RegisterLookupMixin subclasses.
2018-11-12 10:20:35 -05:00
a906c98982
Fixed #29547 -- Added support for partial indexes.
...
Thanks to Ian Foote, Mariusz Felisiak, Simon Charettes, and
Markus Holtermann for comments and feedback.
2018-10-29 19:34:54 -04:00
1b49b792e9
Emphasized that ForeignKey.on_delete doesn't create a SQL constraint.
2018-10-10 14:56:50 -04:00
d093e01ec0
Clarified when QuerySet.select_for_update() locks.
2018-10-03 15:29:33 -04:00
9142bebff2
Refs #11964 -- Changed CheckConstraint() signature to use keyword-only arguments.
...
Also renamed the `constraint` argument to `check` to better represent which
part of the constraint the provided `Q` object represents.
2018-10-02 10:53:04 -04:00
b3b47bf515
Added tests for using bytearray with BinaryField and corrected docs.
2018-10-01 09:16:16 -04:00
fb2964a410
Added test of filtering on BinaryField and corrected docs.
2018-09-26 14:38:12 -04:00
8c3e0eb1c1
Normalized spelling of "lowercase" and "lowercased".
2018-09-25 10:30:18 -04:00
9cbdb44014
Fixed #23646 -- Added QuerySet.bulk_update() to efficiently update many models.
2018-09-18 16:14:44 -04:00
1b1f64ee5a
Refs #14357 -- Deprecated Meta.ordering affecting GROUP BY queries.
...
Thanks Ramiro Morales for contributing to the patch.
2018-09-13 12:29:48 -04:00
c49ea6f591
Refs #20910 -- Replaced snippet directive with code-block.
2018-09-10 13:00:34 -04:00
c122a7c53c
Fixed typo in docs/ref/models/fields.txt.
2018-08-28 07:53:09 -04:00
83b04d4f88
Fixed #29048 -- Added **extra_context to database function as_vendor() methods.
2018-08-23 11:52:09 -04:00
3e09b37f80
Fixed #28649 -- Added ExtractIsoYear database function and iso_year lookup.
2018-08-18 13:09:15 -04:00
3fa3de5415
Fixed #29646 -- Doc'd the validators that each model and form field uses.
2018-08-16 17:03:28 -04:00
f1fbef6cd1
Fixed #28668 -- Allowed QuerySet.bulk_create() to ignore insert conflicts.
2018-08-03 17:40:46 -04:00
2e3ba9f592
Removed out of place sentence in QuerySet.count() docs.
2018-08-02 17:36:02 -04:00
97e637a87f
Fixed typos in comments and docs.
2018-08-01 16:09:22 -04:00
4198445afc
Refs #29548 -- Fixed failing window tests on MariaDB 10.3.
2018-07-30 19:54:56 -04:00
a67ebcb1cb
Refs #29593 , #26891 -- Doc'd RegisterLookupMixin.get_lookups().
2018-07-26 10:42:33 -04:00
c0e3c65b9d
Fixed #29563 -- Added result streaming for QuerySet.iterator() on SQLite.
2018-07-25 18:08:57 -04:00
6e78e10549
Added doc links for django.utils.html.escape().
2018-07-18 11:32:27 -04:00
952f05a6db
Fixed #11964 -- Added support for database check constraints.
2018-07-10 15:32:33 -04:00
8b1d361f28
Fixed #29549 -- Doc'd that Field.choices are enforced by model validation.
2018-07-09 15:06:36 -04:00
ab251fdad2
Refs #26608 -- Removed incorrect sentence in Expression.contains_over_clause docs.
2018-07-05 11:12:08 -04:00
a0b19a0f5b
Refs #28643 -- Added math database functions.
...
Thanks Nick Pope for much review.
2018-07-05 11:02:12 -04:00
c530428d36
Fixed #21333 -- Doc'd the & and | queryset operators.
2018-06-29 20:39:18 -04:00
38cada7c94
Fixed #28077 -- Added support for PostgreSQL opclasses in Index.
...
Thanks Vinay Karanam for the initial patch.
2018-06-29 17:00:28 -04:00
2d6776ffe0
Fixed #29458 -- Doc'd how related_query_name affects Model._meta.get_field().
2018-06-28 19:35:01 -04:00
dd367e0dae
Refs #12663 -- Removed Meta API upgrade guide.
2018-06-27 14:02:46 -04:00
11bfe3a83d
Refs #29493 -- Doc'd that the QuerySet in lookup accepts a string.
2018-06-16 15:53:54 -04:00
7417929618
Fixed #29440 -- Doc'd where the bulk argument applies in RelatedManager.
2018-06-08 14:36:17 -04:00
4c35a173e8
Fixed #29423 -- Documented Field.value_from_object().
2018-05-25 15:10:45 -04:00
e038f98bf3
Fixed #29398 -- Doc'd that cascade deletion doesn't call delete() of related models.
2018-05-18 18:08:37 -04:00
7543ab1f8d
Removed versionadded/changed annotations for 2.0.
2018-05-17 11:00:10 -04:00
825f0beda8
Fixed #8936 -- Added a view permission and a read-only admin.
...
Co-authored-by: Petr Dlouhy <petr.dlouhy@email.cz>
Co-authored-by: Olivier Dalang <olivier.dalang@gmail.com>
2018-05-16 06:44:55 -04:00
35319bf12c
Alphabetized imports in various docs.
...
Follow-up of d97cce34097d3fe36c62
2018-05-12 19:37:42 +02:00
5d923f2d8c
Fixed #29313 -- Doc'd how to use F() to sort null values.
2018-04-19 20:07:40 -04:00
c1c163b427
Fixed #28574 -- Added QuerySet.explain().
2018-04-19 10:52:19 -04:00
e6c21217d3
Fixed reference to nonexistent __between lookup.
2018-04-04 09:43:36 -04:00
55cc26941a
Refs #28643 -- Added Repeat database function.
...
Thanks Tim Graham and Nick Pope for reviews.
2018-04-03 19:36:12 +02:00
34c5222837
Fixed #29148 -- Doc'd how to use get_or_create() with Q objects.
2018-03-28 10:46:34 -04:00
0c100f8b57
Clarified docs about ISO 8601 week numbering.
2018-03-21 20:00:39 -04:00
abe6c5defe
Fixed #28514 -- Clarifed docs about idempotence of RelatedManager.add().
2018-03-20 21:09:08 -04:00
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
cede5111bb
Refs #28643 -- Added LPad and RPad database functions.
...
Thanks Tim Graham for the review.
2018-03-19 17:35:16 +01:00
9421aee35e
Refs #28643 -- Added LTrim, RTrim, and Trim database functions.
...
Thanks Tim Graham and Mads Jensen for reviews.
2018-03-15 20:57:23 +01:00
10c0fe528a
Fixed #29178 -- Allowed Index.fields to accept a tuple.
2018-03-08 10:56:55 -05:00
f82de6bfb1
Refs #28643 -- Added Ord, Chr, Left, and Right database functions.
2018-02-23 10:23:22 -05:00
548f78ba46
Removed redundant lookup name in register_lookup() calls.
2018-02-19 13:12:13 -05:00
e917ea6bec
Fixed #29126 -- Doc'd the behavior of QuerySet.update_or_create() with manually specified pks.
2018-02-15 13:17:37 -05:00
2162f0983d
Fixed #24747 -- Allowed transforms in QuerySet.order_by() and distinct(*fields).
2018-02-10 19:08:55 -05:00
01bfa9219b
Fixed typo in bulk_create() documentation.
2018-02-08 10:33:45 +01:00
617d5f410f
Fixed #29066 -- Allowed negating query expressions.
2018-01-31 10:54:19 -05:00
136bf5c214
Fixed #29076 -- Made Model.refresh_from_db() clear cached relationships even if the related id doesn't change.
2018-01-30 10:43:53 -05:00
e6f0e324e2
Fixed #29081 -- Clarified comments in QuerySet.select_related() example.
2018-01-29 11:11:43 -05:00
a455e732a0
Fixed #28650 -- Added TruncWeek database function.
2018-01-27 09:59:13 -05:00
2870879981
Fixed heading level typo in docs/ref/models/database-functions.txt.
2018-01-23 19:48:57 -05:00
7fbb1bd00d
Fixed #29032 -- Fixed an example of using expressions in QuerySet.values().
2018-01-19 08:55:29 +01:00
65728550bd
Refs #28643 -- Added Replace database function.
2018-01-17 20:46:15 -05:00
52aa26e697
Fixed #28231 -- Doc'd that QuerySet.bulk_create() casts objs to a list.
2018-01-12 19:56:16 -05:00
622ead6aaf
Fixed #28937 -- Allowed BinaryField to be editable=True.
2017-12-22 16:31:46 -05:00
9d1d0e2b70
Fixed import in docs/ref/models/conditional-expressions.txt example.
2017-12-07 08:57:38 -05:00
3cc08f4b2b
Fixed typo in docs/ref/models/expressions.txt.
2017-12-05 08:39:57 -05:00
bf49d9eb0b
Fixed #28815 -- Fixed ExtractYear imports in docs/ref/models/expressions.txt.
2017-11-17 17:30:21 -05:00
2d3cc94284
Fixed #28781 -- Added QuerySet.values()/values_list() support for union(), difference(), and intersection().
...
Thanks Tim Graham for the review.
2017-11-12 14:28:11 +01:00
327f0f37ce
Fixed #28770 -- Warned that quoting a placeholder in a raw SQL string is unsafe.
...
Thanks Hynek Cernoch for the report and review.
2017-11-07 13:07:12 -05:00
5587485d49
Fixed #28765 -- Clarified docs about what types the __in lookup accepts.
2017-11-06 13:12:14 -05:00
1e7dbbdec5
Fixed #28680 -- Doc'd Func.__init__()'s **extra and as_sql()'s **extra_context aren't escaped.
...
Thanks Hynek Cernoch for the report and review.
2017-11-01 11:34:06 -04:00
03049fb8d9
Refs #28010 -- Allowed reverse related fields in SELECT FOR UPDATE .. OF.
...
Thanks Adam Chidlow for polishing the patch.
2017-10-28 20:33:42 -04:00
ec5f7cb92e
Fixed typo in docs/ref/models/querysets.txt.
2017-10-25 19:03:21 -04:00
95a14cfc47
Fixed #28395 -- Doc'd that QuerySet.first() can affect aggregation queries.
2017-10-25 18:46:25 -04:00
3bd69b1261
Fixed typo in docs/ref/models/querysets.txt.
2017-10-17 10:07:20 -04:00
ad8036d715
Refs #28643 -- Reorganized database functions docs.
...
Thanks Tim Graham for the review.
2017-10-13 18:20:11 +02:00
27193aea00
Fixed #28584 -- Dropped support for SQLite < 3.7.15.
2017-10-03 10:42:18 -04:00
08c8c3ead9
Fixed #28653 -- Added missing ForeignKey.on_delete argument in docs.
2017-09-29 11:38:28 -04:00
4a908c0cd2
Clarified StrIndex docs example.
2017-09-27 09:08:50 -04:00
Mariusz Felisiak
Claude Paroz
Nick Pope
Tobias Kunze
Shai Berger
Matthew Schinckel
Andrew
Carlton Gibson
Étienne Beaulé
Jon Dufresne
can
Alexey Opalev
Nadège Michel
Swat009
Vyacheslav Ver
Caio Ariede
Brad Solomon
GwynBleidD
Alex
Mykola Kokalko
Luke Plant
Daniel Musketa
Ville Skyttä
Gary Donovan
sage
Simon Charette
Paul Wayper
ahbk
Tim Graham
Sergey Fedoseev
Day Barr
Collin Anderson
Paveł Tyślacki
Mads Jensen
Hasan Ramezani
Simon Charette
François Freitag
Andrea Rabbaglietti
ovalseven8
Tom Forbes
Ramiro Morales
Curtis Maloney
Matt Wiens
priyanshsaxena
Sigurd Ljødal
Jeff
Adam Johnson
luz.paz
Andrew Brown
Ian Foote
Junyi Jiao
Colm O'Connor
Jeffrey Yancey
Christian Ledermann
Jeremy Lainé
Srinivas Reddy Thatiparthy
olivierdalang
drd0013
Daniel Roseman
Quentin Agren
Alasdair Nicol
Jezeniel Zapanta
Fabrizio Ettore Messina
bobort
Matthew Wilkes
Botond Béres
Cameron Curry
Mohammad Esmaeilbeygi
Igor Starikov
Benjamin Bach
Ran Benita
Jozef
Stefan Schneider
Miguel