election_day.collections.archived_results

Module Contents

Classes

ArchivedResultCollection
SearchableArchivedResultCollection	Provides collections with pagination, if they implement a few

Functions

groupbydict(…)

Attributes

_T1

election_day.collections.archived_results._T1

election_day.collections.archived_results.groupbydict(items: Iterable[_T1], keyfunc: Callable[[_T1], _TSupportsRichComparison], sortfunc: None = None, groupfunc: Callable[[Iterable[_T1]], list[_T1]] = list) → dict[_TSupportsRichComparison, list[_T1]]

election_day.collections.archived_results.groupbydict(items: Iterable[_T1], keyfunc: Callable[[_T1], _T2], sortfunc: Callable[[_T1], SupportsRichComparison], groupfunc: Callable[[Iterable[_T1]], list[_T1]] = list) → dict[_T2, list[_T1]]

election_day.collections.archived_results.groupbydict(items: Iterable[_T1], keyfunc: Callable[[_T1], _TSupportsRichComparison], sortfunc: None = None, *, groupfunc: Callable[[Iterable[_T1]], _T2]) → dict[_TSupportsRichComparison, _T2]

election_day.collections.archived_results.groupbydict(items: Iterable[_T1], keyfunc: Callable[[_T1], _TSupportsRichComparison], sortfunc: None, groupfunc: Callable[[Iterable[_T1]], _T2]) → dict[_TSupportsRichComparison, _T2]

election_day.collections.archived_results.groupbydict(items: Iterable[_T1], keyfunc: Callable[[_T1], _T2], sortfunc: Callable[[_T1], SupportsRichComparison], groupfunc: Callable[[Iterable[_T1]], _T3]) → dict[_T2, _T3]

class election_day.collections.archived_results.ArchivedResultCollection(session: sqlalchemy.orm.Session, date_: str | None = None)

for_date(date_: str) → typing_extensions.Self

query() → Query[ArchivedResult]

get_years() → list[int]

Returns a list of available years.

group_items(items: Collection[ArchivedResult], request: onegov.election_day.request.ElectionDayRequest) → dict[datetime.date, dict[str | None, dict[str, list[onegov.election_day.models.ArchivedResult]]]] | None

Groups a list of archived results.

Groups election compounds and elections to the same group. Removes elections already covered by an election compound. Merges region, district and none domains.

current() → tuple[list[onegov.election_day.models.ArchivedResult], datetime | None]

Returns the current results.

The current results are the results from either the next election day relative to today or the last results relative to today, if no next.

by_year(year: int) → tuple[list[onegov.election_day.models.ArchivedResult], datetime | None]

Returns the results for the given year.

by_date(date_: datetime.date | None = None) → tuple[list[onegov.election_day.models.ArchivedResult], datetime | None]

Returns the results of a given/current date.

update(item: onegov.ballot.Election | onegov.ballot.ElectionCompound | onegov.ballot.Vote, request: onegov.election_day.request.ElectionDayRequest, old: str | None = None) → onegov.election_day.models.ArchivedResult

Updates a result.

update_all(request: onegov.election_day.request.ElectionDayRequest) → None

Updates all (local) results.

add(item: onegov.ballot.Election | onegov.ballot.ElectionCompound | onegov.ballot.Vote, request: onegov.election_day.request.ElectionDayRequest) → None

Add a new election or vote and create a result entry.

clear_results(item: onegov.ballot.Election | onegov.ballot.ElectionCompound | onegov.ballot.Vote, request: onegov.election_day.request.ElectionDayRequest, clear_all: bool = False) → None

Clears the result of an election or vote.

delete(item: onegov.ballot.Election | onegov.ballot.ElectionCompound | onegov.ballot.Vote, request: onegov.election_day.request.ElectionDayRequest) → None

Deletes an election or vote and the associated result entry.

class election_day.collections.archived_results.SearchableArchivedResultCollection(app: onegov.election_day.app.ElectionDayApp, date_: str | None = None, from_date: datetime.date | None = None, to_date: datetime.date | None = None, item_type: str | None = None, domains: list[str] | None = None, term: str | None = None, answers: list[str] | None = None, locale: str = 'de_CH', page: int = 0)

Bases: ArchivedResultCollection, onegov.core.collection.Pagination[onegov.election_day.models.ArchivedResult]

Provides collections with pagination, if they implement a few documented properties and methods.

See onegov.ticket.TicketCollection for an example.

property page_index: int

Returns the current page index (starting at 0).

property term_filter: tuple[ColumnElement[TSVECTOR | None], ColumnElement[TSVECTOR | None]]

page: int

__eq__(other: object) → bool

Return self==value.

subset() → Query[ArchivedResult]

Returns an SQLAlchemy query containing all records that should be considered for pagination.

page_by_index(index: int) → typing_extensions.Self

Returns the page at the given index. A page here means an instance of the class inheriting from the Pagination base class.

static term_to_tsquery_string(term: str | None) → str

Returns the current search term transformed to use within Postgres to_tsquery function. Removes all unwanted characters, replaces prefix matching, joins word together using FOLLOWED BY.

static match_term(column: ColumnElement[Any], language: str, term: str) → ColumnElement[TSVECTOR | None]

Usage: model.filter(match_term(model.col, ‘german’, ‘my search term’))

static filter_text_by_locale(column: ColumnElement[Any], term: str, locale: str = 'en') → ColumnElement[TSVECTOR | None]

Returns an SQLAlchemy filter statement based on the search term. If no locale is provided, it will use english as language.

to_tsquery creates a tsquery value from term, which must consist of

single tokens separated by these Boolean operators:

• & (AND)

• | (OR)

• ! (NOT)

to_tsvector parses a textual document into tokens, reduces the tokens to lexemes, and returns a tsvector which lists the lexemes together with their positions in the document.

The document is processed according to the specified or default text search configuration.

query() → Query[ArchivedResult]

reset_query_params() → None

classmethod for_item_type(app: onegov.election_day.app.ElectionDayApp, item_type: Literal[vote, election], *, date_: str | None = None, from_date: datetime.date | None = None, to_date: datetime.date | None = None, domains: list[str] | None = None, term: str | None = None, answers: list[str] | None = None, locale: str = 'de_CH', page: int = 0) → typing_extensions.Self

classmethod for_item_type(app: onegov.election_day.app.ElectionDayApp, item_type: str | None, *, date_: str | None = None, from_date: datetime.date | None = None, to_date: datetime.date | None = None, domains: list[str] | None = None, term: str | None = None, answers: list[str] | None = None, locale: str = 'de_CH', page: int = 0) → Self | None