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
Mariusz Felisiak
Tobias Kunze
Shai Berger
Matthew Schinckel
Andrew
Claude Paroz
Carlton Gibson
Nick Pope
É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é