summary refs log tree commit diff
path: root/synapse/state.py
diff options
context:
space:
mode:
authorRichard van der Hoff <richard@matrix.org>2018-01-29 17:39:55 +0000
committerRichard van der Hoff <richard@matrix.org>2018-01-29 17:39:55 +0000
commitadfc0c95391bf43d48f7069823fc0f4902803402 (patch)
treeb54b8bd50e4f733a358790fbe65fdba16199092c /synapse/state.py
parentRemove unused "event_type" param on state.get_current_state_ids (diff)
downloadsynapse-adfc0c95391bf43d48f7069823fc0f4902803402.tar.xz
docstring for get_current_state_ids
Diffstat (limited to 'synapse/state.py')
-rw-r--r--synapse/state.py13
1 files changed, 13 insertions, 0 deletions
diff --git a/synapse/state.py b/synapse/state.py
index 18f1edef42..4c8247e7c2 100644
--- a/synapse/state.py
+++ b/synapse/state.py
@@ -147,6 +147,19 @@ class StateHandler(object):
 
     @defer.inlineCallbacks
     def get_current_state_ids(self, room_id, latest_event_ids=None):
+        """Get the current state, or the state at a set of events, for a room
+
+        Args:
+            room_id (str):
+
+            latest_event_ids (iterable[str]|None): if given, the forward
+                extremities to resolve. If None, we look them up from the
+                database (via a cache)
+
+        Returns:
+            Deferred[dict[(str, str), str)]]: the state dict, mapping from
+                (event_type, state_key) -> event_id
+        """
         if not latest_event_ids:
             latest_event_ids = yield self.store.get_latest_event_ids_in_room(room_id)