chango.git/docs/topics/testing, branch devmain

Fixed password hashing anchor link for references.

2026-06-15T19:30:40Z

Fixed #37128 -- Doc'd setUpTestData as test speed up.

2026-06-15T19:30:40Z

Revises the AnimalTestCase to better show test data isolation and avoid the opportunity to use setUpTestData.

Fixed #36837 -- Skipped backends not implementing (a)get_user() in (a)force_login().

2026-06-11T14:10:47Z

Co-authored-by: Mykhailo Havelia

Refs #35514 -- Cleaned up mailers docs.

2026-05-20T13:59:46Z

* Fixed typos related to automated EMAIL_PROVIDERS -> MAILERS renaming. * Clarified wording in some recently added/updated sections. * Removed deprecated, extraneous `fail_silently=False` from examples. * Moved EmailBackend API documentation out of "Email backends" intro into a dedicated section in email.txt. * Sorted MAILERS alphabetically in settings.txt.

Fixed #35514 -- Implemented dictionary-based MAILERS.

2026-05-13T21:00:56Z

See DEP 0018. Added: * MAILERS setting. * django.core.mail.mailers dict-like EmailBackend factory. * `using` argument to mail sending APIs. * `sent_using` attribute to mail.outbox messages in locmem backend. * MAILERS in startproject settings template, set to console backend. * AdminLogHandler.using argument. * BrokenLinkEmailsMiddleware.send_mail() method. Updated: * BaseEmailBackend to track the MAILERS alias used to construct it, and to report errors for unknown kwargs (OPTIONS). * EmailBackend implementations to initialize from kwargs (OPTIONS) only when MAILERS is being used. * smtp.EmailBackend to require `host` option and to default `port` option based on SSL/TLS options. * SimpleTestCase setup to substitute the locmem backend for all defined MAILERS configurations. * Django's tests that send mail to define MAILERS. Deprecated: * EMAIL_BACKEND and other backend-related EMAIL_* settings. * mail.get_connection(). * The `connection`, `fail_silently`, `auth_user`, and `auth_password` arguments to mail functions. * The EmailMessage.connection attribute. * BaseEmailBackend support for `fail_silently`. Backends that support fail_silently (SMTP, console, file) now implement it directly. * AdminEmailHandler.email_backend argument. Removed undocumented features without deprecation: * EmailMessage.get_connection() method. (send() now raises an error if a subclass has attempted to override it.) * EmailMessage.send() no longer sets self.connection to the connection used for sending. (It still _uses_ a pre-existing self.connection.) * AdminEmailHandler.connection() method. (Init now raises an error if a subclass has attempted to override it.) Thanks to Natalia Bidart for shepherding DEP 0018 and for extensive reviews and suggestions on the implementation. Thanks to Jacob Rief for the initial implementation and multiple iterations while refining the design. Co-authored-by: Jacob Rief

Replaced references in docs to accepted PEPs with specific Python docs links.

2026-04-24T15:22:34Z

Where the docs used `:pep:` links for established Python language features, replaced them with direct references to the Python docs (usually glossary terms).

Fixed #36329 -- Removed non-code custom link text when cross-referencing Python objects.

2025-10-29T15:32:12Z

Thanks Bruno Alla, Sarah Boyce, and Jacob Walls for reviews. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>

Removed versionadded/changed annotations for 5.2.

2025-09-17T18:17:05Z

Ensured :doc: role uses absolute targets in docs.

2025-08-28T16:48:32Z

Fixed #36570 -- Removed unnecessary :py domain from documentation roles.

2025-08-28T06:52:43Z

Signed-off-by: SaJH