DRY-up and enforce kwargs for most events

For most events this makes the purpose of each argument clearer at
the point the event is called. It's still worth having a function
for each event type, as this abstracts knowledge of the event label.
Using a schema approach will make adding new events easier.

In the next commit we'll DRY-up the duplication in the tests as well.

app/event_handlers.py

@@ -2,94 +2,62 @@ from flask import request
 
 from app import events_api_client
 
+EVENT_SCHEMAS = {
+    "sucessful_login": {"user_id"},
+    "update_user_email": {"user_id", "updated_by_id", "original_email_address", "new_email_address"},
+    "update_user_mobile_number": {"user_id", "updated_by_id", "original_mobile_number", "new_mobile_number"},
+    "remove_user_from_service": {"user_id", "removed_by_id", "service_id"},
+    "add_user_to_service": {"user_id", "invited_by_id", "service_id"},
+    "archive_user": {"user_id", "archived_by_id"},
+    "change_broadcast_account_type": {"service_id", "changed_by_id", "service_mode", "broadcast_channel", "provider_restriction"},  # noqa: E501 (length)
+    "archive_service": {"service_id", "archived_by_id"},
+    "suspend_service": {"service_id", "suspended_by_id"},
+}
+
 
 def on_user_logged_in(_sender, user):
     _send_event('sucessful_login', user_id=user.id)
 
 
-def create_email_change_event(user_id, updated_by_id, original_email_address, new_email_address):
-    _send_event(
-        'update_user_email',
-        user_id=user_id,
-        updated_by_id=updated_by_id,
-        original_email_address=original_email_address,
-        new_email_address=new_email_address)
+def create_email_change_event(**kwargs):
+    _send_event('update_user_email', **kwargs)
 
 
-def create_mobile_number_change_event(user_id, updated_by_id, original_mobile_number, new_mobile_number):
-    _send_event(
-        'update_user_mobile_number',
-        user_id=user_id,
-        updated_by_id=updated_by_id,
-        original_mobile_number=original_mobile_number,
-        new_mobile_number=new_mobile_number)
+def create_mobile_number_change_event(**kwargs):
+    _send_event('update_user_mobile_number', **kwargs)
 
 
-def create_remove_user_from_service_event(user_id, removed_by_id, service_id):
-    _send_event(
-        'remove_user_from_service',
-        user_id=user_id,
-        removed_by_id=removed_by_id,
-        service_id=service_id
-    )
+def create_remove_user_from_service_event(**kwargs):
+    _send_event('remove_user_from_service', **kwargs)
 
 
-def create_add_user_to_service_event(user_id, invited_by_id, service_id):
-    _send_event(
-        'add_user_to_service',
-        user_id=user_id,
-        invited_by_id=invited_by_id,
-        service_id=service_id
-    )
+def create_add_user_to_service_event(**kwargs):
+    _send_event('add_user_to_service', **kwargs)
 
 
-def create_archive_user_event(user_id, archived_by_id):
-    _send_event(
-        'archive_user',
-        user_id=user_id,
-        archived_by_id=archived_by_id)
+def create_archive_user_event(**kwargs):
+    _send_event('archive_user', **kwargs)
 
 
-def create_broadcast_account_type_change_event(
-    service_id,
-    changed_by_id,
-    service_mode,
-    broadcast_channel,
-    provider_restriction,
-):
-    _send_event(
-        'change_broadcast_account_type',
-        service_id=service_id,
-        changed_by_id=changed_by_id,
-        service_mode=service_mode,
-        broadcast_channel=broadcast_channel,
-        provider_restriction=provider_restriction
-    )
+def create_broadcast_account_type_change_event(**kwargs):
+    _send_event('change_broadcast_account_type', **kwargs)
 
 
-def create_suspend_service_event(
-    service_id,
-    suspended_by_id,
-):
-    _send_event(
-        'suspend_service',
-        service_id=service_id,
-        suspended_by_id=suspended_by_id,
-    )
+def create_suspend_service_event(**kwargs):
+    _send_event('suspend_service', **kwargs)
 
 
-def create_archive_service_event(
-    service_id,
-    archived_by_id,
-):
-    _send_event(
-        'archive_service',
-        service_id=service_id,
-        archived_by_id=archived_by_id,
-    )
+def create_archive_service_event(**kwargs):
+    _send_event('archive_service', **kwargs)
 
 
 def _send_event(event_type, **kwargs):
+    expected_keys = EVENT_SCHEMAS[event_type]
+    actual_keys = set(kwargs.keys())
+
+    if expected_keys != actual_keys:
+        raise ValueError(f'Expected {expected_keys}, but got {actual_keys}')
+
     event_data = _construct_event_data(request)
     event_data.update(kwargs)
 

app/main/views/find_users.py

@@ -44,7 +44,7 @@ def archive_user(user_id):
                 flash('User can’t be removed from a service - '
                       'check all services have another team member with manage_settings')
                 return redirect(url_for('main.user_information', user_id=user_id))
-        create_archive_user_event(str(user_id), current_user.id)
+        create_archive_user_event(user_id=str(user_id), archived_by_id=current_user.id)
 
         return redirect(url_for('.user_information', user_id=user_id))
     else:

app/main/views/manage_users.py

@@ -173,7 +173,11 @@ def remove_user_from_service(service_id, user_id):
         else:
             abort(500, e)
     else:
-        create_remove_user_from_service_event(user_id=user_id, removed_by_id=current_user.id, service_id=service_id)
+        create_remove_user_from_service_event(
+            user_id=user_id,
+            removed_by_id=current_user.id,
+            service_id=service_id
+        )
 
     return redirect(url_for(
         '.manage_users',
@@ -228,7 +232,12 @@ def confirm_edit_user_email(service_id, user_id):
         except HTTPError as e:
             abort(500, e)
         else:
-            create_email_change_event(user.id, current_user.id, user.email_address, new_email)
+            create_email_change_event(
+                user_id=user.id,
+                updated_by_id=current_user.id,
+                original_email_address=user.email_address,
+                new_email_address=new_email
+            )
         finally:
             session.pop(session_key, None)
 
@@ -286,7 +295,12 @@ def confirm_edit_user_mobile_number(service_id, user_id):
         except HTTPError as e:
             abort(500, e)
         else:
-            create_mobile_number_change_event(user.id, current_user.id, user.mobile_number, new_number)
+            create_mobile_number_change_event(
+                user_id=user.id,
+                updated_by_id=current_user.id,
+                original_mobile_number=user.mobile_number,
+                new_mobile_number=new_number
+            )
         finally:
             session.pop('team_member_mobile_change', None)
 

app/main/views/service_settings.py

@@ -429,7 +429,7 @@ def archive_service(service_id):
         cached_service_user_ids = [user.id for user in current_service.active_users]
 
         service_api_client.archive_service(service_id, cached_service_user_ids)
-        create_archive_service_event(service_id, archived_by_id=current_user.id)
+        create_archive_service_event(service_id=service_id, archived_by_id=current_user.id)
 
         flash(
             '‘{}’ was deleted'.format(current_service.name),
@@ -449,7 +449,7 @@ def archive_service(service_id):
 def suspend_service(service_id):
     if request.method == 'POST':
         service_api_client.suspend_service(service_id)
-        create_suspend_service_event(service_id, suspended_by_id=current_user.id)
+        create_suspend_service_event(service_id=service_id, suspended_by_id=current_user.id)
         return redirect(url_for('.service_settings', service_id=service_id))
     else:
         flash("This will suspend the service and revoke all api keys. Are you sure you want to suspend this service?",