activity.models.occasion

Module Contents

Classes

Occasion

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

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.

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.

property max_spots: int

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.

__tablename__ = 'occasions'

id: Column[uuid.UUID]

meeting_point: Column[str | None]

age: Column[BoundedIntegerRange]

spots: Column[BoundedIntegerRange]

note: Column[str | None]

cost: Column[Decimal | None]

booking_cost: Column[Decimal | None]

activity_id: Column[uuid.UUID]

period_id: Column[uuid.UUID]

cancelled: Column[bool]

duration: Column[int | None]

order: Column[int | None]

exclude_from_overlap_check: Column[bool]

exempt_from_booking_limit: Column[bool]

active_days: Column[list[int]]

weekdays: Column[list[int]]

seeking_volunteers: Column[bool]

bookings: relationship[list[Booking]]

dates: relationship[list[OccasionDate]]

accepted: relationship[Sequence[Booking]]

needs: relationship[list[OccasionNeed]]

__hash__() → int

Return hash(self).

attendee_count() → ColumnElement[int]

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..

total_cost() → decimal.Decimal

Calculates the cost of booking a single occasion, including all costs only relevant to this occasion (i.e. excluding the all-inclusive subscription cost).

total_cost() → ColumnElement[Decimal]

compute_duration(dates: Collection[OccasionDate] | None) → int

compute_order(dates: Collection[OccasionDate] | None) → int

compute_active_days(dates: Collection[OccasionDate] | None) → list[int]

compute_weekdays(dates: Collection[OccasionDate] | None) → list[int]

observe_dates(dates: Collection[OccasionDate] | None) → None

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

observe_needs(needs: Collection[OccasionNeed] | None) → None

operable() → bool

full() → bool

available_spots() → int

available_spots() → ColumnElement[int]

is_past_deadline(now: datetime.datetime) → bool

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

cancel() → None

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

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