wbmailing 2.2.1__tar.gz

wbmailing-2.2.1/.gitignore

@@ -0,0 +1,181 @@
+~
+
+# Docker volumes
+volumes/
+# Poetry auth file
+auth.toml
+
+media/*
+media/
+mediafiles/
+mediafiles/*
+test/*
+staticfiles/*
+staticfiles/
+#
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+info/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+.dccache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+report.xml
+*/report.xml
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+*.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+*.ipynb
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.vscode/
+.idea/
+.idea.bkp/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+crm/
+# Cython debug symbols
+cython_debug/
+
+# Gitlab Runner
+builds
+builds/
+
+# Integrator Office 365 : reverse proxy tunnel for outlook365
+ngrok
+*/ngrok
+/modules/**/system/
+
+/modules/wbmailing/files/*
+/modules/wbmailing/mailing/*
+
+/projects/*/requirements.txt
+public
+
+# Ignore archive localization generated folder
+backend/modules/**/archive/*
+**/**/requirements.txt
+CHANGELOG-*

wbmailing-2.2.1/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.3
+Name: wbmailing
+Version: 2.2.1
+Author-email: Christopher Wittlinger <c.wittlinger@stainly.com>
+Requires-Dist: wbcore

wbmailing-2.2.1/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "wbmailing"
+description = ""
+authors = [{ name = "Christopher Wittlinger", email = "c.wittlinger@stainly.com"}]
+dynamic = ["version"]
+
+dependencies = [
+  "wbcore",
+]
+
+[tool.uv.sources]
+wbcore = { workspace = true }
+
+[tool.uv]
+package = true
+
+[tool.hatch.version]
+path = "../../pyproject.toml"
+
+[tool.hatch.build.targets.sdist]
+include = ["wbmailing/*"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["wbmailing"]
+only-packages = true
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

wbmailing-2.2.1/wbmailing/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

wbmailing-2.2.1/wbmailing/admin.py

@@ -0,0 +1,74 @@
+from django.contrib import admin
+from django.utils.translation import gettext_lazy as _
+
+from .models import (
+    Mail,
+    MailEvent,
+    MailingList,
+    MailingListEmailContactThroughModel,
+    MailingListSubscriberChangeRequest,
+    MailTemplate,
+    MassMail,
+)
+
+
+class MailingListEmailContactThroughInlineAdmin(admin.TabularInline):
+    model = MailingListEmailContactThroughModel
+    fk_name = "mailing_list"
+    autocomplete_fields = ["email_contact"]
+
+
+@admin.register(MailingList)
+class MailingListAdmin(admin.ModelAdmin):
+    autocomplete_fields = ["email_contacts"]
+    search_fields = ["title"]
+    inlines = [
+        MailingListEmailContactThroughInlineAdmin,
+    ]
+
+
+@admin.register(MassMail)
+class MassMailAdmin(admin.ModelAdmin):
+    autocomplete_fields = ["creator"]
+
+    def send_test_mail(self, request, queryset):
+        for mass_mail in queryset:
+            mass_mail.send_test_mail(request.user)
+
+    actions = [send_test_mail]
+
+
+@admin.register(MailingListSubscriberChangeRequest)
+class MailingListSubscriberChangeRequestAdmin(admin.ModelAdmin):
+    list_display = ("email_contact", "mailing_list", "status")
+    autocomplete_fields = ["email_contact", "requester"]
+
+
+admin.site.register(MailEvent)
+
+
+class MailEventInline(admin.TabularInline):
+    model = MailEvent
+    fields = ("timestamp", "event_type", "reject_reason", "recipient", "user_agent", "tags", "description")
+    readonly_fields = ("timestamp", "event_type", "reject_reason", "recipient", "user_agent", "tags", "description")
+    extra = 0
+    can_delete = False
+
+
+@admin.register(Mail)
+class MailAdmin(admin.ModelAdmin):
+    def send_mails(self, request, queryset):
+        for mail in queryset:
+            mail.resend()
+
+    send_mails.short_description = _("Send Emails")
+    actions = [send_mails]
+    search_fields = ["mass_mail__subject", "from_email", "to_email__address", "subject", "message_ids"]
+    autocomplete_fields = ["to_email", "cc_email", "bcc_email"]
+
+    inlines = [MailEventInline]
+
+
+@admin.register(MailTemplate)
+class MailTemplateAdmin(admin.ModelAdmin):
+    pass

wbmailing-2.2.1/wbmailing/apps.py

@@ -0,0 +1,14 @@
+from django.apps import AppConfig
+from django.db.models.signals import post_migrate
+
+
+class WbmailingConfig(AppConfig):
+    name = "wbmailing"
+
+    def ready(self) -> None:
+        from wbmailing.management import initialize_task
+
+        post_migrate.connect(
+            initialize_task,
+            dispatch_uid="wbmailing.initialize_task",
+        )

wbmailing-2.2.1/wbmailing/backend.py

@@ -0,0 +1,131 @@
+from datetime import timedelta
+
+from anymail.backends.mailgun import EmailBackend as AnymailMailgunBackend
+from anymail.backends.mailjet import EmailBackend as AnymailMailjetBackend
+from anymail.backends.mandrill import EmailBackend as AnymailMandrillBackend
+from anymail.backends.postmark import EmailBackend as AnymailPostmarkBackend
+from anymail.backends.sendgrid import EmailBackend as AnymailSendgridBackend
+from anymail.backends.sendinblue import EmailBackend as AnymailSendinblueBackend
+from anymail.exceptions import AnymailError
+from django.conf import settings
+from django.core.mail.backends.console import EmailBackend as ConsoleBackend
+from django.utils import timezone
+from sentry_sdk import capture_message
+from wbcore.utils.html import convert_html2text
+from wbmailing.models import Mail, MailEvent
+
+
+class SendMessagesMixin:
+    def _process_msg(self, message):
+        mail = message.mail if hasattr(message, "mail") else None
+        mass_mail = message.mass_mail if hasattr(message, "mass_mail") else None
+        if mail:
+            event_type = MailEvent.EventType.RESENT
+        else:
+            if not hasattr(message, "silent_mail") or (hasattr(message, "silent_mail") and not message.silent_mail):
+                mail = Mail.create_mail_from_mailmessage(message, user=getattr(message, "user", None))
+            event_type = MailEvent.EventType.CREATED
+        if mass_mail:
+            message.tags = [f"massmail-{mass_mail.id}"]
+        else:
+            message.tags = [f"mail-{mail.id}"]
+        if mail and mail.body:
+            # We reset the body text and html field with what might have been computed in create_mail_from_mailmessage
+            message.body = convert_html2text(mail.body)
+            message.alternatives = []
+            message.attach_alternative(mail.body, "text/html")
+        return event_type, mail
+
+    def send_messages(self, email_messages):
+        """
+        Sends one or more EmailMessage objects and returns the number of email
+        messages sent.
+        """
+        # This API is specified by Django's core BaseEmailBackend
+        # (so you can't change it to, e.g., return detailed status).
+        # Subclasses shouldn't need to override.
+        from wbmailing.models import MailEvent
+
+        num_sent = 0
+        if not email_messages:
+            return num_sent
+
+        created_session = self.open()
+
+        try:
+            for message in email_messages:
+                try:
+                    event_type, mail = self._process_msg(message)
+                    sent = self._send(message)
+                    if mail:
+                        MailEvent.objects.create(
+                            mail=mail, event_type=event_type, timestamp=timezone.now() - timedelta(seconds=1)
+                        )
+                        mail.message_ids.append(message.anymail_status.message_id)
+                        mail.last_send = timezone.now()
+                        mail.save()
+                except AnymailError as e:
+                    capture_message(e)
+                    if self.fail_silently:
+                        sent = False
+                    else:
+                        raise
+                if sent:
+                    num_sent += 1
+        finally:
+            if created_session:
+                self.close()
+
+        return num_sent
+
+
+class PostmarkEmailBackend(SendMessagesMixin, AnymailPostmarkBackend):
+    def send_messages(self, email_messages):
+        if settings.WBMAILING_POSTMARK_BROADCAST_STREAM_ID:
+            for msg in email_messages:
+                if hasattr(msg, "mass_mail") and msg.mass_mail:
+                    msg.esp_extra = {"MessageStream": settings.WBMAILING_POSTMARK_BROADCAST_STREAM_ID}
+
+        return super().send_messages(email_messages)
+
+
+class SendgridEmailBackend(SendMessagesMixin, AnymailSendgridBackend):
+    pass
+
+
+class MailgunEmailBackend(SendMessagesMixin, AnymailMailgunBackend):
+    pass
+
+
+class MailjetEmailBackend(SendMessagesMixin, AnymailMailjetBackend):
+    pass
+
+
+class MandrillEmailBackend(SendMessagesMixin, AnymailMandrillBackend):
+    pass
+
+
+class SendinblueEmailBackend(SendMessagesMixin, AnymailSendinblueBackend):
+    pass
+
+
+class ConsoleEmailBackend(SendMessagesMixin, ConsoleBackend):
+    def send_messages(self, email_messages):
+        """Write all messages to the stream in a thread-safe way."""
+        if not email_messages:
+            return
+        msg_count = 0
+        with self._lock:
+            try:
+                stream_created = self.open()
+                for message in email_messages:
+                    self._process_msg(message)
+                    self.write_message(message)
+                    self.stream.flush()  # flush after each message
+                    msg_count += 1
+                if stream_created:
+                    self.close()
+            except Exception:
+                if not self.fail_silently:
+                    raise
+        return msg_count

wbmailing-2.2.1/wbmailing/dynamic_preferences_registry.py

@@ -0,0 +1,35 @@
+from re import fullmatch
+
+from django.forms import ValidationError
+from django.utils.translation import gettext as _
+from dynamic_preferences.preferences import Section
+from dynamic_preferences.registries import global_preferences_registry
+from dynamic_preferences.types import BooleanPreference, StringPreference
+
+mailing_section = Section("wbmailing")
+
+
+@global_preferences_registry.register
+class DefaultSourceMailPreference(StringPreference):
+    section = mailing_section
+    name = "default_source_mail"
+    default = "info@stainly-bench.com"
+
+    verbose_name = _("Default Source Mail Preference")
+    help_text = _("The default address used to send emails from")
+
+    def validate(self, value):
+        if not fullmatch(r"[^@]+@[^@]+\.[^@]+", value):
+            raise ValidationError(_("Not a valid email format"))
+
+
+@global_preferences_registry.register
+class AutomaticallyApproveUnsubscriptionRequestFromHardBound(BooleanPreference):
+    section = mailing_section
+    name = "automatically_approve_unsubscription_request_from_hard_bounce"
+    default = False
+
+    verbose_name = _("Automatically approve unsubscription request from hard bounce")
+    help_text = _(
+        "Automatically approve unsubscription request from hard bounce received from the ESP tracking system"
+    )

wbmailing-2.2.1/wbmailing/factories.py

@@ -0,0 +1,211 @@
+import factory
+import pytz
+from wbcore.contrib.directory.factories import EmailContactFactory
+from wbmailing.models import (
+    Mail,
+    MailEvent,
+    MailingList,
+    MailingListEmailContactThroughModel,
+    MailingListSubscriberChangeRequest,
+    MailTemplate,
+    MassMail,
+)
+
+
+class MailingListSubscriberChangeRequestFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = MailingListSubscriberChangeRequest
+
+    expiration_date = factory.Faker("date_object")
+    status = MailingListSubscriberChangeRequest.Status.PENDING
+    type = MailingListSubscriberChangeRequest.Type.SUBSCRIBING
+    email_contact = factory.SubFactory("wbcore.contrib.directory.factories.EmailContactFactory")
+    mailing_list = factory.SubFactory("wbmailing.factories.MailingListFactory")
+    requester = factory.SubFactory("wbcore.contrib.authentication.factories.AuthenticatedPersonFactory")
+    approver = factory.SubFactory("wbcore.contrib.authentication.factories.AuthenticatedPersonFactory")
+    reason = factory.Faker("text", max_nb_chars=256)
+
+
+class ApprovedMailingListSubscriberChangeRequest(MailingListSubscriberChangeRequestFactory):
+    status = MailingListSubscriberChangeRequest.Status.APPROVED
+
+
+class MailingListFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = MailingList
+
+    title = factory.Faker("text", max_nb_chars=64)
+    is_public = False
+
+    @factory.post_generation
+    def email_contacts(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for email_contact in extracted:
+                MailingListEmailContactThroughModel.objects.create(
+                    mailing_list=self,
+                    email_contact=email_contact,
+                    status=MailingListEmailContactThroughModel.Status.SUBSCRIBED,
+                )
+
+
+class EmailContactMailingListFactory(MailingListFactory):
+    @factory.post_generation
+    def email_contacts(self, create, extracted, **kwargs):
+        mlscr = MailingListSubscriberChangeRequestFactory()
+        self.email_contacts.add(mlscr.email_contact)
+
+
+class MailingListEmailContactFactory(EmailContactFactory):
+    @factory.post_generation
+    def subscriptions(self, create, extracted, **kwargs):
+        ml = MailingListFactory()
+        MailingListEmailContactThroughModel.objects.create(
+            mailing_list=ml, email_contact=self, status=MailingListEmailContactThroughModel.Status.SUBSCRIBED
+        )
+
+
+class UnsubscribedMailingListEmailContactFactory(EmailContactFactory):
+    @factory.post_generation
+    def subscriptions(self, create, extracted, **kwargs):
+        ml = MailingListFactory()
+        MailingListEmailContactThroughModel.objects.create(
+            mailing_list=ml, email_contact=self, status=MailingListEmailContactThroughModel.Status.UNSUBSCRIBED
+        )
+
+
+class MailingListEmailContactThroughModelFactory(factory.django.DjangoModelFactory):
+    email_contact = factory.SubFactory("wbcore.contrib.directory.factories.EmailContactFactory")
+    mailing_list = factory.SubFactory("wbmailing.factories.MailingListFactory")
+    status = MailingListEmailContactThroughModel.Status.SUBSCRIBED
+
+    class Meta:
+        model = MailingListEmailContactThroughModel
+
+
+class MassMailFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = MassMail
+
+    # status =  #defaut = DRAFT
+    from_email = factory.Faker("email")
+    template = factory.SubFactory("wbmailing.factories.MailTemplateFactory")
+
+    @factory.post_generation
+    def mailing_lists(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for mailing_list in extracted:
+                self.mailing_lists.add(mailing_list)
+
+    subject = factory.Faker("text", max_nb_chars=64)
+    body = factory.Faker("paragraph", nb_sentences=5)
+
+    @factory.post_generation
+    def attachments(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for attachment in extracted:
+                self.attach_document(attachment)
+
+    # body_json = #JSONField(null=True, blank=True)
+    created = factory.Faker("date_time", tzinfo=pytz.utc)
+    creator = factory.SubFactory("wbcore.contrib.directory.factories.PersonFactory")
+    send_at = factory.Faker("date_time_between", start_date="now", end_date="+30y", tzinfo=pytz.utc)
+
+
+class CustomMassMailFactory(MassMailFactory):
+    @factory.post_generation
+    def mailing_lists(self, create, extracted, **kwargs):
+        ml = MailingListFactory()
+        self.mailing_lists.add(ml)
+
+
+class CustomMassMailEmailContactFactory(EmailContactFactory):
+    @factory.post_generation
+    def subscriptions(self, create, extracted, **kwargs):
+        ml = MailingListFactory.create()
+        ml.add_to_mailinglist(self)
+        MassMailFactory.create(mailing_lists=[ml])
+
+
+class MailFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = Mail
+
+    created = factory.Faker("date_time", tzinfo=pytz.utc)
+    last_send = factory.Faker("date_time", tzinfo=pytz.utc)
+    template = factory.SubFactory("wbmailing.factories.MailTemplateFactory")
+    message_ids = factory.List([factory.Faker("pystr")])
+    mass_mail = factory.SubFactory("wbmailing.factories.MassMailFactory")
+    from_email = factory.Faker("email")
+
+    @factory.post_generation
+    def to_email(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for email in extracted:
+                self.to_email.add(email)
+
+    @factory.post_generation
+    def cc_email(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for email in extracted:
+                self.cc_email.add(email)
+
+    @factory.post_generation
+    def bcc_email(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for email in extracted:
+                self.bcc_email.add(email)
+
+    subject = factory.Faker("text", max_nb_chars=64)
+    body = factory.Faker("paragraph", nb_sentences=5)
+    # body_json =  # JSONField(null=True, blank=True)
+
+    @factory.post_generation
+    def attachments(self, create, extracted, **kwargs):
+        if not create:
+            return
+        if extracted:
+            for attachment in extracted:
+                self.attach_document(attachment)
+
+
+class ToEmailMailFactory(MailFactory):
+    @factory.post_generation
+    def to_email(self, create, extracted, **kwargs):
+        ec = EmailContactFactory.create()
+        self.to_email.add(ec)
+
+
+class MailEventFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = MailEvent
+
+    mail = factory.SubFactory("wbmailing.factories.MailFactory")
+    timestamp = factory.Faker("date_time", tzinfo=pytz.utc)
+    # event_type =  # default=EventType.CREATED
+    reject_reason = ""  # default=null   # RejectReason.choices
+    description = factory.Faker("paragraph", nb_sentences=2)
+    recipient = factory.Faker("email")
+    click_url = factory.Faker("image_url")
+    ip = factory.Faker("ipv4")
+    user_agent = factory.Faker("first_name")
+    # raw_data =   JSONField(default=dict, null=True, blank=True, verbose_name="Raw Data")
+
+
+class MailTemplateFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = MailTemplate
+
+    title = factory.Faker("text", max_nb_chars=64)
+    template = factory.Faker("paragraph", nb_sentences=5)

wbmailing-2.2.1/wbmailing/filters/__init__.py

@@ -0,0 +1,8 @@
+from .mailing_lists import (
+    EmailContactMailingListFilterSet,
+    MailingListEmailContactThroughModelModelFilterSet,
+    MailingListFilterSet,
+    MailingListSubscriberChangeRequestFilterSet,
+    MailStatusMassMailFilterSet,
+)
+from .mails import MailFilter, MassMailFilterSet