summaryrefslogtreecommitdiff
path: root/docs/topics/http
AgeCommit message (Collapse)Author
10 daysFixed #36022 -- Renamed django-admin to django.Ryan Hiebert
This change implements DEP 16: to rename the django-admin command to django. django-admin is kept as an alias. Docs references to the "django-admin" command are updated to "django" or “The django command”. Renamed the `django-admin` Sphinx directive to `cmd`, and the `django-admin-option` directive to `cli-option`. Thanks Johannes Maron, Mike Edmunds, and Jacob Walls for reviews.
2026-10-26Fixed #37232 -- Added support for the HTTP QUERY method.Michiel W. Beijen
QUERY (RFC 10008) is a safe, idempotent method that carries the query in the request content rather than in the URI's query component. Treat it as safe throughout: exempt it from CSRF protection, evaluate request preconditions as for GET, accept it in require_safe(), and dispatch it from View. Query content is available as HttpRequest.body and is not parsed into HttpRequest.POST. Caching is left for a follow-up. Per RFC 10008 Section 2.7 the cache key for a QUERY request must incorporate the request content, which the cache middleware and cache_page() don't do, so they continue to ignore QUERY. Thanks Ben Atkinson, Jonathan Biemond, and Jacob Walls for reviews.
2026-10-14Fixed #37409 -- Removed ambiguous "Overview" link text from the docs home page.Natalia
The docs home page used "Overview" as the link text 15 times, the only duplicated link text on that page. A reader navigating by a list of links got identical entries with no indication of which section each belonged to. A sixteenth "Overview" comes from the main site's navbar and is outside this repository. Every one of those targets already has a distinct title of its own, which `docs/index.txt` was overriding with the generic word. Most of them now use it, via `:doc:` without an explicit title. Three would have repeated their group label, and are given a short unique title instead. Also retitled five of those documents so that the home page can use their own titles: two to sentence case, matching the rest, and three to drop a redundant "in Django" suffix.
2026-09-24Fixed #37177 -- Reduced per-middleware context switching under ASGI.Jacob Walls
Relying on MiddlewareMixin.__acall__() to handle async requests imposed per-middleware context switching, defeating BaseHandler's intent to transition only once per middleware chain. To minimize breaking changes, MiddlewareMixin's default value did not change: only the values on Django's own subclasses. Use cases where the prior behavior is preferable (in order to avoid pinning a thread per request) are fleshed out in docs. Thanks Mykhailo Havelia for the report.
2026-07-14Fixed #37210 -- Logged cached_db session cache delete failures.vismaytiwari
2026-07-13Fixed #37178 -- Moved MiddlewareMixin out of utils.deprecation.CharulL00
2026-07-06Fixed #37172 -- Linked to upload handlers section in FILE_UPLOAD_* settings ↵Lincoln Puzey
see for details.
2026-05-25Corrected indentation in topics/http/shortcuts.txt.Mariusz Felisiak
2026-05-04Fixed #36767 -- Allowed max redirect URL length to be set on ↵varunkasyap
HttpResponseRedirect.
2026-02-21Fixed #36899 -- Implemented SessionBase.__bool__.Amar
2026-02-03Fixed #36898 -- Documented SessionBase.is_empty().jafarkhan83
2026-01-31Refs #34118 -- Removed asgiref coroutine detection shims.Jacob Walls
As Python 3.12 is now the floor, we can drop the shims and use the `inspect` module.
2026-01-19Fixed unbalanced parentheses in docs.Clifford Gama
2025-12-26Fixed #30515 -- Documented resolve_url() in docs/topics/http/shortcuts.txt.Duane Hilton
2025-10-29Fixed #36329 -- Removed non-code custom link text when cross-referencing ↵Clifford Gama
Python objects. Thanks Bruno Alla, Sarah Boyce, and Jacob Walls for reviews. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2025-09-29Fixed #36587 -- Clarified usage of `list.insert()` for upload handlers.okaybro
Thanks Baptiste Mispelon for the report Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2025-09-17Removed versionadded/changed annotations for 5.2.Jacob Walls
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
Lines in the docs files were manually adjusted to conform to the 79 columns limit per line (plus newline), improving readability and consistency across the content.
2025-08-25Refs #36485 -- Removed double spaces after periods in sentences.Natalia
2025-08-25Refs #36485 -- Removed unnecessary parentheses in :meth: and :func: roles in ↵David Smith
docs.
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-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.
2024-11-14Fixed #35784 -- Added support for preserving the HTTP request method in ↵Lorenzo Peña
HttpResponseRedirectBase. Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2024-10-30Added missing lang attributes to html elements in docs.Johanan-Ayadata
2024-06-12Fixed #35401 -- Documented the conditional_page() decorator.lufafajoshua
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-04-04Refs #31710 -- Improved multiple file upload docs.Adam Johnson
2024-03-13Fixed #34901 -- Added async-compatible interface to session engines.Jon Janzen
Thanks Andrew-Chen-Wang for the initial implementation which was posted to the Django forum thread about asyncifying contrib modules.
2024-02-23Fixed #35090 -- Deprecated registering URL converters with the same name.Salvo Polizzi
2024-02-21Fixed #34806 -- Made cached_db session backend resilient to cache write errors.Sulabh Katila
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2024-01-26Applied Black's 2024 stable style.Mariusz Felisiak
https://github.com/psf/black/releases/tag/24.1.0
2023-09-18Removed versionadded/changed annotations for 4.2.Mariusz Felisiak
This also removes remaining versionadded/changed annotations for older versions.
2023-09-13Refs #31949 -- Made make_middleware_decorator to work with async functions.Ben Lomax
2023-07-24Fixed #34714 -- Added aget_object_or_404()/aget_list_or_404() shortcuts.Olivier Tabone
2023-07-10Refs #31949 -- Made @vary_on_(cookie/headers) decorators work with async ↵Ben Lomax
functions.
2023-06-26Refs #31949 -- Made http decorators to work with async functions.th3nn3ss
2023-05-23Refs #31949 -- Made @no_append_slash decorator to work with async functions.Ben Lomax
2023-05-03Fixed CVE-2023-31047, Fixed #31710 -- Prevented potential bypass of ↵Mariusz Felisiak
validation when uploading multiple files using one form field. Thanks Moataz Al-Sharida and nawaik for reports. Co-authored-by: Shai Berger <shai@platonix.com> Co-authored-by: nessita <124304+nessita@users.noreply.github.com>
2023-04-25Refs #31949 -- Made @never_cache and @cache_control() decorators to work ↵Ben Lomax
with async functions. Thanks Carlton Gibson and Mariusz Felisiak for reviews.
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-28Refs #34140 -- Corrected rst code-block and various formatting issues in docs.Joseph Victor Zammit
2023-02-14Fixed #34328 -- Added async-only class-based middleware example.Carlton Gibson
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2023-01-17Refs #29708 -- Removed PickleSerializer per deprecation timeline.Mariusz Felisiak
2022-12-22Fixed #33735 -- Added async support to StreamingHttpResponse.Carlton Gibson
Thanks to Florian Vazelle for initial exploratory work, and to Nick Pope and Mariusz Felisiak for review.
2022-12-20Refs #34118 -- Adopted asgiref coroutine detection shims.Carlton Gibson
Thanks to Mariusz Felisiak for review.
2022-12-16Fixed typo in docs/topics/http/sessions.txt.TAKAHASHI Shuuji
2022-10-29Removed obsolete doc reference to asyncio.iscoroutinefunction.Nick Pope
2022-10-10Fixed #25996 -- Revised performance section in URLs topic docs.Ralph Reid