summaryrefslogtreecommitdiff
path: root/docs/topics
AgeCommit message (Collapse)Author
2025-08-04Corrected assertNumQueries() example in docs/topics/testing/tools.txt.Adam Zapletal
2025-07-25Fixed #35581 -- Updated django.core.mail to Python's modern email API.Mike Edmunds
- Changed EmailMessage.message() to construct a "modern email API" email.message.EmailMessage and added policy keyword arg. - Added support for modern MIMEPart objects in EmailMessage.attach() (and EmailMessage constructor, EmailMessage.attachments list). - Updated SMTP EmailBackend to use modern email.policy.SMTP. Deprecated: - Attaching MIMEBase objects (replace with MIMEPart) - BadHeaderError (modern email uses ValueError) - SafeMIMEText, SafeMIMEMultipart (unnecessary for modern email) - django.core.mail.forbid_multi_line_headers() (undocumented, but exposed via `__all__` and in wide use) - django.core.mail.message.sanitize_address() (undocumented, but in wide use) Removed without deprecation (all undocumented): - EmailMessage.mixed_subtype - EmailMultiAlternatives.alternative_subtype - Support for setting (undocumented) EmailMessage.encoding property to a legacy email.charset.Charset object Related changes: - Dropped tests for incorrect RFC 2047 encoding of non-ASCII email address localparts. This is specifically prohibited by RFC 2047, and not supported by any known MTA or email client. (Python still mis-applies encoded-word to non-ASCII localparts, but it is a bug that may be fixed in the future.) - Added tests that try to discourage using Python's legacy email APIs in future updates to django.core.mail.
2025-07-25Fixed typo in docs/topics/email.txt.Mike Edmunds
2025-07-17Refs #36163 -- Reordered EmailMessage options in docs/topics/email.txt.Mike Edmunds
Reordered the keyword-only EmailMessage parameters in the documentation to group similar options together and move rarely used options later. Used keywords for *all* parameters in EmailMessage examples to improve clarity.
2025-07-17Fixed #36163 -- Deprecated most positional arguments in django.core.mail.Mike Edmunds
In public mail APIs, changed less frequently used parameters from keyword-or-positional to keyword-only, emitting a warning during the required deprecation period.
2025-07-17Fixed get_connection() signature in docs/topics/email.txt.Mike Edmunds
django.core.mail.get_connection() has always supported only variable keyword arguments (never variable positional arguments).
2025-06-27Fixed #15727 -- Added Content Security Policy (CSP) support.Rob Hudson
This initial work adds a pair of settings to configure specific CSP directives for enforcing or reporting policy violations, a new `django.middleware.csp.ContentSecurityPolicyMiddleware` to apply the appropriate headers to responses, and a context processor to support CSP nonces in templates for safely inlining assets. Relevant documentation has been added for the 6.0 release notes, security overview, a new how-to page, and a dedicated reference section. Thanks to the multiple reviewers for their precise and valuable feedback. Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2025-06-13Corrected jsonfield fieldlookup references.Sarah Boyce
2025-06-11Made minor grammar and punctuation fixes in docs/topics/migrations.txt.Clifford Gama
2025-06-10Refs #373 -- Doc'd that on_delete is ignored for ForeignObject.Jacob Walls
2025-06-10Fixed #36449 -- Fixed field types in example model using ForeignObject.Jacob Walls
2025-05-20Fixed #34262 -- Added support for AnyValue for SQLite, MySQL, Oracle, and ↵ontowhee
Postgresql 16+. Thanks Simon Charette for the guidance and review. Thanks Tim Schilling for the documentation review. Thanks David Wobrock for investigation and solution proposals.
2025-05-16Fixed #33312 -- Raised explicit exception when copying deferred model instances.Simon Charette
Previously save() would crash with an attempted forced update message, and both save(force_insert=True) and bulk_create() would crash with DoesNotExist errors trying to retrieve rows with an empty primary key (id IS NULL). Implementing deferred field model instance copying might be doable in certain cases (e.g. when all the deferred fields are db generated) but that's not trivial to implement in a backward compatible way. Thanks Adam Sołtysik for the report and test and Clifford for the review.
2025-05-14Fixed #36085 -- Added JSONField support for negative array indexing on SQLite.savanto
2025-05-02Fixed #17461 -- Doc'd the presumed order of foreign keys on the intermediary ↵Clifford Gama
model of a self-referential m2m. Thanks Giannis Terzopoulos and Sarah Boyce for the reviews.
2025-04-27Fixed #36335 -- Fixed typo in docs/topics/db/managers.txt.dbogar89
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-04-15Fixed #36269 -- Documented how to test callable storage in FileField.Ahmed Nassar
2025-04-15Fixed #35993 -- Documented gettext f-string support limitations.Ahmed Nassar
Thank you to Claude Paroz and Athena Wolfskämpf for the review.
2025-03-31Fixed #36265 -- Added support for serialization of ZoneInfo instances in ↵Song Junho
migrations.
2025-03-23Fixed typo in docs/topics/signals.txt.mguegnol
2025-03-21Fixed #36095 -- Introduced lazy references in "Models across files" section.Clifford Gama
2025-03-18Fixed #33497 -- Doc'd that persistent DB connections should be disabled in ↵Carlton Gibson
ASGI and async modes.
2025-03-18Fixed #36202 -- Added examples of JSONField __contains and __contained_by ↵Clifford Gama
lookups with nested arrays to docs.
2025-03-17Fixed #36254 -- Fixed template dictionary unpacking in ↵YQ
docs/topics/i18n/timezones.txt.
2025-03-13Fixed incorrect formatting for inline pluralized code references in docs.Clifford Gama
2025-03-12Fixed #36249 -- Fixed typo in docs/topics/db/queries.txt.hesham hatem
2025-03-12Fixed #35676 -- Made BaseModelForm validate constraints that reference an ↵Clifford Gama
InlineForeignKeyField. Co-authored-by: Simon Charette <charette.s@gmail.com>
2025-03-04Fixed #36128 -- Clarified auto-generated unique constraint on m2m through ↵Clifford Gama
models.
2025-03-02Added some heading labels to to docs/topics/cache.txt.Tim Graham
2025-02-24Added security reporting guidelines.Sarah Boyce
2025-02-19Fixed #35358, Refs #35234 -- Renamed _check() methods to check() for ↵Mariusz Felisiak
constraints.
2025-02-18Refs #36005 -- Used datetime.UTC alias instead of datetime.timezone.utc.Mariusz Felisiak
datetime.UTC was added in Python 3.11.
2025-02-16Refs #35967 -- Deprecated BaseDatabaseCreation.create_test_db(serialize).Simon Charette
Given there are no longer any internal usages of serialize=True and it poses a risk to non-test databases integrity it seems appropriate to deprecate it.
2025-02-16Refs #35967 -- Doc'd DatabaseCreation.serialize_db_to_string() method.Simon Charette
2025-01-28Refs #36005 -- Bumped minimum supported versions of 3rd-party packages.Mariusz Felisiak
This bumps minimum supported versions of 3rd-party packages to the first releases to support Python 3.12.
2025-01-22Fixed #24529 -- Allowed double squashing of migrations.Georgi Yanchev
Co-authored-by: Raphael Gaschignard <raphael@rtpg.co>
2025-01-20Fixed #36005 -- Dropped support for Python 3.10 and 3.11.Mariusz Felisiak
2025-01-15Refs #35090 -- Removed support for django.urls.register_converter() ↵Sarah Boyce
overriding existing converters 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-15Fixed #36070 -- Clarified model validation behavior for composite pks.Jacob Walls
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-14Fixed #36075 -- Documented how to introspect composite primary keys.Simon Charette
Document _meta.pk_fields and interactions between Field.primary_key and CompositePrimaryKey. Thanks Mariusz for the review.
2025-01-07Refs #36042 -- Raised ValueError when providing composite expressions to ↵Jacob Walls
aggregates.
2025-01-02Fixed #36037 -- Fixed default primary key type in docs.Ari Pollak
BigAutoField is the default type for primary keys. In models.txt, the linked anchor shows that the default primary key is a BigAutoField, so it now defers to that section instead of duplicating an (incorrect) type.
2025-01-02Fixed #35886 -- Added support for object-based form media script assets.Johannes Maron
2024-12-16Fixed #36008 -- Fixed order of database reset in TransactionTestCase docs.Chiemezuo
2024-12-11Removed links to outdated tools in docs/topics/performance.txt.amansharma612
Co-authored-by: Aman Sharma <210100011@iitb.ac.in>
2024-12-02Removed question marks from headings in docs/topics/db/fixtures.txt.Anders Hovmöller
2024-12-02Fixed #35964 -- Cleaned up can_order and can_delete formset examples.antoliny0919