mirror of
https://github.com/django/django.git
synced 2025-09-05 02:01:02 +00:00
ff60c5f9de
This monster of a patch is the result of Alex Gaynor's 2009 Google Summer of Code project. Congratulations to Alex for a job well done. Big thanks also go to: * Justin Bronn for keeping GIS in line with the changes, * Karen Tracey and Jani Tiainen for their help testing Oracle support * Brett Hoerner, Jon Loyens, and Craig Kimmerer for their feedback. * Malcolm Treddinick for his guidance during the GSoC submission process. * Simon Willison for driving the original design process * Cal Henderson for complaining about ponies he wanted. ... and everyone else too numerous to mention that helped to bring this feature into fruition. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11952 bcc190cf-cafb-0310-a4f2-bffc1f526a37
67 lines
2.1 KiB
Python
67 lines
2.1 KiB
Python
"""
|
|
Classes to represent the definitions of aggregate functions.
|
|
"""
|
|
|
|
class Aggregate(object):
|
|
"""
|
|
Default Aggregate definition.
|
|
"""
|
|
def __init__(self, lookup, **extra):
|
|
"""Instantiate a new aggregate.
|
|
|
|
* lookup is the field on which the aggregate operates.
|
|
* extra is a dictionary of additional data to provide for the
|
|
aggregate definition
|
|
|
|
Also utilizes the class variables:
|
|
* name, the identifier for this aggregate function.
|
|
"""
|
|
self.lookup = lookup
|
|
self.extra = extra
|
|
|
|
def _default_alias(self):
|
|
return '%s__%s' % (self.lookup, self.name.lower())
|
|
default_alias = property(_default_alias)
|
|
|
|
def add_to_query(self, query, alias, col, source, is_summary):
|
|
"""Add the aggregate to the nominated query.
|
|
|
|
This method is used to convert the generic Aggregate definition into a
|
|
backend-specific definition.
|
|
|
|
* query is the backend-specific query instance to which the aggregate
|
|
is to be added.
|
|
* col is a column reference describing the subject field
|
|
of the aggregate. It can be an alias, or a tuple describing
|
|
a table and column name.
|
|
* source is the underlying field or aggregate definition for
|
|
the column reference. If the aggregate is not an ordinal or
|
|
computed type, this reference is used to determine the coerced
|
|
output type of the aggregate.
|
|
* is_summary is a boolean that is set True if the aggregate is a
|
|
summary value rather than an annotation.
|
|
"""
|
|
klass = getattr(query.aggregates_module, self.name)
|
|
aggregate = klass(col, source=source, is_summary=is_summary, **self.extra)
|
|
query.aggregates[alias] = aggregate
|
|
|
|
class Avg(Aggregate):
|
|
name = 'Avg'
|
|
|
|
class Count(Aggregate):
|
|
name = 'Count'
|
|
|
|
class Max(Aggregate):
|
|
name = 'Max'
|
|
|
|
class Min(Aggregate):
|
|
name = 'Min'
|
|
|
|
class StdDev(Aggregate):
|
|
name = 'StdDev'
|
|
|
|
class Sum(Aggregate):
|
|
name = 'Sum'
|
|
|
|
class Variance(Aggregate):
|
|
name = 'Variance'
|