Adds a builder method to the notification object.

This is used to construct a notification from the sorts of data an API call provides. This is used in both the db-email / db-sms tasks and the notifications rest endpoint to construct the notification DB object.

tests/app/test_model.py

@@ -0,0 +1,72 @@
+from datetime import datetime
+
+from app import DATETIME_FORMAT
+from app.models import Notification
+
+
+def test_should_build_notification_from_minimal_set_of_api_derived_params(notify_api):
+    now = datetime.utcnow()
+
+    notification = {
+        'template': 'template',
+        'template_version': '1',
+        'to': 'someone',
+        'personalisation': {}
+    }
+    notification = Notification.from_api_request(
+        created_at=now.strftime(DATETIME_FORMAT),
+        notification=notification,
+        notification_id="notification_id",
+        service_id="service_id",
+        notification_type='SMS',
+        api_key_id='api_key_id',
+        key_type='key_type'
+    )
+    assert notification.created_at == now
+    assert notification.id == "notification_id"
+    assert notification.template_id == 'template'
+    assert notification.template_version == '1'
+    assert not notification.job_row_number
+    assert not notification.job_id
+    assert notification.to == 'someone'
+    assert notification.service_id == 'service_id'
+    assert notification.status == 'created'
+    assert not notification.personalisation
+    assert notification.notification_type == 'SMS'
+    assert notification.api_key_id == 'api_key_id'
+    assert notification.key_type == 'key_type'
+
+
+def test_should_build_notification_from_full_set_of_api_derived_params(notify_api):
+    now = datetime.utcnow()
+
+    notification = {
+        'template': 'template',
+        'template_version': '1',
+        'to': 'someone',
+        'personalisation': {'key': 'value'},
+        'job': 'job_id',
+        'row_number': 100
+    }
+    notification = Notification.from_api_request(
+        created_at=now.strftime(DATETIME_FORMAT),
+        notification=notification,
+        notification_id="notification_id",
+        service_id="service_id",
+        notification_type='SMS',
+        api_key_id='api_key_id',
+        key_type='key_type'
+    )
+    assert notification.created_at == now
+    assert notification.id == "notification_id"
+    assert notification.template_id == 'template'
+    assert notification.template_version == '1'
+    assert notification.job_row_number == 100
+    assert notification.job_id == 'job_id'
+    assert notification.to == 'someone'
+    assert notification.service_id == 'service_id'
+    assert notification.status == 'created'
+    assert notification.personalisation == {'key': 'value'}
+    assert notification.notification_type == 'SMS'
+    assert notification.api_key_id == 'api_key_id'
+    assert notification.key_type == 'key_type'