Implement basic mailling list management

Only via admin interface for now. Contains feature to sync to list server via a
configured command.

README.md

@@ -371,6 +371,11 @@ MEMBERSHIP_FEE_REMINDER_DATES = [
 - `HANDLE_BALANCE`: Allows to handle money balances for members (False default)
 - `INVOICES_INCLUDE_CONFIG_COMMENTS`: Add comment related to a subscription configuration when generating invoices
 - `MEMBER_CAN_EDIT_VPN_CONF`: Allow members to edit some part of their vpn configuration
+- `MAILLIST_SYNC_COMMAND` : The command to send the list of mail addresses of a
+  given mailling list to mail list server. The command will receives one
+  address/line on stdin. This setting could use placholders:
+    - `{email}`: the mail address of the list
+    - `{short_name}`: the list name
 - `DEBUG` : Enable debug for development **do not use in production** : display
    stracktraces and enable [django-debug-toolbar](https://django-debug-toolbar.readthedocs.io).
 - `SITE_TITLE`: the base of site title (displayed in browser window/tab title)

coin/settings_base.py

@@ -337,3 +337,7 @@ HANDLE_BALANCE = False
 
 # Add subscription comments in invoice items
 INVOICES_INCLUDE_CONFIG_COMMENTS = True
+
+## maillist module
+# Command that push mailling-list subscribers to the lists server
+MAILLIST_SYNC_COMMAND = ''

maillists/__init__.py

@@ -0,0 +1 @@
+default_app_config = 'maillists.app.MailListsConfig'

maillists/admin.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import unicode_literals
+
+
+import autocomplete_light
+from django.contrib import admin
+from django.contrib import messages
+
+from .models import MaillingList
+
+
+class MaillingListAdmin(admin.ModelAdmin):
+    list_display = ('email', 'verbose_name')
+    actions = ['sync_to_server']
+
+    def sync_to_server(self, request, queryset):
+        for _list in queryset.all():
+            try:
+                _list.sync_to_list_server()
+            except Exception as e:
+                messages.error(
+                    request,
+                    'Impossible de synchroniser la liste {} : "{}"'.format(
+                        _list, e))
+            else:
+                messages.success(
+                    request,
+                    'Liste {} synchronisée vers le serveur'.format(
+                        _list.email))
+    sync_to_server.short_description = (
+        'Synchroniser les listes sélectionnées vers le serveur')
+
+    form = autocomplete_light.modelform_factory(
+        MaillingList,
+        fields='__all__',
+    )
+
+
+admin.site.register(MaillingList, MaillingListAdmin)

maillists/app.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+from __future__ import unicode_literals
+
+from django.apps import AppConfig
+
+
+class MailListsConfig(AppConfig):
+    name = 'maillists'
+    verbose_name = "Listes mail"

maillists/migrations/0001_initial.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+from django.conf import settings
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='MaillingList',
+            fields=[
+                ('id', models.AutoField(verbose_name='ID', serialize=False, auto_created=True, primary_key=True)),
+                ('short_name', models.CharField(help_text=b'c\'est l\'identifiant qui servira \xc3\xa0 communiquer avec le syst\xc3\xa8me de mailling-list(typiquement, la partie avant le "@" dans l\'adress )', max_length=50, verbose_name=b'identifiant technique')),
+                ('email', models.EmailField(max_length=254, verbose_name=b"adresse mail d'envoi")),
+                ('verbose_name', models.CharField(help_text=b"Nom affich\xc3\xa9 dans l'interface membre", max_length=130, verbose_name=b'nom complet')),
+                ('description', models.TextField()),
+                ('subscribers', models.ManyToManyField(related_name='subscribed_maillinglists', verbose_name=b'abonn\xc3\xa9\xc2\xb7e\xc2\xb7s', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'liste mail',
+                'verbose_name_plural': 'listes mail',
+            },
+        ),
+    ]

maillists/models.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import unicode_literals
+
+import subprocess
+
+from django.conf import settings
+from django.db import models
+
+from coin.members.models import Member
+
+
+class MaillingList(models.Model):
+    short_name = models.CharField(
+        'identifiant technique', max_length=50,
+        help_text=(
+            "c'est l'identifiant qui servira à "
+            "communiquer avec le système de mailling-list"
+            "(typiquement, la partie avant le \"@\" dans l'adress )"
+        )
+    )
+    email = models.EmailField("adresse mail d'envoi")
+    verbose_name = models.CharField(
+        'nom complet', max_length=130,
+        help_text="Nom affiché dans l'interface membre"
+    )
+    description = models.TextField()
+    subscribers = models.ManyToManyField(
+        Member, related_name='subscribed_maillinglists',
+        verbose_name='abonné·e·s')
+
+    class Meta:
+        verbose_name = 'liste mail'
+        verbose_name_plural = 'listes mail'
+
+    def __unicode__(self):
+        return '{} ({})'.format(self.verbose_name, self.email)
+
+    def as_text_listing(self):
+        """ One subscriber email per line
+        """
+        return '\n'.join(
+                self.subscribers.values_list('email', flat=True))
+
+    def sync_to_list_server(self):
+        if not settings.MAILLIST_SYNC_COMMAND:
+            raise ValueError('You should define MAILLIST_SYNC_COMMAND'
+                             ' setting to use maillist module')
+        else:
+            cmd = settings.MAILLIST_SYNC_COMMAND.format(
+                email=self.email,
+                short_name=self.short_name,
+            )
+            p = subprocess.Popen(
+                cmd, shell=True,
+                stdin=subprocess.PIPE, stderr=subprocess.PIPE)
+            out_stdout, out_stderr = p.communicate(address_list)
+            if p.returncode != 0:
+                raise SystemError(
+                    "Erreur à l'appel de la commande : \"{}\"".format(
+                        out_stderr))

maillists/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.