DOCS: Added in-code documentation.

src/linkahead/common/models.py

@@ -3130,19 +3130,19 @@ def _basic_sync(e_local, e_remote):
 
 
 def _deletion_sync(e_local, e_remote):
+    """Synchronization if ``e_remote`` has been deleted.
+
+    Also sets is_valid and is_deleted on ``e_local``.
+    """
     if e_local is None or e_remote is None:
         return
 
-    try:
-        msg = e_remote.get_messages().get("Info", 10, exact=True)  # try and get the deletion info
-        if msg is None:
+    # For message codes, see org.caosdb.server.entity.Message.java:
+    # ENTITY_HAS_BEEN_DELETED_SUCCESSFULLY = "10"
+    msg = e_remote.get_messages().get("Info", 10, exact=True)  # Try and get the deletion info.
+    if msg is None:             # Deletion info wasn't there, do not sync.
         e_local.messages = e_remote.messages
         return
-    except KeyError:
-        # deletion info wasn't there
-        e_local.messages = e_remote.messages
-
-        return
 
     _basic_sync(e_local, e_remote)
     e_local.is_valid = lambda: False