Method get

mongoengine/queryset/base.py:262–288

Retrieve the matching object raising :class:`~mongoengine.queryset.MultipleObjectsReturned` or `DocumentName.MultipleObjectsReturned` exception if multiple results and :class:`~mongoengine.queryset.DoesNotExist` or `DocumentName.DoesNotExist` if no results are found.

(self, *q_objs, **query)

        return queryset

    def get(self, *q_objs, **query):
        """Retrieve the matching object raising
        :class:`~mongoengine.queryset.MultipleObjectsReturned` or
        `DocumentName.MultipleObjectsReturned` exception if multiple results
        and :class:`~mongoengine.queryset.DoesNotExist` or
        `DocumentName.DoesNotExist` if no results are found.
        """
        queryset = self.clone()
        queryset = queryset.order_by().limit(2)
        queryset = queryset.filter(*q_objs, **query)

        try:
            result = next(queryset)
        except StopIteration:
            msg = "%s matching query does not exist." % queryset._document._class_name
            raise queryset._document.DoesNotExist(msg)

        try:
            # Check if there is another match
            next(queryset)
        except StopIteration:
            return result

        # If we were able to retrieve the 2nd doc, raise the MultipleObjectsReturned exception.
        raise queryset._document.MultipleObjectsReturned(
            "2 or more items returned, instead of 1"
        )

    def create(self, **kwargs):
        """Create new object. Returns the saved object instance."""