Поясните python конструкцию кода приведенную ниже?

Question

[VkolV]

Новичок в python и django.
Поясните пожалуйста синтаксис кода данного ниже, и где можно почитать про такие конструкции .values() .annotate() ...? Ну и заодно смысловую нагрузку данного кода.

response.context_data['summary'] = list(
            qs
            .values('sale__category__name')
            .annotate(**metrics)
            .order_by('-total_sales')
        )

взято из этой статьи
Заранее спасибо.

Comments

[Сергей Горностаев]

В документации Django можно почитать.

Answer 1

[Roman K]

Django ORM. У него есть fluent interface. Повангую, этот пример делает какие-то агрегационные действия (в metrics), группирует их по sale__category__name и сортирует по total_sales в порядке убывания, где total_sales — какая-то агрегационная функция, которой ты не написал (скорее всего Sum чего-то)

Comments

[VkolV]

qs
            .values('sale__category__name')
            .annotate(**metrics)
            .order_by('-total_sales')

то же самое что и

qs.values('sale__category__name'),
qs.annotate(**metrics),
qs.order_by('-total_sales'),

или

qs.values('sale__category__name').annotate(**metrics).order_by('-total_sales')

или это синтаксис именно в fluent interface

[Art005]

Не тоже самое, это не три разных обьекта

[Roman K]

VkolV, методы queryset'а не модифицируют queryset, а создают клон каждый раз.

[VkolV]

Спасибо за ответы и комментарии!