mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-03 18:38:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Fixed #34714 -- Added aget_object_or_404()/aget_list_or_404() shortcuts.

Browse source
This commit is contained in:
Olivier Tabone 2023-07-20 17:50:06 +02:00 • committed by Mariusz Felisiak
parent f05cc5e3d2
commit b9473cac65
4 changed files with 116 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/topics/http/shortcuts.txt
View file

@ -162,10 +162,13 @@ will be returned::
=======================
.. function:: get_object_or_404(klass, *args, **kwargs)
.. function:: aget_object_or_404(klass, *args, **kwargs)
Calls :meth:`~django.db.models.query.QuerySet.get()` on a given model manager,
but it raises :class:`~django.http.Http404` instead of the model's
:class:`~django.db.models.Model.DoesNotExist` exception.
*Asynchronous version*: ``aget_object_or_404()``
Calls :meth:`~django.db.models.query.QuerySet.get()` on a given model
manager, but it raises :class:`~django.http.Http404` instead of the model's
:class:`~django.db.models.Model.DoesNotExist` exception.
Arguments
---------
@ -236,14 +239,21 @@ Note: As with ``get()``, a
:class:`~django.core.exceptions.MultipleObjectsReturned` exception
will be raised if more than one object is found.
.. versionchanged:: 5.0
``aget_object_or_404()`` function was added.
``get_list_or_404()``
=====================
.. function:: get_list_or_404(klass, *args, **kwargs)
.. function:: aget_list_or_404(klass, *args, **kwargs)
Returns the result of :meth:`~django.db.models.query.QuerySet.filter()` on a
given model manager cast to a list, raising :class:`~django.http.Http404` if
the resulting list is empty.
*Asynchronous version*: ``aget_list_or_404()``
Returns the result of :meth:`~django.db.models.query.QuerySet.filter()` on
a given model manager cast to a list, raising :class:`~django.http.Http404`
if the resulting list is empty.
Arguments
---------
@ -280,3 +290,7 @@ This example is equivalent to::
my_objects = list(MyModel.objects.filter(published=True))
if not my_objects:
raise Http404("No MyModel matches the given query.")
.. versionchanged:: 5.0
``aget_list_or_404()`` function was added.