Code reference › domain › schedule

module

pretalx.schedule.domain.slot

Functions 4

copy_slot(slot, *, schedule, save=True)sourceCreate a new slot in schedule cloning every field of slot.

def copy_slot(slot, *, schedule, save=True):
    """Create a new slot in ``schedule`` cloning every field of ``slot``."""
    new_slot = TalkSlot(schedule=schedule)
    for field in slot._meta.fields:
        if field.name in ("id", "schedule"):
            continue
        setattr(new_slot, field.attname, getattr(slot, field.attname))
    if save:
        new_slot.save()
    return new_slot

create_slot(*, schedule, room=None, slot_type=SlotType.BREAK, start, end=None, duration=None, description=None)sourceCreate a non-submission slot (break or blocker) on schedule.

def create_slot(
    *,
    schedule,
    room=None,
    slot_type=SlotType.BREAK,
    start,
    end=None,
    duration=None,
    description=None,
):
    """Create a non-submission slot (break or blocker) on ``schedule``."""
    if slot_type not in SlotType.values:
        slot_type = SlotType.BREAK
    if end is None:
        minutes = duration if duration is not None else DEFAULT_SLOT_MINUTES
        end = start + dt.timedelta(minutes=minutes)
    return schedule.talks.create(
        room=room, description=description, start=start, end=end, slot_type=slot_type
    )

move_slot(slot, start, *, room=None, end=None, duration=None)sourcePlace slot at start (and consequently at end).

end is determined in this priority order: an explicit end argument, then duration in minutes, then the slot's submission duration, then the slot's own current duration, finally a default fallback for slots without a submission.

def move_slot(slot, start, *, room=None, end=None, duration=None):
    """Place ``slot`` at ``start`` (and consequently at ``end``).

    ``end`` is determined in this priority order: an explicit ``end``
    argument, then ``duration`` in minutes, then the slot's submission
    duration, then the slot's own current duration, finally a default
    fallback for slots without a submission.
    """
    if end is None:
        if duration is not None:
            minutes = duration
        elif slot.submission:
            minutes = slot.submission.get_duration()
        else:
            minutes = slot.duration or DEFAULT_SLOT_MINUTES
        end = start + dt.timedelta(minutes=minutes)
    slot.start = start
    slot.end = end
    if room is not None:
        slot.room = room
    slot.save(update_fields=["start", "end", "room", "updated"])
    return slot

unschedule_slot(slot)sourceDrop the slot from the schedule (clear start, end, and room).

def unschedule_slot(slot):
    """Drop the slot from the schedule (clear start, end, and room)."""
    slot.start = None
    slot.end = None
    slot.room = None
    slot.save(update_fields=["start", "end", "room", "updated"])
    return slot