synapse-product/synapse/federation/transport/client.py

999 lines
31 KiB
Python
Raw Normal View History

# -*- coding: utf-8 -*-
2016-01-06 23:26:29 -05:00
# Copyright 2014-2016 OpenMarket Ltd
# Copyright 2018 New Vector Ltd
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
2018-07-09 02:09:20 -04:00
import logging
2018-09-12 09:23:32 -04:00
from six.moves import urllib
2018-07-09 02:09:20 -04:00
from twisted.internet import defer
2018-07-09 02:09:20 -04:00
from synapse.api.constants import Membership
from synapse.api.urls import (
FEDERATION_UNSTABLE_PREFIX,
FEDERATION_V1_PREFIX,
FEDERATION_V2_PREFIX,
)
from synapse.logging.utils import log_function
logger = logging.getLogger(__name__)
class TransportLayerClient(object):
"""Sends federation HTTP requests to other servers"""
2016-01-26 08:52:29 -05:00
def __init__(self, hs):
self.server_name = hs.hostname
self.client = hs.get_http_client()
@log_function
def get_room_state(self, destination, room_id, event_id):
""" Requests all state for a given room from the given server at the
given event.
Args:
destination (str): The host name of the remote home server we want
to get the state from.
context (str): The name of the context we want the state of
event_id (str): The event we want the context at.
Returns:
Deferred: Results in a dict received from the remote homeserver.
"""
2019-06-20 05:32:02 -04:00
logger.debug("get_room_state dest=%s, room=%s", destination, room_id)
path = _create_v1_path("/state/%s", room_id)
return self.client.get_json(
2019-06-20 05:32:02 -04:00
destination,
path=path,
args={"event_id": event_id},
try_trailing_slash_on_400=True,
)
@log_function
def get_room_state_ids(self, destination, room_id, event_id):
""" Requests all state for a given room from the given server at the
given event. Returns the state's event_id's
Args:
destination (str): The host name of the remote home server we want
to get the state from.
context (str): The name of the context we want the state of
event_id (str): The event we want the context at.
Returns:
Deferred: Results in a dict received from the remote homeserver.
"""
2019-06-20 05:32:02 -04:00
logger.debug("get_room_state_ids dest=%s, room=%s", destination, room_id)
path = _create_v1_path("/state_ids/%s", room_id)
return self.client.get_json(
2019-06-20 05:32:02 -04:00
destination,
path=path,
args={"event_id": event_id},
try_trailing_slash_on_400=True,
)
@log_function
2015-05-19 09:53:32 -04:00
def get_event(self, destination, event_id, timeout=None):
""" Requests the pdu with give id and origin from the given server.
Args:
destination (str): The host name of the remote home server we want
to get the state from.
event_id (str): The id of the event being requested.
2015-05-22 10:18:04 -04:00
timeout (int): How long to try (in ms) the destination for before
giving up. None indicates no timeout.
Returns:
Deferred: Results in a dict received from the remote homeserver.
"""
2019-06-20 05:32:02 -04:00
logger.debug("get_pdu dest=%s, event_id=%s", destination, event_id)
path = _create_v1_path("/event/%s", event_id)
return self.client.get_json(
2019-06-20 05:32:02 -04:00
destination, path=path, timeout=timeout, try_trailing_slash_on_400=True
2019-03-08 13:25:59 -05:00
)
@log_function
def backfill(self, destination, room_id, event_tuples, limit):
""" Requests `limit` previous PDUs in a given context before list of
PDUs.
Args:
dest (str)
room_id (str)
event_tuples (list)
2018-07-31 18:29:09 -04:00
limit (int)
Returns:
Deferred: Results in a dict received from the remote homeserver.
"""
logger.debug(
"backfill dest=%s, room_id=%s, event_tuples=%r, limit=%s",
2019-06-20 05:32:02 -04:00
destination,
room_id,
event_tuples,
2019-06-20 05:32:02 -04:00
str(limit),
)
if not event_tuples:
# TODO: raise?
return
path = _create_v1_path("/backfill/%s", room_id)
2019-06-20 05:32:02 -04:00
args = {"v": event_tuples, "limit": [str(limit)]}
return self.client.get_json(
2019-06-20 05:32:02 -04:00
destination, path=path, args=args, try_trailing_slash_on_400=True
)
@defer.inlineCallbacks
@log_function
def send_transaction(self, transaction, json_data_callback=None):
""" Sends the given Transaction to its destination
Args:
transaction (Transaction)
Returns:
Deferred: Succeeds when we get a 2xx HTTP response. The result
will be the decoded JSON body.
Fails with ``HTTPRequestException`` if we get an HTTP response
code >= 300.
Fails with ``NotRetryingDestination`` if we are not yet ready
to retry this server.
Fails with ``FederationDeniedError`` if this destination
is not on our federation whitelist
"""
logger.debug(
"send_data dest=%s, txid=%s",
2019-06-20 05:32:02 -04:00
transaction.destination,
transaction.transaction_id,
)
if transaction.destination == self.server_name:
raise RuntimeError("Transport layer cannot send to itself!")
# FIXME: This is only used by the tests. The actual json sent is
# generated by the json_data_callback.
json_data = transaction.get_dict()
path = _create_v1_path("/send/%s", transaction.transaction_id)
response = yield self.client.put_json(
transaction.destination,
path=path,
data=json_data,
json_data_callback=json_data_callback,
long_retries=True,
backoff_on_404=True, # If we get a 404 the other side has gone
try_trailing_slash_on_400=True,
)
return response
@defer.inlineCallbacks
@log_function
2019-06-20 05:32:02 -04:00
def make_query(
self, destination, query_type, args, retry_on_dns_fail, ignore_backoff=False
):
path = _create_v1_path("/query/%s", query_type)
content = yield self.client.get_json(
destination=destination,
path=path,
args=args,
retry_on_dns_fail=retry_on_dns_fail,
2016-03-04 09:29:58 -05:00
timeout=10000,
ignore_backoff=ignore_backoff,
)
return content
@defer.inlineCallbacks
@log_function
def make_membership_event(self, destination, room_id, user_id, membership, params):
"""Asks a remote server to build and sign us a membership event
Note that this does not append any events to any graphs.
Args:
destination (str): address of remote homeserver
room_id (str): room to join/leave
user_id (str): user to be joined/left
membership (str): one of join/leave
params (dict[str, str|Iterable[str]]): Query parameters to include in the
request.
Returns:
Deferred: Succeeds when we get a 2xx HTTP response. The result
will be the decoded JSON body (ie, the new event).
Fails with ``HTTPRequestException`` if we get an HTTP response
code >= 300.
Fails with ``NotRetryingDestination`` if we are not yet ready
to retry this server.
Fails with ``FederationDeniedError`` if the remote destination
is not in our federation whitelist
"""
valid_memberships = {Membership.JOIN, Membership.LEAVE}
if membership not in valid_memberships:
raise RuntimeError(
2019-06-20 05:32:02 -04:00
"make_membership_event called with membership='%s', must be one of %s"
% (membership, ",".join(valid_memberships))
)
path = _create_v1_path("/make_%s/%s/%s", membership, room_id, user_id)
ignore_backoff = False
retry_on_dns_fail = False
if membership == Membership.LEAVE:
# we particularly want to do our best to send leave events. The
# problem is that if it fails, we won't retry it later, so if the
# remote server was just having a momentary blip, the room will be
# out of sync.
ignore_backoff = True
retry_on_dns_fail = True
content = yield self.client.get_json(
destination=destination,
path=path,
args=params,
retry_on_dns_fail=retry_on_dns_fail,
timeout=20000,
ignore_backoff=ignore_backoff,
)
return content
@defer.inlineCallbacks
@log_function
def send_join(self, destination, room_id, event_id, content):
path = _create_v1_path("/send_join/%s/%s", room_id, event_id)
response = yield self.client.put_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content
)
return response
@defer.inlineCallbacks
@log_function
def send_leave(self, destination, room_id, event_id, content):
path = _create_v1_path("/send_leave/%s/%s", room_id, event_id)
response = yield self.client.put_json(
destination=destination,
path=path,
data=content,
# we want to do our best to send this through. The problem is
# that if it fails, we won't retry it later, so if the remote
# server was just having a momentary blip, the room will be out of
# sync.
ignore_backoff=True,
)
return response
@defer.inlineCallbacks
@log_function
def send_invite_v1(self, destination, room_id, event_id, content):
path = _create_v1_path("/invite/%s/%s", room_id, event_id)
response = yield self.client.put_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
)
return response
@defer.inlineCallbacks
@log_function
def send_invite_v2(self, destination, room_id, event_id, content):
path = _create_v2_path("/invite/%s/%s", room_id, event_id)
response = yield self.client.put_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
)
return response
@defer.inlineCallbacks
@log_function
2019-06-20 05:32:02 -04:00
def get_public_rooms(
self,
remote_server,
limit,
since_token,
search_filter=None,
include_all_networks=False,
third_party_instance_id=None,
):
if search_filter:
# this uses MSC2197 (Search Filtering over Federation)
path = _create_v1_path("/publicRooms")
data = {"include_all_networks": "true" if include_all_networks else "false"}
if third_party_instance_id:
data["third_party_instance_id"] = third_party_instance_id
if limit:
data["limit"] = str(limit)
if since_token:
data["since"] = since_token
data["filter"] = search_filter
response = yield self.client.post_json(
destination=remote_server, path=path, data=data, ignore_backoff=True
)
else:
path = _create_v1_path("/publicRooms")
args = {"include_all_networks": "true" if include_all_networks else "false"}
if third_party_instance_id:
args["third_party_instance_id"] = (third_party_instance_id,)
if limit:
args["limit"] = [str(limit)]
if since_token:
args["since"] = [since_token]
response = yield self.client.get_json(
destination=remote_server, path=path, args=args, ignore_backoff=True
)
return response
@defer.inlineCallbacks
@log_function
def exchange_third_party_invite(self, destination, room_id, event_dict):
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/exchange_third_party_invite/%s", room_id)
response = yield self.client.put_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=event_dict
)
return response
@defer.inlineCallbacks
@log_function
def get_event_auth(self, destination, room_id, event_id):
path = _create_v1_path("/event_auth/%s/%s", room_id, event_id)
2019-06-20 05:32:02 -04:00
content = yield self.client.get_json(destination=destination, path=path)
return content
@defer.inlineCallbacks
@log_function
def query_client_keys(self, destination, query_content, timeout):
"""Query the device keys for a list of user ids hosted on a remote
server.
Request:
{
"device_keys": {
"<user_id>": ["<device_id>"]
} }
Response:
{
"device_keys": {
"<user_id>": {
"<device_id>": {...}
} } }
Args:
destination(str): The server to query.
query_content(dict): The user ids to query.
Returns:
A dict containg the device keys.
"""
path = _create_v1_path("/user/keys/query")
content = yield self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=query_content, timeout=timeout
)
return content
@defer.inlineCallbacks
@log_function
def query_user_devices(self, destination, user_id, timeout):
"""Query the devices for a user id hosted on a remote server.
Response:
{
"stream_id": "...",
"devices": [ { ... } ]
}
Args:
destination(str): The server to query.
query_content(dict): The user ids to query.
Returns:
A dict containg the device keys.
"""
path = _create_v1_path("/user/devices/%s", user_id)
content = yield self.client.get_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, timeout=timeout
)
return content
@defer.inlineCallbacks
@log_function
def claim_client_keys(self, destination, query_content, timeout):
"""Claim one-time keys for a list of devices hosted on a remote server.
Request:
{
"one_time_keys": {
"<user_id>": {
"<device_id>": "<algorithm>"
} } }
Response:
{
"device_keys": {
"<user_id>": {
"<device_id>": {
"<algorithm>:<key_id>": "<key_base64>"
} } } }
Args:
destination(str): The server to query.
query_content(dict): The user ids to query.
Returns:
A dict containg the one-time keys.
"""
path = _create_v1_path("/user/keys/claim")
content = yield self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=query_content, timeout=timeout
)
return content
@defer.inlineCallbacks
@log_function
2019-06-20 05:32:02 -04:00
def get_missing_events(
self,
destination,
room_id,
earliest_events,
latest_events,
limit,
min_depth,
timeout,
):
path = _create_v1_path("/get_missing_events/%s", room_id)
content = yield self.client.post_json(
destination=destination,
path=path,
data={
"limit": int(limit),
"min_depth": int(min_depth),
"earliest_events": earliest_events,
"latest_events": latest_events,
},
timeout=timeout,
)
return content
2017-07-10 10:44:15 -04:00
2017-07-10 09:52:27 -04:00
@log_function
def get_group_profile(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get a group profile
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/profile", group_id)
2017-07-10 09:52:27 -04:00
2017-07-18 09:37:06 -04:00
return self.client.get_json(
2017-07-10 09:52:27 -04:00
destination=destination,
path=path,
2017-07-18 09:37:06 -04:00
args={"requester_user_id": requester_user_id},
2017-07-10 09:52:27 -04:00
ignore_backoff=True,
)
@log_function
def update_group_profile(self, destination, group_id, requester_user_id, content):
"""Update a remote group profile
Args:
destination (str)
group_id (str)
requester_user_id (str)
content (dict): The new profile of the group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/profile", group_id)
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
2017-07-10 09:52:27 -04:00
@log_function
def get_group_summary(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get a group summary
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/summary", group_id)
2017-07-10 09:52:27 -04:00
2017-07-18 09:37:06 -04:00
return self.client.get_json(
2017-07-10 09:52:27 -04:00
destination=destination,
path=path,
2017-07-18 09:37:06 -04:00
args={"requester_user_id": requester_user_id},
2017-07-10 09:52:27 -04:00
ignore_backoff=True,
)
@log_function
2017-07-18 11:38:54 -04:00
def get_rooms_in_group(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get all rooms in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/rooms", group_id)
2017-07-10 09:52:27 -04:00
2017-07-18 09:37:06 -04:00
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
2019-06-20 05:32:02 -04:00
def add_room_to_group(
self, destination, group_id, requester_user_id, room_id, content
):
"""Add a room to a group
2017-07-18 12:19:39 -04:00
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/room/%s", group_id, room_id)
2017-07-18 09:37:06 -04:00
2017-07-10 09:52:27 -04:00
return self.client.post_json(
destination=destination,
path=path,
2017-07-18 09:37:06 -04:00
args={"requester_user_id": requester_user_id},
data=content,
2017-07-10 09:52:27 -04:00
ignore_backoff=True,
)
2019-06-20 05:32:02 -04:00
def update_room_in_group(
self, destination, group_id, requester_user_id, room_id, config_key, content
):
"""Update room in group
"""
path = _create_v1_path(
2019-06-20 05:32:02 -04:00
"/groups/%s/room/%s/config/%s", group_id, room_id, config_key
)
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
def remove_room_from_group(self, destination, group_id, requester_user_id, room_id):
2017-09-26 10:52:41 -04:00
"""Remove a room from a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/room/%s", group_id, room_id)
2017-09-26 10:52:41 -04:00
return self.client.delete_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
2017-07-10 09:52:27 -04:00
@log_function
2017-07-18 11:38:54 -04:00
def get_users_in_group(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get users in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/users", group_id)
2017-07-10 09:52:27 -04:00
2017-07-18 09:37:06 -04:00
return self.client.get_json(
2017-07-10 09:52:27 -04:00
destination=destination,
path=path,
2017-07-18 09:37:06 -04:00
args={"requester_user_id": requester_user_id},
2017-07-10 09:52:27 -04:00
ignore_backoff=True,
)
@log_function
def get_invited_users_in_group(self, destination, group_id, requester_user_id):
"""Get users that have been invited to a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/invited_users", group_id)
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
2017-07-10 09:52:27 -04:00
@log_function
def accept_group_invite(self, destination, group_id, user_id, content):
2017-07-18 12:19:39 -04:00
"""Accept a group invite
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/users/%s/accept_invite", group_id, user_id)
2017-07-10 09:52:27 -04:00
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2017-07-10 09:52:27 -04:00
)
2018-03-28 12:18:02 -04:00
@log_function
def join_group(self, destination, group_id, user_id, content):
"""Attempts to join a group
"""
path = _create_v1_path("/groups/%s/users/%s/join", group_id, user_id)
2018-03-28 12:18:02 -04:00
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2018-03-28 12:18:02 -04:00
)
2017-07-10 09:52:27 -04:00
@log_function
2019-06-20 05:32:02 -04:00
def invite_to_group(
self, destination, group_id, user_id, requester_user_id, content
):
2017-07-18 12:19:39 -04:00
"""Invite a user to a group
"""
path = _create_v1_path("/groups/%s/users/%s/invite", group_id, user_id)
2017-07-10 09:52:27 -04:00
return self.client.post_json(
destination=destination,
path=path,
2017-10-11 09:44:51 -04:00
args={"requester_user_id": requester_user_id},
2017-07-10 09:52:27 -04:00
data=content,
ignore_backoff=True,
)
2017-07-10 10:44:15 -04:00
@log_function
def invite_to_group_notification(self, destination, group_id, user_id, content):
2017-07-11 06:52:03 -04:00
"""Sent by group server to inform a user's server that they have been
invited.
"""
path = _create_v1_path("/groups/local/%s/users/%s/invite", group_id, user_id)
2017-07-10 10:44:15 -04:00
2017-07-10 09:52:27 -04:00
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2017-07-10 09:52:27 -04:00
)
@log_function
2019-06-20 05:32:02 -04:00
def remove_user_from_group(
self, destination, group_id, requester_user_id, user_id, content
):
2017-07-18 12:19:39 -04:00
"""Remove a user fron a group
"""
path = _create_v1_path("/groups/%s/users/%s/remove", group_id, user_id)
2017-07-10 09:52:27 -04:00
2017-07-10 10:44:15 -04:00
return self.client.post_json(
destination=destination,
path=path,
2017-07-18 09:37:06 -04:00
args={"requester_user_id": requester_user_id},
2017-07-10 10:44:15 -04:00
data=content,
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def remove_user_from_group_notification(
self, destination, group_id, user_id, content
):
2017-07-11 06:52:03 -04:00
"""Sent by group server to inform a user's server that they have been
kicked from the group.
"""
path = _create_v1_path("/groups/local/%s/users/%s/remove", group_id, user_id)
2017-07-10 10:44:15 -04:00
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2017-07-10 10:44:15 -04:00
)
@log_function
def renew_group_attestation(self, destination, group_id, user_id, content):
2017-07-11 06:52:03 -04:00
"""Sent by either a group server or a user's server to periodically update
the attestations
"""
path = _create_v1_path("/groups/%s/renew_attestation/%s", group_id, user_id)
2017-07-10 10:44:15 -04:00
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2017-07-10 10:44:15 -04:00
)
2017-07-18 09:37:06 -04:00
@log_function
2019-06-20 05:32:02 -04:00
def update_group_summary_room(
self, destination, group_id, user_id, room_id, category_id, content
):
2017-07-18 12:19:39 -04:00
"""Update a room entry in a group summary
"""
2017-07-18 09:37:06 -04:00
if category_id:
path = _create_v1_path(
"/groups/%s/summary/categories/%s/rooms/%s",
2019-06-20 05:32:02 -04:00
group_id,
category_id,
room_id,
2017-07-18 09:37:06 -04:00
)
else:
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/summary/rooms/%s", group_id, room_id)
2017-07-18 09:37:06 -04:00
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": user_id},
data=content,
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def delete_group_summary_room(
self, destination, group_id, user_id, room_id, category_id
):
2017-07-18 12:19:39 -04:00
"""Delete a room entry in a group summary
"""
2017-07-18 09:37:06 -04:00
if category_id:
path = _create_v1_path(
"/groups/%s/summary/categories/%s/rooms/%s",
2019-06-20 05:32:02 -04:00
group_id,
category_id,
room_id,
2017-07-18 09:37:06 -04:00
)
else:
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/summary/rooms/%s", group_id, room_id)
2017-07-18 09:37:06 -04:00
return self.client.delete_json(
destination=destination,
path=path,
args={"requester_user_id": user_id},
ignore_backoff=True,
)
@log_function
def get_group_categories(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get all categories in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/categories", group_id)
2017-07-18 09:37:06 -04:00
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
def get_group_category(self, destination, group_id, requester_user_id, category_id):
2017-07-18 12:19:39 -04:00
"""Get category info in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/categories/%s", group_id, category_id)
2017-07-18 09:37:06 -04:00
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def update_group_category(
self, destination, group_id, requester_user_id, category_id, content
):
2017-07-18 12:19:39 -04:00
"""Update a category in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/categories/%s", group_id, category_id)
2017-07-18 09:37:06 -04:00
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def delete_group_category(
self, destination, group_id, requester_user_id, category_id
):
2017-07-18 12:19:39 -04:00
"""Delete a category in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/categories/%s", group_id, category_id)
2017-07-18 09:37:06 -04:00
return self.client.delete_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
def get_group_roles(self, destination, group_id, requester_user_id):
2017-07-18 12:19:39 -04:00
"""Get all roles in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/roles", group_id)
2017-07-18 09:37:06 -04:00
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
def get_group_role(self, destination, group_id, requester_user_id, role_id):
2017-07-18 12:19:39 -04:00
"""Get a roles info
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/roles/%s", group_id, role_id)
2017-07-18 09:37:06 -04:00
return self.client.get_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def update_group_role(
self, destination, group_id, requester_user_id, role_id, content
):
2017-07-18 12:19:39 -04:00
"""Update a role in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/roles/%s", group_id, role_id)
2017-07-18 09:37:06 -04:00
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
@log_function
def delete_group_role(self, destination, group_id, requester_user_id, role_id):
2017-07-18 12:19:39 -04:00
"""Delete a role in a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/roles/%s", group_id, role_id)
2017-07-18 09:37:06 -04:00
return self.client.delete_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def update_group_summary_user(
self, destination, group_id, requester_user_id, user_id, role_id, content
):
2017-07-18 12:19:39 -04:00
"""Update a users entry in a group
"""
2017-07-18 09:37:06 -04:00
if role_id:
path = _create_v1_path(
2019-06-20 05:32:02 -04:00
"/groups/%s/summary/roles/%s/users/%s", group_id, role_id, user_id
2017-07-18 09:37:06 -04:00
)
else:
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/summary/users/%s", group_id, user_id)
2017-07-18 09:37:06 -04:00
return self.client.post_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
@log_function
2019-06-20 05:32:02 -04:00
def set_group_join_policy(self, destination, group_id, requester_user_id, content):
"""Sets the join policy for a group
"""
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/settings/m.join_policy", group_id)
return self.client.put_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
data=content,
ignore_backoff=True,
)
2017-07-18 09:37:06 -04:00
@log_function
2019-06-20 05:32:02 -04:00
def delete_group_summary_user(
self, destination, group_id, requester_user_id, user_id, role_id
):
2017-07-18 12:19:39 -04:00
"""Delete a users entry in a group
"""
2017-07-18 09:37:06 -04:00
if role_id:
path = _create_v1_path(
2019-06-20 05:32:02 -04:00
"/groups/%s/summary/roles/%s/users/%s", group_id, role_id, user_id
2017-07-18 09:37:06 -04:00
)
else:
2019-06-20 05:32:02 -04:00
path = _create_v1_path("/groups/%s/summary/users/%s", group_id, user_id)
2017-07-18 09:37:06 -04:00
return self.client.delete_json(
destination=destination,
path=path,
args={"requester_user_id": requester_user_id},
ignore_backoff=True,
)
2017-08-09 08:36:22 -04:00
def bulk_get_publicised_groups(self, destination, user_ids):
"""Get the groups a list of users are publicising
"""
path = _create_v1_path("/get_groups_publicised")
2017-08-09 08:36:22 -04:00
content = {"user_ids": user_ids}
return self.client.post_json(
2019-06-20 05:32:02 -04:00
destination=destination, path=path, data=content, ignore_backoff=True
2017-08-09 08:36:22 -04:00
)
def get_room_complexity(self, destination, room_id):
"""
Args:
destination (str): The remote server
room_id (str): The room ID to ask about.
"""
path = _create_path(FEDERATION_UNSTABLE_PREFIX, "/rooms/%s/complexity", room_id)
return self.client.get_json(destination=destination, path=path)
def _create_path(federation_prefix, path, *args):
"""
Ensures that all args are url encoded.
"""
return federation_prefix + path % tuple(urllib.parse.quote(arg, "") for arg in args)
def _create_v1_path(path, *args):
"""Creates a path against V1 federation API from the path template and
args. Ensures that all args are url encoded.
Example:
_create_v1_path("/event/%s", event_id)
Args:
path (str): String template for the path
args: ([str]): Args to insert into path. Each arg will be url encoded
Returns:
str
"""
return _create_path(FEDERATION_V1_PREFIX, path, *args)
def _create_v2_path(path, *args):
"""Creates a path against V2 federation API from the path template and
args. Ensures that all args are url encoded.
Example:
_create_v2_path("/event/%s", event_id)
Args:
path (str): String template for the path
args: ([str]): Args to insert into path. Each arg will be url encoded
Returns:
str
"""
return _create_path(FEDERATION_V2_PREFIX, path, *args)