summary refs log tree commit diff
path: root/synapse/federation/transport
diff options
context:
space:
mode:
authorJason Robinson <jasonr@matrix.org>2019-01-22 11:00:17 +0200
committerJason Robinson <jasonr@matrix.org>2019-01-23 10:32:41 +0200
commitd39b7b6d38b0d9876ad305491ea05af92ea35b04 (patch)
tree9a15c72080049c50b3768369b9abd653530d0566 /synapse/federation/transport
parentAdd changelog for openid resource addition (diff)
downloadsynapse-d39b7b6d38b0d9876ad305491ea05af92ea35b04.tar.xz
Document `servlet_groups` parameters
Signed-off-by: Jason Robinson <jasonr@matrix.org>
Diffstat (limited to 'synapse/federation/transport')
-rw-r--r--synapse/federation/transport/server.py23
1 files changed, 23 insertions, 0 deletions
diff --git a/synapse/federation/transport/server.py b/synapse/federation/transport/server.py
index 49b80beecb..9c1c9c39e1 100644
--- a/synapse/federation/transport/server.py
+++ b/synapse/federation/transport/server.py
@@ -44,6 +44,16 @@ class TransportLayerServer(JsonResource):
     """Handles incoming federation HTTP requests"""
 
     def __init__(self, hs, servlet_groups=None):
+        """Initialize the TransportLayerServer
+
+        Will by default register all servlets. For custom behaviour, pass in
+        a list of servlet_groups to register.
+
+        Args:
+            hs (synapse.server.HomeServer): homeserver
+            servlet_groups (list[str], optional): List of servlet groups to register.
+                Defaults to ``DEFAULT_SERVLET_GROUPS``.
+        """
         self.hs = hs
         self.clock = hs.get_clock()
         self.servlet_groups = servlet_groups
@@ -1365,6 +1375,19 @@ DEFAULT_SERVLET_GROUPS = (
 
 
 def register_servlets(hs, resource, authenticator, ratelimiter, servlet_groups=None):
+    """Initialize and register servlet classes.
+
+    Will by default register all servlets. For custom behaviour, pass in
+    a list of servlet_groups to register.
+
+    Args:
+        hs (synapse.server.HomeServer): homeserver
+        resource (TransportLayerServer): resource class to register to
+        authenticator (Authenticator): authenticator to use
+        ratelimiter (util.ratelimitutils.FederationRateLimiter): ratelimiter to use
+        servlet_groups (list[str], optional): List of servlet groups to register.
+            Defaults to ``DEFAULT_SERVLET_GROUPS``.
+    """
     if not servlet_groups:
         servlet_groups = DEFAULT_SERVLET_GROUPS