implement clearing identities

gratipay/models/participant/mixins/identity.py

@@ -221,6 +221,30 @@ def set_identity_verification(self, country_id, is_verified):
             add_event(cursor, 'participant', payload)
 
 
+    def clear_identity(self, country_id):
+        """Clear the participant's national identity record for a given country.
+
+        :param int country_id: an ``id`` from the ``countries`` table
+
+        """
+        with self.db.get_cursor() as cursor:
+            identity_id = cursor.one("""
+
+                DELETE
+                  FROM participant_identities
+                 WHERE participant_id=%(participant_id)s
+                   AND country_id=%(country_id)s
+             RETURNING id
+
+            """, dict(locals(), participant_id=self.id))
+            payload = dict( id=self.id
+                          , identity_id=identity_id
+                          , country_id=country_id
+                          , action='clear identity'
+                           )
+            add_event(cursor, 'participant', payload)
+
+
 # Rekeying
 # ========
 

tests/py/test_participant_identities.py

@@ -225,6 +225,31 @@ def test_siv_still_logs_an_event_when_noop(self):
                            )
 
 
+    # ci - clear_identity
+
+    def test_ci_clears_identity(self):
+        self.crusher.store_identity_info(self.TT, 'nothing-enforced', {'name': 'Crusher'})
+        assert self.crusher.clear_identity(self.TT) is None
+        assert self.crusher.list_identity_metadata() == []
+
+    def test_ci_is_a_noop_when_there_is_no_identity(self):
+        assert self.crusher.clear_identity(self.TT) is None
+        assert self.crusher.list_identity_metadata() == []
+
+    def test_ci_logs_an_event(self):
+        iid = self.crusher.store_identity_info(self.TT, 'nothing-enforced', {'name': 'Crusher'})
+        self.crusher.clear_identity(self.TT)
+        self.assert_events( self.crusher.id
+                          , [iid, iid]
+                          , [self.TT, self.TT]
+                          , ['insert identity', 'clear identity']
+                           )
+
+    def test_ci_still_logs_an_event_when_noop(self):
+        self.crusher.clear_identity(self.TT)
+        self.assert_events(self.crusher.id, [None], [self.TT], ['clear identity'])
+
+
     # fine - fail_if_no_email
 
     def test_fine_fails_if_no_email(self):