meringue.core.query

SortingQuerySet

Bases: QuerySet

QuerySet with methods for working with sorted positions

correction_sorting

correction_sorting()

This is a method to update/fix the sorting of the selected list of items.

The sorting will be done according to the queryset sorting, so sorting can be controlled by executing .order_by() before calling the correction_sorting method.

The selection for updating sorting can be pre-limited by filtering the list.

Source code in meringue/core/query.py

def correction_sorting(self):
    """
    This is a method to update/fix the sorting of the selected list of items.

    The sorting will be done according to the `queryset` sorting, so sorting can be controlled
    by executing `.order_by()` before calling the `correction_sorting` method.

    The selection for updating sorting can be pre-limited by filtering the list.
    """
    items = []
    sorting = 0
    for item in self:
        if item.sorting != sorting:
            item.sorting = sorting
            items.append(item)
        sorting += 1

    return self.bulk_update(items, ["sorting"])

PublicationQuerySet

Bases: QuerySet

QuerySet with methods for fetching published and unpublished elements.

published

published(*args, **kwargs)

Method to getting published items.

Source code in meringue/core/query.py

def published(self, *args, **kwargs):
    """
    Method to getting published items.
    """
    from meringue.core.models import PublicationDatesMixin
    from meringue.core.models import PublicationMixin

    if issubclass(self.model, PublicationMixin):
        kwargs["is_published"] = True

    if issubclass(self.model, PublicationDatesMixin):
        now = timezone.now()
        args = (
            *args,
            Q(date_from__lte=now, date_to__gt=now)
            | Q(date_from__isnull=True, date_to__gt=now)
            | Q(date_from__lte=now, date_to__isnull=True)
            | Q(date_from__isnull=True, date_to__isnull=True),
        )

    return self.filter(*args, **kwargs)

unpublished

unpublished(*args, **kwargs)

Method for getting unpublished items.

Source code in meringue/core/query.py

def unpublished(self, *args, **kwargs):
    """
    Method for getting unpublished items.
    """
    from meringue.core.models import PublicationDatesMixin
    from meringue.core.models import PublicationMixin

    if issubclass(self.model, PublicationMixin):
        kwargs["is_published"] = False

    if issubclass(self.model, PublicationDatesMixin):
        now = timezone.now()
        args = (*args, Q(date_from__gt=now) | Q(date_to__lte=now))

    return self.filter(*args, **kwargs)

UniversalQuerySet

Bases: SortingQuerySet, PublicationQuerySet

Generic QuerySet containing methods of all other QuerySets

---