wbcore 2.2.1__py2.py3-none-any.whl

wbcore/contrib/icons/backends/material.py

@@ -0,0 +1,135 @@
+from . import AbstractBackend
+
+
+class IconBackend(AbstractBackend):
+    """
+    List of Icon supported from the Google Icon Material.
+
+    They can be added and search through https://fonts.google.com/icons?icon.set=Material+Icons
+    """
+
+    @classmethod
+    @property
+    def fallback_icon(cls):
+        return "broken_image"
+
+    ACCOUNT_BALANCE = "account_balance"
+    ADD = "add_circle"
+    APPROVE = "thumb_up_alt"
+    BANK = "account_balance"
+    BIRTHDAY = "cake"
+    BOOKMARK = "bookmark_border"
+    CALENDAR = "calendar_month"
+    CHART_AREA = "stacked_line_chart"
+    CHART_BARS_HORIZONTAL = "align_horizontal_center"
+    CHART_BARS_VERTICAL = "bar_chart"
+    CHART_BARS_VERTICAL_INCREASING = "signal_cellular_alt"
+    CHART_LINE = "show_chart"
+    CHART_PIE = "pie_chart"
+    CHART_PYRAMID = "bar_chart"
+    CHART_SWITCHES = "candlestick_chart"
+    CHART_WATERFALL = "waterfall_chart"
+    CHART_MULTILINE = "ssid_chart"
+    CLIPBOARD = "assignment"
+    CONFIGURE = "tune"
+    CONFIRM = "check_circle"
+    COPY = "content_copy"
+    CURRENCY_EXCHANGE = "currency_exchange"
+    DASHBOARD = "dashboard"
+    DATA_GRID = "analytics"
+    DATA_LIST = "table_view"
+    DATA_EXPLORATION = "query_stats"
+    DAY_OFF = "event_busy"
+    DEAL = "handshake"
+    DEAL_MONEY = "request_quote"
+    DECISION_STEP = "alt_route"
+    DELETE = "delete"
+    DENY = "thumb_down_alt"
+    DISABLED = "block"
+    DOCUMENT = "description"
+    DOCUMENT_IN_PROGRESS = "history_edu"
+    DOCUMENT_PRIVATE = "assignment_late"
+    DOCUMENT_WITH_DOLLAR = "request_page"
+    DOCUMENT_WITH_ATTACHMENT = "file_present"
+    DOLLAR = "attach_money"
+    DOWNLOAD = "file_download"
+    EDIT = "edit"
+    END = "last_page"
+    ENUMERATION = "format_list_numbered"
+    EURO = "euro"
+    EVENT = "event"
+    EVENT_ACCEPTED = "event_available"
+    EXPEND = "fullscreen"
+    FAVORITE = "star"
+    FEEDBACK = "feedback"
+    FOLDERS_ADD = "create_new_folder"
+    FOLDERS_MONEY = "folder_special"
+    FOLDERS_OPEN = "folder_open"
+    GENERATE_NEXT = "next_plan"
+    GOAL = "sports_soccer"
+    GROUPS = "groups"
+    HOME = "home"
+    HISTORY = "history"
+    IGNORE = "visibility_off"
+    IMPORT_EXPORT = "import_export"
+    INFO = "info"
+    INVERSE = "swap_horiz"
+    JOIN_STEP = "merge"
+    LINK = "link"
+    LOCATION = "location_on"
+    LOCK = "lock"
+    LUNCH = "restaurant"
+    MAIL = "email"
+    MAIL_MONEY = "attach_email"
+    MAIL_OPEN = "mark_email_read"
+    MAIL_POSTED = "forward_to_inbox"
+    MERGE = "merge"
+    NEWSPAPER = "newspaper"
+    NEXT = "fast_forward"
+    NOTEBOOK = "notes"
+    OTHER = "more_horiz"
+    PENDING = "pending"
+    PEOPLE = "people_alt"
+    PERSON = "person"
+    PERSON_ADD = "person_add"
+    PHONE = "smartphone"
+    PHONE_ADD = "add_ic_call"
+    PREVIOUS = "fast_rewind"
+    PUBLIC = "public"
+    QUESTION = "question_mark"
+    REDO = "redo"
+    REFRESH = "refresh"
+    REGENERATE = "restart_alt"
+    REJECT = "cancel"
+    REPEAT = "repeat"
+    REPLACE = "published_with_changes"
+    REVIEW = "rate_review"
+    RUNNING = "running_with_errors"
+    SAVE = "save"
+    SCHEDULE = "schedule"
+    SCRIPT = "terminal"
+    SEND = "send"
+    SEND_LATER = "schedule_send"
+    SETTINGS = "settings"
+    SHARE = "share"
+    SHRINK = "fullscreen_exit"
+    SICK_LEAVE = "sick"
+    SPLIT = "call_split"
+    START = "start"
+    STATS = "query_stats"
+    SUPERVISE = "supervised_user_circle"
+    SYNCHRONIZE = "sync"
+    TABLE = "table_chart"
+    TIME_UP = "hourglass_bottom"
+    TRADE = "request_quote"
+    TRAINING = "school"
+    UNDO = "restore"
+    UNFILTER = "filter_alt_off"
+    UNFOLD = "arrow_drop_down"
+    UNLINK = "link_off"
+    UNLOCK = "lock_open"
+    UPLOAD = "file_upload"
+    VACATION = "holiday_village"
+    VIEW = "visibility"
+    WARNING = "warning"
+    WORK = "card_travel"

wbcore/contrib/icons/icons.py

@@ -0,0 +1,169 @@
+import enum
+from contextlib import suppress
+from types import DynamicClassAttribute
+
+from django.conf import settings
+from django.db.models import TextChoices
+from django.db.models.enums import ChoicesMeta
+from wbcore.utils.importlib import import_from_dotted_path
+
+DEFAULT_ICON_BACKEND = "wbcore.contrib.icons.backends.material.IconBackend"
+FALLBACK_ICON_VALUE = "FALLBACK_ICON"
+
+
+class WBIconMeta(ChoicesMeta):
+    """A metaclass for creating a enum choices."""
+
+    def __new__(metacls, classname, bases, classdict, **kwds):
+        dict.__setitem__(
+            classdict, FALLBACK_ICON_VALUE, (FALLBACK_ICON_VALUE, "Fallback Icon")
+        )  # add a default member that represent the fallback in case it's not yet implement in the imported backend
+        cls = super().__new__(metacls, classname, bases, classdict, **kwds)
+        with suppress(ModuleNotFoundError):
+            setattr(
+                cls,
+                "icon_backend",
+                import_from_dotted_path(getattr(settings, "WBCORE_ICON_BACKEND", DEFAULT_ICON_BACKEND)),
+            )
+            icon_backend = cls.icon_backend
+            # For each enumeration values, attached an "icon" property to its members
+            for member, value in zip(cls.__members__.values(), cls.values):
+                member._icon_ = getattr(icon_backend, value, icon_backend.fallback_icon)
+        return enum.unique(cls)
+
+
+class WBIcon(TextChoices, metaclass=WBIconMeta):
+    """
+    This enumeration defines the supported icons. For each attribute, we expect an equivalent attribute in each of the Icon Backends.
+
+    The actual value of the icon can be retreived using `WBIcon.MY_ICON.icon`
+
+    Procedure to add new icon:
+    1) Add the enumeration member in this class (e.g. NEW_ICON = "NEW_ICON", "My new Icon")
+    2) For each supported icon backend, create the equivalent attribute pointing to the material icon value (e.g NEW_ICON = "my_new_icon_in_google_material_icons")
+    """
+
+    @DynamicClassAttribute
+    def icon(self):
+        return self._icon_
+
+    ACCOUNT_BALANCE = "ACCOUNT_BALANCE", "Account Balance"
+    ADD = "ADD", "Add"
+    APPROVE = "APPROVE", "Approve"
+    BANK = "BANK", "Bank"
+    BIRTHDAY = "BIRTHDAY", "Birthday"
+    BOOKMARK = "BOOKMARK", "Bookmark"
+    CALENDAR = "CALENDAR", "Calendar"
+    CHART_AREA = "CHART_AREA", "Chart area"
+    CHART_BARS_HORIZONTAL = "CHART_BARS_HORIZONTAL", "Chart bars horizonal"
+    CHART_BARS_VERTICAL = "CHART_BARS_VERTICAL", "Chart bars vertical"
+    CHART_BARS_VERTICAL_INCREASING = "CHART_BARS_VERTICAL_INCREASING", "Chart bars vertical increasing"
+    CHART_LINE = "CHART_LINE", "Chart line"
+    CHART_PIE = "CHART_PIE", "Chart pie"
+    CHART_PYRAMID = "CHART_PYRAMID", "Chart piramid"
+    CHART_SWITCHES = "CHART_SWITCHES", "Chart switches"
+    CHART_WATERFALL = "CHART_WATERFALL", "Chart waterfall"
+    CHART_MULTILINE = "CHART_MULTILINE", "Chart multiline"
+    CLIPBOARD = "CLIPBOARD", "Clipboard"
+    CONFIRM = "CONFIRM", "Confirm"
+    CONFIGURE = "CONFIGURE", "configure"
+    COPY = "COPY", "Copy"
+    CURRENCY_EXCHANGE = "CURRENCY_EXCHANGE", "Currency Exchange"
+    DASHBOARD = "DASHBOARD", "Dashboard"
+    DATA_GRID = "DATA_GRID", "Data grid"
+    DATA_LIST = "DATA_LIST", "Data list"
+    DATA_EXPLORATION = "DATA_EXPLORATION", "Data exploration"
+    DAY_OFF = "DAY_OFF", "Day off"
+    DEAL = "DEAL", "Deal"
+    DEAL_MONEY = "DEAL_MONEY", "Deal money"
+    DECISION_STEP = "DECISION_STEP", "Decision step"
+    DELETE = "DELETE", "Delete"
+    DENY = "DENY", "Deny"
+    DISABLED = "DISABLED", "Disabled"
+    DOCUMENT = "DOCUMENT", "Document"
+    DOCUMENT_IN_PROGRESS = "DOCUMENT_IN_PROGRESS", "Document in progress"
+    DOCUMENT_PRIVATE = "DOCUMENT_PRIVATE", "Document private"
+    DOCUMENT_WITH_DOLLAR = "DOCUMENT_WITH_DOLLAR", "Document with Dollar"
+    DOCUMENT_WITH_ATTACHMENT = "DOCUMENT_WITH_ATTACHMENT", "Document with Attachment"
+    DOLLAR = "DOLLAR", "Dollar"
+    DOWNLOAD = "DOWNLOAD", "Download"
+    EDIT = "EDIT", "Edit"
+    END = "END", "End"
+    ENUMERATION = "ENUMERATION", "Enumeration"
+    EURO = "EURO", "Euro"
+    EVENT = "EVENT", "Event"
+    EVENT_ACCEPTED = "EVENT_ACCEPTED", "Event accepted"
+    EXPEND = "EXPEND", "Expend"
+    FAVORITE = "FAVORITE", "Favorite"
+    FEEDBACK = "FEEDBACK", "Feedback"
+    FOLDERS_ADD = "FOLDERS_ADD", "Folders add"
+    FOLDERS_MONEY = "FOLDERS_MONEY", "Folders money"
+    FOLDERS_OPEN = "FOLDERS_OPEN", "Folders open"
+    GENERATE_NEXT = "GENERATE_NEXT", "Generate next"
+    GOAL = "GOAL", "Goal"
+    GROUPS = "GROUPS", "Groups"
+    HISTORY = "HISTORY", "History"
+    HOME = "HOME", "Home"
+    IGNORE = "IGNORE", "Ignore"
+    IMPORT_EXPORT = "IMPORT_EXPORT", "Import Export"
+    INFO = "INFO", "Info"
+    INVERSE = "INVERSE", "Inverse"
+    JOIN_STEP = "JOIN_STEP", "Join Step"
+    LINK = "LINK", "Link"
+    LOCATION = "LOCATION", "Location"
+    LOCK = "LOCK", "Lock"
+    LUNCH = "LUNCH", "Lunch"
+    MAIL = "MAIL", "Mail"
+    MAIL_MONEY = "MAIL_MONEY", "Mail Money"
+    MAIL_OPEN = "MAIL_OPEN", "Mail open"
+    MAIL_POSTED = "MAIL_POSTED", "Mail posted"
+    MERGE = "MERGE", "Merge"
+    NEWSPAPER = "NEWSPAPER", "Newspaper"
+    NEXT = "NEXT", "Next"
+    NOTEBOOK = "NOTEBOOK", "Notebook"
+    OTHER = "OTHER", "Other"
+    PEOPLE = "PEOPLE", "People"
+    PENDING = "PENDING", "Pending"
+    PERSON = "PERSON", "Person"
+    PERSON_ADD = "PERSON_ADD", "Person Add"
+    PHONE = "PHONE", "Phone"
+    PHONE_ADD = "PHONE_ADD", "Phone Add"
+    PREVIOUS = "PREVIOUS", "Previous"
+    PUBLIC = "PUBLIC", "Public"
+    QUESTION = "QUESTION", "QUESTION"
+    REDO = "REDO", "Redo"
+    REFRESH = "REFRESH", "Refresh"
+    REGENERATE = "REGENERATE", "Regenerate"
+    REJECT = "REJECT", "Reject"
+    REPEAT = "REPEAT", "Repeat"
+    REPLACE = "REPLACE", "Replace"
+    REVIEW = "REVIEW", "Review"
+    RUNNING = "RUNNING", "Running"
+    SAVE = "SAVE", "Save"
+    SCHEDULE = "SCHEDULE", "Schedule"
+    SCRIPT = "SCRIPT", "Script"
+    SEND = "SEND", "Send"
+    SEND_LATER = "SEND_LATER", "Send Later"
+    SETTINGS = "SETTINGS", "Settings"
+    SHARE = "SHARE", "Share"
+    SHRINK = "SHRINK", "Shrink"
+    SICK_LEAVE = "SICK_LEAVE", "Sick leave"
+    SPLIT = "SPLIT", "Split"
+    START = "START", "Start"
+    STATS = "STATS", "Stats"
+    SUPERVISE = "SUPERVISE", "Supervise"
+    SYNCHRONIZE = "SYNCHRONIZE", "Synchronize"
+    TABLE = "TABLE", "Table"
+    TIME_UP = "TIME_UP", "Time Up"
+    TRADE = "TRADE", "Trade"
+    TRAINING = "TRAINING", "Training"
+    UNDO = "UNDO", "Undo"
+    UNFILTER = "UNFILTER", "Unfilter"
+    UNFOLD = "UNFOLD", "Unfold"
+    UNLINK = "UNLINK", "Unlink"
+    UNLOCK = "UNLOCK", "Unlock"
+    UPLOAD = "UPLOAD", "Upload"
+    VACATION = "VACATION", "Vacation"
+    VIEW = "VIEW", "View"
+    WARNING = "WARNING", "Warning"
+    WORK = "WORK", "Work"

wbcore/contrib/icons/models.py

@@ -0,0 +1,11 @@
+from django.db.models import CharField
+
+
+class IconField(CharField):
+    description = "A field storing an icon"
+
+    def deconstruct(self):
+        name, path, args, kwargs = super().deconstruct()
+        if "choices" in kwargs:
+            del kwargs["choices"]
+        return name, path, args, kwargs

wbcore/contrib/icons/serializers.py

@@ -0,0 +1,18 @@
+from wbcore.serializers.fields.text import CharField
+from wbcore.serializers.fields.types import WBCoreType
+
+from .icons import WBIcon
+
+
+class IconSelectField(CharField):
+    field_type = WBCoreType.ICON.value
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def to_representation(self, value):
+        # Try to get its "icon" representation. If the field is not supported, we simply returns the value (This allow custom and hardcoded icon)
+        try:
+            return WBIcon[value].icon
+        except KeyError:
+            return value

wbcore/contrib/io/admin.py

@@ -0,0 +1,150 @@
+from django.contrib import admin
+from django.contrib.contenttypes.admin import GenericTabularInline
+from django_admin_inline_paginator.admin import TabularInlinePaginated
+
+from .models import (
+    DataBackend,
+    ExportSource,
+    ImportCredential,
+    ImportedObjectProviderRelationship,
+    ImportSource,
+    ParserHandler,
+    Provider,
+    Source,
+    import_data_as_task,
+)
+
+
+def reprocess_import_source(modeladmin, request, queryset):
+    for import_source in queryset:
+        import_data_as_task.delay(import_source.id, force_reimport=True)
+
+
+def reprocess_source(modeladmin, request, queryset):
+    for source in queryset:
+        source.trigger_workflow()
+
+
+class ImportedObjectProviderRelationshipInline(TabularInlinePaginated):
+    ordering = ["object_id"]
+    model = ImportedObjectProviderRelationship
+    extra = 0
+    readonly_fields = ("content_type", "object_id")
+    raw_id_fields = ["content_type", "provider"]
+    per_page = 25
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).select_related("content_type", "provider")
+
+
+class ProviderGenericInline(GenericTabularInline):
+    model = ImportedObjectProviderRelationship
+
+
+@admin.register(ParserHandler)
+class ParserHandlerModelAdmin(admin.ModelAdmin):
+    list_display = ["parser", "handler"]
+
+    search_fields = ["parser", "handler"]
+
+
+@admin.register(Provider)
+class ProviderModelAdmin(admin.ModelAdmin):
+    list_display = ["title"]
+    search_fields = ["title"]
+    inlines = [ImportedObjectProviderRelationshipInline]
+
+
+@admin.register(DataBackend)
+class DataBackendModelAdmin(admin.ModelAdmin):
+    list_display = [
+        "title",
+        "save_data_in_import_source",
+        "backend_class_path",
+        "backend_class_name",
+        "provider",
+    ]
+    search_fields = ["title"]
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).select_related("provider")
+
+
+@admin.register(Source)
+class SourceModelAdmin(admin.ModelAdmin):
+    list_display = ["uuid", "title", "is_active", "crontab", "data_backend"]
+    list_filter = ["data_backend", "is_active"]
+    raw_id_fields = ["crontab", "periodic_task"]
+    search_fields = ["uuid", "data_backend__title", "data_backend__provider__title", "parser_handler__parser"]
+    readonly_fields = ["periodic_task"]
+
+    actions = [reprocess_source]
+    autocomplete_fields = ["parser_handler", "data_backend"]
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .select_related("data_backend", "periodic_task", "crontab")
+            .prefetch_related("parser_handler", "credentials")
+        )
+
+
+@admin.register(ExportSource)
+class ExportSourceModelAdmin(admin.ModelAdmin):
+    list_display = ["status", "file", "resource_path", "content_type", "created", "last_updated", "creator"]
+    list_filter = ["status", "resource_path", "content_type"]
+    autocomplete_fields = ["creator", "content_type"]
+    readonly_fields = ("created", "last_updated", "query_str", "query_params")
+    fieldsets = (
+        (
+            "",
+            {
+                "fields": (
+                    ("status", "created", "last_updated"),
+                    ("content_type", "format"),
+                    ("resource_path", "resource_kwargs"),
+                    ("query_str", "query_params"),
+                    ("file", "origin", "creator"),
+                    ("data",),
+                    ("log",),
+                ),
+            },
+        ),
+    )
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).select_related("content_type")
+
+
+@admin.register(ImportSource)
+class ImportSourceModelAdmin(admin.ModelAdmin):
+    list_display = ["status", "file", "parser_handler", "source", "created", "last_updated"]
+    list_filter = ["status", "source", "parser_handler__handler", "parser_handler__parser"]
+    autocomplete_fields = ["source", "parser_handler"]
+    actions = [reprocess_import_source]
+    readonly_fields = ("created", "last_updated")
+    fieldsets = (
+        (
+            "",
+            {
+                "fields": (
+                    ("status", "created", "last_updated"),
+                    ("parser_handler", "source", "origin"),
+                    ("file", "save_data", "progress_index"),
+                    ("creator",),
+                    ("data",),
+                    ("log",),
+                    ("errors_log",),
+                ),
+            },
+        ),
+    )
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).select_related("source", "parser_handler")
+
+
+@admin.register(ImportCredential)
+class ImportCredentialModelAdmin(admin.ModelAdmin):
+    list_display = ["key", "type", "username", "validity_start", "validity_end"]

wbcore/contrib/io/apps.py

@@ -0,0 +1,27 @@
+from anymail.signals import inbound
+from django.apps import AppConfig
+from django.db.models.signals import post_migrate
+from django.utils.module_loading import autodiscover_modules
+
+
+class ImportExportConfig(AppConfig):
+    name = "wbcore.contrib.io"
+
+    def ready(self):
+        """
+        registered source from settings
+        """
+        # Implicitly connect a signal handlers decorated with @receiver.
+        from wbcore.contrib.io.management import load_sources_from_settings
+
+        from .backends.mail import handle_inbound
+
+        # Explicitly connect a signal handler.
+        inbound.connect(handle_inbound)
+
+        autodiscover_modules("import_export.backends")
+
+        post_migrate.connect(
+            load_sources_from_settings,
+            dispatch_uid="wbcore.contrib.io.load_sources_from_settings",
+        )

wbcore/contrib/io/backends/__init__.py

@@ -0,0 +1,5 @@
+from .abstract import AbstractDataBackend
+from .mail import *
+from .sftp import *
+from .stream import *
+from .utils import register

wbcore/contrib/io/backends/abstract.py

@@ -0,0 +1,60 @@
+from datetime import datetime
+from io import BytesIO
+from typing import Generator, Optional
+
+from django.db import models
+
+
+class AbstractDataBackend:
+    def __init__(self, import_credential: Optional[models.Model] = None, data_backend=None, **kwargs):
+        self.data_backend = data_backend
+        self.import_credential = import_credential
+
+    def is_object_valid(self, obj: models.Model) -> bool:
+        """
+        Can be overriden to define how an object is consired valid by the backend. Default to return True
+
+        Args:
+            obj: The tested object
+
+        Returns:
+            True if the object is considered valid
+        """
+        default_qs = self.get_default_queryset()
+        if default_qs is not None:
+            return isinstance(obj, default_qs.model) and default_qs.filter(pk=obj.pk).exists()
+        return False
+
+    def get_default_queryset(self) -> models.QuerySet | None:
+        """
+        Returns the defaults queryset to loop over by the backend to retreive import files. Used on daily import when no queryset is explicitly provided.
+
+        Returns:
+            The default queryset if it exists, none otherwise (Default)
+        """
+        return None
+
+    def get_provider_id(self, obj: models.Model) -> str | None:
+        """
+        Override if backend support another and different identifier scheme. We expect this function to the external provider identifier given a certain object.
+
+        Args:
+            obj: The object to extract the external identifier
+
+        Returns:
+            The external provider identifier it it exists. None otherwise (Default)
+        """
+        return None
+
+    def get_files(self, execution_time: datetime, **kwargs) -> Generator[tuple[str, BytesIO], None, None] | None:
+        """
+        Override to implement the import file creation logic
+
+        Args:
+            execution_time: The time at which the import takes place
+            **kwargs: Possible keywords arguments to be passed down to the importer.
+
+        Returns:
+            A generator of bitestream object.
+        """
+        pass

wbcore/contrib/io/backends/mail.py

@@ -0,0 +1,85 @@
+import re
+from datetime import datetime
+from io import BytesIO, StringIO
+from typing import Generator, Optional
+
+from anymail.inbound import AnymailInboundMessage
+from django.conf import settings
+from django.db.models import Model, Q
+from dynamic_preferences.registries import global_preferences_registry
+from slugify import slugify
+
+from ..models import Source
+from .abstract import AbstractDataBackend
+from .utils import register
+
+
+@register("Default Mail", save_data_in_import_source=True, passive_only=True)
+class DataBackend(AbstractDataBackend):
+    def get_files(
+        self,
+        execution_time: datetime,
+        file_name_regex: Optional[str] = None,
+        message: Optional[AnymailInboundMessage] = None,
+        import_credential: Optional[Model] = None,
+        import_email_as_file: Optional[bool] = False,
+        **kwargs,
+    ) -> Generator[tuple[str, BytesIO], None, None]:
+        """
+
+        Args:
+            execution_time: The time at which this import was called
+            file_name_regex: The regex applied on the imported file for validation. Defaults to False.
+            message: The AnymailInboundMessage received from the anymail inbounc
+            import_credential: Import credential attached to the calling source. Defaults to None.
+            import_email_as_file: If false, import the attachment as import source file. Otherwise, import the whole email as file
+            **kwargs:
+
+        Returns:
+
+        """
+        if message:
+            if import_email_as_file:
+                filename = f"{slugify(message.subject)}_{datetime.timestamp(execution_time)}.eml"
+                yield filename, StringIO(message.as_string())
+            elif file_name_regex:
+                attachments = message.attachments
+                attachments.extend(message.inline_attachments.values())
+
+                for attachment in attachments:
+                    f = attachment.as_uploaded_file()
+                    f_name = attachment.get_filename()
+                    result = re.findall(file_name_regex, f_name)
+                    if len(result) > 0:
+                        yield f_name, f.file
+
+
+def is_sender_allowed(from_email: str, whitelisted_emails: list[str], admin_mails: list[str]) -> bool:
+    if from_email in admin_mails:
+        return True
+    for whitelisted_email in whitelisted_emails:
+        if re.search(whitelisted_email, from_email):
+            return True
+    return False
+
+
+def handle_inbound(sender, event, esp_name, **kwargs):
+    spam_detected = False
+    if (message := event.message) and (from_email := message.from_email.addr_spec) and (subject := message.subject):
+        if spam_score := getattr(settings, "WBIMPORT_EXPORT_MAILBACKEND_SPAMSCORE", None):
+            spam_detected = message.spam_detected or message.spam_score >= spam_score
+        if not spam_detected:
+            admin_emails = global_preferences_registry.manager()["io__administrator_mails"].split(";")
+            conditions = Q(import_parameters__inbound_address__isnull=True)
+            for t in message.to:
+                conditions |= Q(import_parameters__inbound_address__contains=t.addr_spec)
+
+            sources = Source.objects.filter(
+                conditions & Q(data_backend__backend_class_path="wbcore.contrib.io.backends.mail") & Q(is_active=True)
+            )
+            if s := re.search(r"\[([0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})\]", subject):
+                sources = sources.filter(uuid=s.group(1))
+
+            for source in sources:
+                if is_sender_allowed(from_email, source.import_parameters.get("whitelisted_emails", []), admin_emails):
+                    source.trigger_workflow(message=message)