mirror of
https://git.anonymousland.org/anonymousland/synapse-product.git
synced 2024-10-01 08:25:44 -04:00
Admin API for reported events (#8217)
Add an admin API to read entries of table `event_reports`. API: `GET /_synapse/admin/v1/event_reports`
This commit is contained in:
parent
b29a9bdaa9
commit
4da01f9c61
1
changelog.d/8217.feature
Normal file
1
changelog.d/8217.feature
Normal file
@ -0,0 +1 @@
|
|||||||
|
Add an admin API `GET /_synapse/admin/v1/event_reports` to read entries of table `event_reports`. Contributed by @dklimpel.
|
129
docs/admin_api/event_reports.rst
Normal file
129
docs/admin_api/event_reports.rst
Normal file
@ -0,0 +1,129 @@
|
|||||||
|
Show reported events
|
||||||
|
====================
|
||||||
|
|
||||||
|
This API returns information about reported events.
|
||||||
|
|
||||||
|
The api is::
|
||||||
|
|
||||||
|
GET /_synapse/admin/v1/event_reports?from=0&limit=10
|
||||||
|
|
||||||
|
To use it, you will need to authenticate by providing an ``access_token`` for a
|
||||||
|
server admin: see `README.rst <README.rst>`_.
|
||||||
|
|
||||||
|
It returns a JSON body like the following:
|
||||||
|
|
||||||
|
.. code:: jsonc
|
||||||
|
|
||||||
|
{
|
||||||
|
"event_reports": [
|
||||||
|
{
|
||||||
|
"content": {
|
||||||
|
"reason": "foo",
|
||||||
|
"score": -100
|
||||||
|
},
|
||||||
|
"event_id": "$bNUFCwGzWca1meCGkjp-zwslF-GfVcXukvRLI1_FaVY",
|
||||||
|
"event_json": {
|
||||||
|
"auth_events": [
|
||||||
|
"$YK4arsKKcc0LRoe700pS8DSjOvUT4NDv0HfInlMFw2M",
|
||||||
|
"$oggsNXxzPFRE3y53SUNd7nsj69-QzKv03a1RucHu-ws"
|
||||||
|
],
|
||||||
|
"content": {
|
||||||
|
"body": "matrix.org: This Week in Matrix",
|
||||||
|
"format": "org.matrix.custom.html",
|
||||||
|
"formatted_body": "<strong>matrix.org</strong>:<br><a href=\"https://matrix.org/blog/\"><strong>This Week in Matrix</strong></a>",
|
||||||
|
"msgtype": "m.notice"
|
||||||
|
},
|
||||||
|
"depth": 546,
|
||||||
|
"hashes": {
|
||||||
|
"sha256": "xK1//xnmvHJIOvbgXlkI8eEqdvoMmihVDJ9J4SNlsAw"
|
||||||
|
},
|
||||||
|
"origin": "matrix.org",
|
||||||
|
"origin_server_ts": 1592291711430,
|
||||||
|
"prev_events": [
|
||||||
|
"$YK4arsKKcc0LRoe700pS8DSjOvUT4NDv0HfInlMFw2M"
|
||||||
|
],
|
||||||
|
"prev_state": [],
|
||||||
|
"room_id": "!ERAgBpSOcCCuTJqQPk:matrix.org",
|
||||||
|
"sender": "@foobar:matrix.org",
|
||||||
|
"signatures": {
|
||||||
|
"matrix.org": {
|
||||||
|
"ed25519:a_JaEG": "cs+OUKW/iHx5pEidbWxh0UiNNHwe46Ai9LwNz+Ah16aWDNszVIe2gaAcVZfvNsBhakQTew51tlKmL2kspXk/Dg"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"type": "m.room.message",
|
||||||
|
"unsigned": {
|
||||||
|
"age_ts": 1592291711430,
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"id": 2,
|
||||||
|
"reason": "foo",
|
||||||
|
"received_ts": 1570897107409,
|
||||||
|
"room_alias": "#alias1:matrix.org",
|
||||||
|
"room_id": "!ERAgBpSOcCCuTJqQPk:matrix.org",
|
||||||
|
"sender": "@foobar:matrix.org",
|
||||||
|
"user_id": "@foo:matrix.org"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"content": {
|
||||||
|
"reason": "bar",
|
||||||
|
"score": -100
|
||||||
|
},
|
||||||
|
"event_id": "$3IcdZsDaN_En-S1DF4EMCy3v4gNRKeOJs8W5qTOKj4I",
|
||||||
|
"event_json": {
|
||||||
|
// hidden items
|
||||||
|
// see above
|
||||||
|
},
|
||||||
|
"id": 3,
|
||||||
|
"reason": "bar",
|
||||||
|
"received_ts": 1598889612059,
|
||||||
|
"room_alias": "#alias2:matrix.org",
|
||||||
|
"room_id": "!eGvUQuTCkHGVwNMOjv:matrix.org",
|
||||||
|
"sender": "@foobar:matrix.org",
|
||||||
|
"user_id": "@bar:matrix.org"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"next_token": 2,
|
||||||
|
"total": 4
|
||||||
|
}
|
||||||
|
|
||||||
|
To paginate, check for ``next_token`` and if present, call the endpoint again
|
||||||
|
with ``from`` set to the value of ``next_token``. This will return a new page.
|
||||||
|
|
||||||
|
If the endpoint does not return a ``next_token`` then there are no more
|
||||||
|
reports to paginate through.
|
||||||
|
|
||||||
|
**URL parameters:**
|
||||||
|
|
||||||
|
- ``limit``: integer - Is optional but is used for pagination,
|
||||||
|
denoting the maximum number of items to return in this call. Defaults to ``100``.
|
||||||
|
- ``from``: integer - Is optional but used for pagination,
|
||||||
|
denoting the offset in the returned results. This should be treated as an opaque value and
|
||||||
|
not explicitly set to anything other than the return value of ``next_token`` from a previous call.
|
||||||
|
Defaults to ``0``.
|
||||||
|
- ``dir``: string - Direction of event report order. Whether to fetch the most recent first (``b``) or the
|
||||||
|
oldest first (``f``). Defaults to ``b``.
|
||||||
|
- ``user_id``: string - Is optional and filters to only return users with user IDs that contain this value.
|
||||||
|
This is the user who reported the event and wrote the reason.
|
||||||
|
- ``room_id``: string - Is optional and filters to only return rooms with room IDs that contain this value.
|
||||||
|
|
||||||
|
**Response**
|
||||||
|
|
||||||
|
The following fields are returned in the JSON response body:
|
||||||
|
|
||||||
|
- ``id``: integer - ID of event report.
|
||||||
|
- ``received_ts``: integer - The timestamp (in milliseconds since the unix epoch) when this report was sent.
|
||||||
|
- ``room_id``: string - The ID of the room in which the event being reported is located.
|
||||||
|
- ``event_id``: string - The ID of the reported event.
|
||||||
|
- ``user_id``: string - This is the user who reported the event and wrote the reason.
|
||||||
|
- ``reason``: string - Comment made by the ``user_id`` in this report. May be blank.
|
||||||
|
- ``content``: object - Content of reported event.
|
||||||
|
|
||||||
|
- ``reason``: string - Comment made by the ``user_id`` in this report. May be blank.
|
||||||
|
- ``score``: integer - Content is reported based upon a negative score, where -100 is "most offensive" and 0 is "inoffensive".
|
||||||
|
|
||||||
|
- ``sender``: string - This is the ID of the user who sent the original message/event that was reported.
|
||||||
|
- ``room_alias``: string - The alias of the room. ``null`` if the room does not have a canonical alias set.
|
||||||
|
- ``event_json``: object - Details of the original event that was reported.
|
||||||
|
- ``next_token``: integer - Indication for pagination. See above.
|
||||||
|
- ``total``: integer - Total number of event reports related to the query (``user_id`` and ``room_id``).
|
||||||
|
|
@ -31,6 +31,7 @@ from synapse.rest.admin.devices import (
|
|||||||
DeviceRestServlet,
|
DeviceRestServlet,
|
||||||
DevicesRestServlet,
|
DevicesRestServlet,
|
||||||
)
|
)
|
||||||
|
from synapse.rest.admin.event_reports import EventReportsRestServlet
|
||||||
from synapse.rest.admin.groups import DeleteGroupAdminRestServlet
|
from synapse.rest.admin.groups import DeleteGroupAdminRestServlet
|
||||||
from synapse.rest.admin.media import ListMediaInRoom, register_servlets_for_media_repo
|
from synapse.rest.admin.media import ListMediaInRoom, register_servlets_for_media_repo
|
||||||
from synapse.rest.admin.purge_room_servlet import PurgeRoomServlet
|
from synapse.rest.admin.purge_room_servlet import PurgeRoomServlet
|
||||||
@ -216,6 +217,7 @@ def register_servlets(hs, http_server):
|
|||||||
DeviceRestServlet(hs).register(http_server)
|
DeviceRestServlet(hs).register(http_server)
|
||||||
DevicesRestServlet(hs).register(http_server)
|
DevicesRestServlet(hs).register(http_server)
|
||||||
DeleteDevicesRestServlet(hs).register(http_server)
|
DeleteDevicesRestServlet(hs).register(http_server)
|
||||||
|
EventReportsRestServlet(hs).register(http_server)
|
||||||
|
|
||||||
|
|
||||||
def register_servlets_for_client_rest_resource(hs, http_server):
|
def register_servlets_for_client_rest_resource(hs, http_server):
|
||||||
|
88
synapse/rest/admin/event_reports.py
Normal file
88
synapse/rest/admin/event_reports.py
Normal file
@ -0,0 +1,88 @@
|
|||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
# Copyright 2020 Dirk Klimpel
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
|
|
||||||
|
import logging
|
||||||
|
|
||||||
|
from synapse.api.errors import Codes, SynapseError
|
||||||
|
from synapse.http.servlet import RestServlet, parse_integer, parse_string
|
||||||
|
from synapse.rest.admin._base import admin_patterns, assert_requester_is_admin
|
||||||
|
|
||||||
|
logger = logging.getLogger(__name__)
|
||||||
|
|
||||||
|
|
||||||
|
class EventReportsRestServlet(RestServlet):
|
||||||
|
"""
|
||||||
|
List all reported events that are known to the homeserver. Results are returned
|
||||||
|
in a dictionary containing report information. Supports pagination.
|
||||||
|
The requester must have administrator access in Synapse.
|
||||||
|
|
||||||
|
GET /_synapse/admin/v1/event_reports
|
||||||
|
returns:
|
||||||
|
200 OK with list of reports if success otherwise an error.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
The parameters `from` and `limit` are required only for pagination.
|
||||||
|
By default, a `limit` of 100 is used.
|
||||||
|
The parameter `dir` can be used to define the order of results.
|
||||||
|
The parameter `user_id` can be used to filter by user id.
|
||||||
|
The parameter `room_id` can be used to filter by room id.
|
||||||
|
Returns:
|
||||||
|
A list of reported events and an integer representing the total number of
|
||||||
|
reported events that exist given this query
|
||||||
|
"""
|
||||||
|
|
||||||
|
PATTERNS = admin_patterns("/event_reports$")
|
||||||
|
|
||||||
|
def __init__(self, hs):
|
||||||
|
self.hs = hs
|
||||||
|
self.auth = hs.get_auth()
|
||||||
|
self.store = hs.get_datastore()
|
||||||
|
|
||||||
|
async def on_GET(self, request):
|
||||||
|
await assert_requester_is_admin(self.auth, request)
|
||||||
|
|
||||||
|
start = parse_integer(request, "from", default=0)
|
||||||
|
limit = parse_integer(request, "limit", default=100)
|
||||||
|
direction = parse_string(request, "dir", default="b")
|
||||||
|
user_id = parse_string(request, "user_id")
|
||||||
|
room_id = parse_string(request, "room_id")
|
||||||
|
|
||||||
|
if start < 0:
|
||||||
|
raise SynapseError(
|
||||||
|
400,
|
||||||
|
"The start parameter must be a positive integer.",
|
||||||
|
errcode=Codes.INVALID_PARAM,
|
||||||
|
)
|
||||||
|
|
||||||
|
if limit < 0:
|
||||||
|
raise SynapseError(
|
||||||
|
400,
|
||||||
|
"The limit parameter must be a positive integer.",
|
||||||
|
errcode=Codes.INVALID_PARAM,
|
||||||
|
)
|
||||||
|
|
||||||
|
if direction not in ("f", "b"):
|
||||||
|
raise SynapseError(
|
||||||
|
400, "Unknown direction: %s" % (direction,), errcode=Codes.INVALID_PARAM
|
||||||
|
)
|
||||||
|
|
||||||
|
event_reports, total = await self.store.get_event_reports_paginate(
|
||||||
|
start, limit, direction, user_id, room_id
|
||||||
|
)
|
||||||
|
ret = {"event_reports": event_reports, "total": total}
|
||||||
|
if (start + limit) < total:
|
||||||
|
ret["next_token"] = start + len(event_reports)
|
||||||
|
|
||||||
|
return 200, ret
|
@ -1328,6 +1328,101 @@ class RoomStore(RoomBackgroundUpdateStore, RoomWorkerStore, SearchStore):
|
|||||||
desc="add_event_report",
|
desc="add_event_report",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
async def get_event_reports_paginate(
|
||||||
|
self,
|
||||||
|
start: int,
|
||||||
|
limit: int,
|
||||||
|
direction: str = "b",
|
||||||
|
user_id: Optional[str] = None,
|
||||||
|
room_id: Optional[str] = None,
|
||||||
|
) -> Tuple[List[Dict[str, Any]], int]:
|
||||||
|
"""Retrieve a paginated list of event reports
|
||||||
|
|
||||||
|
Args:
|
||||||
|
start: event offset to begin the query from
|
||||||
|
limit: number of rows to retrieve
|
||||||
|
direction: Whether to fetch the most recent first (`"b"`) or the
|
||||||
|
oldest first (`"f"`)
|
||||||
|
user_id: search for user_id. Ignored if user_id is None
|
||||||
|
room_id: search for room_id. Ignored if room_id is None
|
||||||
|
Returns:
|
||||||
|
event_reports: json list of event reports
|
||||||
|
count: total number of event reports matching the filter criteria
|
||||||
|
"""
|
||||||
|
|
||||||
|
def _get_event_reports_paginate_txn(txn):
|
||||||
|
filters = []
|
||||||
|
args = []
|
||||||
|
|
||||||
|
if user_id:
|
||||||
|
filters.append("er.user_id LIKE ?")
|
||||||
|
args.extend(["%" + user_id + "%"])
|
||||||
|
if room_id:
|
||||||
|
filters.append("er.room_id LIKE ?")
|
||||||
|
args.extend(["%" + room_id + "%"])
|
||||||
|
|
||||||
|
if direction == "b":
|
||||||
|
order = "DESC"
|
||||||
|
else:
|
||||||
|
order = "ASC"
|
||||||
|
|
||||||
|
where_clause = "WHERE " + " AND ".join(filters) if len(filters) > 0 else ""
|
||||||
|
|
||||||
|
sql = """
|
||||||
|
SELECT COUNT(*) as total_event_reports
|
||||||
|
FROM event_reports AS er
|
||||||
|
{}
|
||||||
|
""".format(
|
||||||
|
where_clause
|
||||||
|
)
|
||||||
|
txn.execute(sql, args)
|
||||||
|
count = txn.fetchone()[0]
|
||||||
|
|
||||||
|
sql = """
|
||||||
|
SELECT
|
||||||
|
er.id,
|
||||||
|
er.received_ts,
|
||||||
|
er.room_id,
|
||||||
|
er.event_id,
|
||||||
|
er.user_id,
|
||||||
|
er.reason,
|
||||||
|
er.content,
|
||||||
|
events.sender,
|
||||||
|
room_aliases.room_alias,
|
||||||
|
event_json.json AS event_json
|
||||||
|
FROM event_reports AS er
|
||||||
|
LEFT JOIN room_aliases
|
||||||
|
ON room_aliases.room_id = er.room_id
|
||||||
|
JOIN events
|
||||||
|
ON events.event_id = er.event_id
|
||||||
|
JOIN event_json
|
||||||
|
ON event_json.event_id = er.event_id
|
||||||
|
{where_clause}
|
||||||
|
ORDER BY er.received_ts {order}
|
||||||
|
LIMIT ?
|
||||||
|
OFFSET ?
|
||||||
|
""".format(
|
||||||
|
where_clause=where_clause, order=order,
|
||||||
|
)
|
||||||
|
|
||||||
|
args += [limit, start]
|
||||||
|
txn.execute(sql, args)
|
||||||
|
event_reports = self.db_pool.cursor_to_dict(txn)
|
||||||
|
|
||||||
|
if count > 0:
|
||||||
|
for row in event_reports:
|
||||||
|
try:
|
||||||
|
row["content"] = db_to_json(row["content"])
|
||||||
|
row["event_json"] = db_to_json(row["event_json"])
|
||||||
|
except Exception:
|
||||||
|
continue
|
||||||
|
|
||||||
|
return event_reports, count
|
||||||
|
|
||||||
|
return await self.db_pool.runInteraction(
|
||||||
|
"get_event_reports_paginate", _get_event_reports_paginate_txn
|
||||||
|
)
|
||||||
|
|
||||||
def get_current_public_room_stream_id(self):
|
def get_current_public_room_stream_id(self):
|
||||||
return self._public_room_id_gen.get_current_token()
|
return self._public_room_id_gen.get_current_token()
|
||||||
|
|
||||||
|
382
tests/rest/admin/test_event_reports.py
Normal file
382
tests/rest/admin/test_event_reports.py
Normal file
@ -0,0 +1,382 @@
|
|||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
# Copyright 2020 Dirk Klimpel
|
||||||
|
#
|
||||||
|
# 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.
|
||||||
|
|
||||||
|
import json
|
||||||
|
|
||||||
|
import synapse.rest.admin
|
||||||
|
from synapse.api.errors import Codes
|
||||||
|
from synapse.rest.client.v1 import login, room
|
||||||
|
from synapse.rest.client.v2_alpha import report_event
|
||||||
|
|
||||||
|
from tests import unittest
|
||||||
|
|
||||||
|
|
||||||
|
class EventReportsTestCase(unittest.HomeserverTestCase):
|
||||||
|
servlets = [
|
||||||
|
synapse.rest.admin.register_servlets,
|
||||||
|
login.register_servlets,
|
||||||
|
room.register_servlets,
|
||||||
|
report_event.register_servlets,
|
||||||
|
]
|
||||||
|
|
||||||
|
def prepare(self, reactor, clock, hs):
|
||||||
|
self.store = hs.get_datastore()
|
||||||
|
|
||||||
|
self.admin_user = self.register_user("admin", "pass", admin=True)
|
||||||
|
self.admin_user_tok = self.login("admin", "pass")
|
||||||
|
|
||||||
|
self.other_user = self.register_user("user", "pass")
|
||||||
|
self.other_user_tok = self.login("user", "pass")
|
||||||
|
|
||||||
|
self.room_id1 = self.helper.create_room_as(
|
||||||
|
self.other_user, tok=self.other_user_tok, is_public=True
|
||||||
|
)
|
||||||
|
self.helper.join(self.room_id1, user=self.admin_user, tok=self.admin_user_tok)
|
||||||
|
|
||||||
|
self.room_id2 = self.helper.create_room_as(
|
||||||
|
self.other_user, tok=self.other_user_tok, is_public=True
|
||||||
|
)
|
||||||
|
self.helper.join(self.room_id2, user=self.admin_user, tok=self.admin_user_tok)
|
||||||
|
|
||||||
|
# Two rooms and two users. Every user sends and reports every room event
|
||||||
|
for i in range(5):
|
||||||
|
self._create_event_and_report(
|
||||||
|
room_id=self.room_id1, user_tok=self.other_user_tok,
|
||||||
|
)
|
||||||
|
for i in range(5):
|
||||||
|
self._create_event_and_report(
|
||||||
|
room_id=self.room_id2, user_tok=self.other_user_tok,
|
||||||
|
)
|
||||||
|
for i in range(5):
|
||||||
|
self._create_event_and_report(
|
||||||
|
room_id=self.room_id1, user_tok=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
for i in range(5):
|
||||||
|
self._create_event_and_report(
|
||||||
|
room_id=self.room_id2, user_tok=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
|
||||||
|
self.url = "/_synapse/admin/v1/event_reports"
|
||||||
|
|
||||||
|
def test_requester_is_no_admin(self):
|
||||||
|
"""
|
||||||
|
If the user is not a server admin, an error 403 is returned.
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url, access_token=self.other_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(403, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(Codes.FORBIDDEN, channel.json_body["errcode"])
|
||||||
|
|
||||||
|
def test_default_success(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url, access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 20)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
def test_limit(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with limit
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?limit=5", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 5)
|
||||||
|
self.assertEqual(channel.json_body["next_token"], 5)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
def test_from(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with a defined starting point (from)
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?from=5", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 15)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
def test_limit_and_from(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with a defined starting point and limit
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?from=5&limit=10", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(channel.json_body["next_token"], 15)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 10)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
def test_filter_room(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with a filter of room
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET",
|
||||||
|
self.url + "?room_id=%s" % self.room_id1,
|
||||||
|
access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 10)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 10)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
for report in channel.json_body["event_reports"]:
|
||||||
|
self.assertEqual(report["room_id"], self.room_id1)
|
||||||
|
|
||||||
|
def test_filter_user(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with a filter of user
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET",
|
||||||
|
self.url + "?user_id=%s" % self.other_user,
|
||||||
|
access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 10)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 10)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
for report in channel.json_body["event_reports"]:
|
||||||
|
self.assertEqual(report["user_id"], self.other_user)
|
||||||
|
|
||||||
|
def test_filter_user_and_room(self):
|
||||||
|
"""
|
||||||
|
Testing list of reported events with a filter of user and room
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET",
|
||||||
|
self.url + "?user_id=%s&room_id=%s" % (self.other_user, self.room_id1),
|
||||||
|
access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 5)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 5)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
self._check_fields(channel.json_body["event_reports"])
|
||||||
|
|
||||||
|
for report in channel.json_body["event_reports"]:
|
||||||
|
self.assertEqual(report["user_id"], self.other_user)
|
||||||
|
self.assertEqual(report["room_id"], self.room_id1)
|
||||||
|
|
||||||
|
def test_valid_search_order(self):
|
||||||
|
"""
|
||||||
|
Testing search order. Order by timestamps.
|
||||||
|
"""
|
||||||
|
|
||||||
|
# fetch the most recent first, largest timestamp
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?dir=b", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 20)
|
||||||
|
report = 1
|
||||||
|
while report < len(channel.json_body["event_reports"]):
|
||||||
|
self.assertGreaterEqual(
|
||||||
|
channel.json_body["event_reports"][report - 1]["received_ts"],
|
||||||
|
channel.json_body["event_reports"][report]["received_ts"],
|
||||||
|
)
|
||||||
|
report += 1
|
||||||
|
|
||||||
|
# fetch the oldest first, smallest timestamp
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?dir=f", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 20)
|
||||||
|
report = 1
|
||||||
|
while report < len(channel.json_body["event_reports"]):
|
||||||
|
self.assertLessEqual(
|
||||||
|
channel.json_body["event_reports"][report - 1]["received_ts"],
|
||||||
|
channel.json_body["event_reports"][report]["received_ts"],
|
||||||
|
)
|
||||||
|
report += 1
|
||||||
|
|
||||||
|
def test_invalid_search_order(self):
|
||||||
|
"""
|
||||||
|
Testing that a invalid search order returns a 400
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?dir=bar", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(400, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(Codes.INVALID_PARAM, channel.json_body["errcode"])
|
||||||
|
self.assertEqual("Unknown direction: bar", channel.json_body["error"])
|
||||||
|
|
||||||
|
def test_limit_is_negative(self):
|
||||||
|
"""
|
||||||
|
Testing that a negative list parameter returns a 400
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?limit=-5", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(400, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(Codes.INVALID_PARAM, channel.json_body["errcode"])
|
||||||
|
|
||||||
|
def test_from_is_negative(self):
|
||||||
|
"""
|
||||||
|
Testing that a negative from parameter returns a 400
|
||||||
|
"""
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?from=-5", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(400, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(Codes.INVALID_PARAM, channel.json_body["errcode"])
|
||||||
|
|
||||||
|
def test_next_token(self):
|
||||||
|
"""
|
||||||
|
Testing that `next_token` appears at the right place
|
||||||
|
"""
|
||||||
|
|
||||||
|
# `next_token` does not appear
|
||||||
|
# Number of results is the number of entries
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?limit=20", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 20)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
|
||||||
|
# `next_token` does not appear
|
||||||
|
# Number of max results is larger than the number of entries
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?limit=21", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 20)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
|
||||||
|
# `next_token` does appear
|
||||||
|
# Number of max results is smaller than the number of entries
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?limit=19", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 19)
|
||||||
|
self.assertEqual(channel.json_body["next_token"], 19)
|
||||||
|
|
||||||
|
# Check
|
||||||
|
# Set `from` to value of `next_token` for request remaining entries
|
||||||
|
# `next_token` does not appear
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"GET", self.url + "?from=19", access_token=self.admin_user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
self.assertEqual(channel.json_body["total"], 20)
|
||||||
|
self.assertEqual(len(channel.json_body["event_reports"]), 1)
|
||||||
|
self.assertNotIn("next_token", channel.json_body)
|
||||||
|
|
||||||
|
def _create_event_and_report(self, room_id, user_tok):
|
||||||
|
"""Create and report events
|
||||||
|
"""
|
||||||
|
resp = self.helper.send(room_id, tok=user_tok)
|
||||||
|
event_id = resp["event_id"]
|
||||||
|
|
||||||
|
request, channel = self.make_request(
|
||||||
|
"POST",
|
||||||
|
"rooms/%s/report/%s" % (room_id, event_id),
|
||||||
|
json.dumps({"score": -100, "reason": "this makes me sad"}),
|
||||||
|
access_token=user_tok,
|
||||||
|
)
|
||||||
|
self.render(request)
|
||||||
|
self.assertEqual(200, int(channel.result["code"]), msg=channel.result["body"])
|
||||||
|
|
||||||
|
def _check_fields(self, content):
|
||||||
|
"""Checks that all attributes are present in a event report
|
||||||
|
"""
|
||||||
|
for c in content:
|
||||||
|
self.assertIn("id", c)
|
||||||
|
self.assertIn("received_ts", c)
|
||||||
|
self.assertIn("room_id", c)
|
||||||
|
self.assertIn("event_id", c)
|
||||||
|
self.assertIn("user_id", c)
|
||||||
|
self.assertIn("reason", c)
|
||||||
|
self.assertIn("content", c)
|
||||||
|
self.assertIn("sender", c)
|
||||||
|
self.assertIn("room_alias", c)
|
||||||
|
self.assertIn("event_json", c)
|
||||||
|
self.assertIn("score", c["content"])
|
||||||
|
self.assertIn("reason", c["content"])
|
||||||
|
self.assertIn("auth_events", c["event_json"])
|
||||||
|
self.assertIn("type", c["event_json"])
|
||||||
|
self.assertIn("room_id", c["event_json"])
|
||||||
|
self.assertIn("sender", c["event_json"])
|
||||||
|
self.assertIn("content", c["event_json"])
|
Loading…
Reference in New Issue
Block a user