activity.models.occasion

Classes

Occasion

Describes a single occurrence of an Activity. "Occurence" would have

Module Contents

class activity.models.occasion.Occasion

Bases: onegov.core.orm.Base, onegov.core.orm.mixins.TimestampMixin

Describes a single occurrence of an Activity. “Occurence” would have been a good word for it too, but that’s used by onegov.event.

So occasion it is.

__tablename__ = 'occasions'

__hash__() → int

id: sqlalchemy.Column[uuid.UUID]

meeting_point: sqlalchemy.Column[str | None]

age: sqlalchemy.Column[onegov.activity.types.BoundedIntegerRange]

spots: sqlalchemy.Column[onegov.activity.types.BoundedIntegerRange]

note: sqlalchemy.Column[str | None]

cost: sqlalchemy.Column[decimal.Decimal | None]

booking_cost: sqlalchemy.Column[decimal.Decimal | None]

activity_id: sqlalchemy.Column[uuid.UUID]

activity: sqlalchemy.orm.relationship[activity.models.activity.Activity]

accepted: sqlalchemy.orm.relationship[collections.abc.Sequence[activity.models.booking.Booking]]

period_id: sqlalchemy.Column[uuid.UUID]

period: sqlalchemy.orm.relationship[activity.models.period.Period]

cancelled: sqlalchemy.Column[bool]

duration: sqlalchemy.Column[int | None]

order: sqlalchemy.Column[int | None]

exclude_from_overlap_check: sqlalchemy.Column[bool]

exempt_from_booking_limit: sqlalchemy.Column[bool]

active_days: sqlalchemy.Column[list[int]]

weekdays: sqlalchemy.Column[list[int]]

seeking_volunteers: sqlalchemy.Column[bool]

attendee_count() → sqlalchemy.sql.ColumnElement[int]

bookings: sqlalchemy.orm.relationship[list[activity.models.booking.Booking]]

dates: sqlalchemy.orm.relationship[list[activity.models.occasion_date.OccasionDate]]

needs: sqlalchemy.orm.relationship[list[activity.models.occasion_need.OccasionNeed]]

on_date_change() → None

Date changes are not properly propagated to the observer for some reason, so we do this manually with a hook.

It’s a bit of a hack, but multiple dates per occasion had to be added at the last minute..

property anti_affinity_group: tuple[str, str]

Uses the activity_id/period_id as an anti-affinity group to ensure that an attendee is never given two occasions of the same activity in a single period.

If that is wanted, the attendee is meant to do this after the matching has been done, with a direct booking.

total_cost: sqlalchemy.Column[decimal.Decimal]

compute_duration(dates: collections.abc.Collection[activity.models.occasion_date.OccasionDate] | None) → int

compute_order(dates: collections.abc.Collection[activity.models.occasion_date.OccasionDate] | None) → int

compute_active_days(dates: collections.abc.Collection[activity.models.occasion_date.OccasionDate] | None) → list[int]

compute_weekdays(dates: collections.abc.Collection[activity.models.occasion_date.OccasionDate] | None) → list[int]

observe_dates(dates: collections.abc.Collection[activity.models.occasion_date.OccasionDate] | None) → None

validate_dates(key: str, date: activity.models.occasion_date.OccasionDate) → activity.models.occasion_date.OccasionDate

observe_needs(needs: collections.abc.Collection[activity.models.occasion_need.OccasionNeed] | None) → None

operable: sqlalchemy.Column[bool]

full() → bool

available_spots() → int

property max_spots: int

is_past_deadline(now: datetime.datetime) → bool

is_past_cancellation(date: Occasion.is_past_cancellation.date) → bool

property deadline: datetime.date

The date until which this occasion may be booked (inclusive).

property cancellation_deadline: datetime.date | None

The date until which bookings of this occasion may be cancelled by a mere member (inclusive).

If mere members are not allowed to do that, the deadline returns None.

cancel() → None

is_too_young(birth_date: datetime.date | datetime.datetime) → bool

is_too_old(birth_date: datetime.date | datetime.datetime) → bool