utils — Swingtime Utilities¶

Decorator for functions return strings that should be treated as template safe.

Calculate the total number of seconds represented by a datetime.timedelta object

Return a 2-tuple containing the datetime instances for the first and last dates of the current month or using dt as a reference.

Return a dictionary keyed by EventType abbreviations, whose values are an iterable or cycle of CSS class names.

Create a grid-like object representing a sequence of times (rows) and columns where cells are either empty or reference a wrapper object for event occasions that overlap a specific time slot.

Currently, there is an assumption that if an occurrence has a start_time that falls with the temporal scope of the grid, then that start_time will also match an interval in the sequence of the computed row entries.

dt

a datetime.datetime instance or None to default to now

items

a queryset or sequence of Occurrence instances. If None, default to the daily occurrences for dt

start_time

a datetime.time instance, defaulting to swingtime_settings.TIMESLOT_START_TIME

end_time_delta

a datetime.timedelta instance, defaulting to swingtime_settings.TIMESLOT_END_TIME_DURATION

time_delta

a datetime.timedelta instance, defaulting to swingtime_settings.TIMESLOT_INTERVAL

min_column

the minimum number of columns to show in the table, defaulting to swingtime_settings.TIMESLOT_MIN_COLUMNS

css_class_cycles

if not None, a callable returning a dictionary keyed by desired EventType abbreviations with values that iterate over progressive CSS class names for the particular abbreviation; defaults to css_class_cycler()

proxy_class

a wrapper class for accessing an Occurrence object, which should also expose event_type and event_class attrs, and handle the custom output via its __unicode__ method; defaults to DefaultOccurrenceProxy