OpenSlides/openslides/agenda/signals.py

from django.apps import apps
from django.contrib.contenttypes.models import ContentType

from .models import Item
from ..utils.autoupdate import inform_changed_data


def listen_to_related_object_post_save(sender, instance, created, **kwargs):
    """
    Receiver function to create agenda items. It is connected to the signal
    django.db.models.signals.post_save during app loading.

    The agenda_item_update_information container may have fields like type,
    parent_id, comment, duration, weight or skip_autoupdate.

    Do not run caching and autoupdate if the instance has a key
    skip_autoupdate in the agenda_item_update_information container.
    """
    if hasattr(instance, "get_agenda_title_information"):
        if created:
            attrs = {}
            for attr in ("type", "parent_id", "comment", "duration", "weight"):
                if instance.agenda_item_update_information.get(attr):
                    attrs[attr] = instance.agenda_item_update_information.get(attr)
            Item.objects.create(content_object=instance, **attrs)

            # If the object is created, the related_object has to be sent again.
            if not instance.agenda_item_update_information.get("skip_autoupdate"):
                inform_changed_data(instance)
        elif not instance.agenda_item_update_information.get("skip_autoupdate"):
            # If the object has changed, then also the agenda item has to be sent.
            inform_changed_data(instance.agenda_item)


def listen_to_related_object_post_delete(sender, instance, **kwargs):
    """
    Receiver function to delete agenda items. It is connected to the signal
    django.db.models.signals.post_delete during app loading.
    """
    if hasattr(instance, "get_agenda_title_information"):
        content_type = ContentType.objects.get_for_model(instance)
        try:
            # Attention: This delete() call is also necessary to remove
            # respective active list of speakers projector elements.
            Item.objects.get(object_id=instance.pk, content_type=content_type).delete()
        except Item.DoesNotExist:
            # Item does not exist so we do not have to delete it.
            pass


def get_permission_change_data(sender, permissions, **kwargs):
    """
    Yields all necessary collections if 'agenda.can_see' or
    'agenda.can_see_internal_items' permissions changes.
    """
    agenda_app = apps.get_app_config(app_label="agenda")
    for permission in permissions:
        # There could be only one 'agenda.can_see' and then we want to return data.
        if (
            permission.content_type.app_label == agenda_app.label
            and permission.codename in ("can_see", "can_see_internal_items")
        ):
            yield from agenda_app.get_startup_elements()
            break