2014-08-12 22:32:18 -04:00
|
|
|
#
|
2023-11-21 15:29:58 -05:00
|
|
|
# This file is licensed under the Affero General Public License (AGPL) version 3.
|
|
|
|
#
|
|
|
|
# Copyright (C) 2023 New Vector, Ltd
|
|
|
|
#
|
|
|
|
# This program is free software: you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU Affero General Public License as
|
|
|
|
# published by the Free Software Foundation, either version 3 of the
|
|
|
|
# License, or (at your option) any later version.
|
|
|
|
#
|
|
|
|
# See the GNU Affero General Public License for more details:
|
|
|
|
# <https://www.gnu.org/licenses/agpl-3.0.html>.
|
|
|
|
#
|
|
|
|
# Originally licensed under the Apache License, Version 2.0:
|
|
|
|
# <http://www.apache.org/licenses/LICENSE-2.0>.
|
|
|
|
#
|
|
|
|
# [This file includes modifications made by New Vector Limited]
|
2014-08-12 22:32:18 -04:00
|
|
|
#
|
|
|
|
#
|
|
|
|
|
2022-06-10 08:30:14 -04:00
|
|
|
import argparse
|
|
|
|
import cgi
|
|
|
|
import datetime
|
|
|
|
import json
|
|
|
|
import urllib.request
|
|
|
|
from typing import List
|
|
|
|
|
|
|
|
import pydot
|
|
|
|
|
2014-08-12 10:10:52 -04:00
|
|
|
|
2022-06-10 08:30:14 -04:00
|
|
|
def make_name(pdu_id: str, origin: str) -> str:
|
|
|
|
return f"{pdu_id}@{origin}"
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
|
2022-06-10 08:30:14 -04:00
|
|
|
def make_graph(pdus: List[dict], filename_prefix: str) -> None:
|
|
|
|
"""
|
|
|
|
Generate a dot and SVG file for a graph of events in the room based on the
|
|
|
|
topological ordering by querying a homeserver.
|
|
|
|
"""
|
2014-08-12 10:10:52 -04:00
|
|
|
pdu_map = {}
|
|
|
|
node_map = {}
|
|
|
|
|
|
|
|
origins = set()
|
2020-07-20 16:43:49 -04:00
|
|
|
colors = {"red", "green", "blue", "yellow", "purple"}
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
for pdu in pdus:
|
|
|
|
origins.add(pdu.get("origin"))
|
|
|
|
|
|
|
|
color_map = {color: color for color in colors if color in origins}
|
|
|
|
colors -= set(color_map.values())
|
|
|
|
|
|
|
|
color_map[None] = "black"
|
|
|
|
|
|
|
|
for o in origins:
|
|
|
|
if o in color_map:
|
|
|
|
continue
|
|
|
|
try:
|
|
|
|
c = colors.pop()
|
|
|
|
color_map[o] = c
|
2020-07-20 16:43:49 -04:00
|
|
|
except Exception:
|
2019-06-17 13:21:30 -04:00
|
|
|
print("Run out of colours!")
|
2014-08-12 10:10:52 -04:00
|
|
|
color_map[o] = "black"
|
|
|
|
|
|
|
|
graph = pydot.Dot(graph_name="Test")
|
|
|
|
|
|
|
|
for pdu in pdus:
|
|
|
|
name = make_name(pdu.get("pdu_id"), pdu.get("origin"))
|
|
|
|
pdu_map[name] = pdu
|
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
t = datetime.datetime.fromtimestamp(float(pdu["ts"]) / 1000).strftime(
|
|
|
|
"%Y-%m-%d %H:%M:%S,%f"
|
|
|
|
)
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
label = (
|
|
|
|
"<"
|
|
|
|
"<b>%(name)s </b><br/>"
|
|
|
|
"Type: <b>%(type)s </b><br/>"
|
|
|
|
"State key: <b>%(state_key)s </b><br/>"
|
|
|
|
"Content: <b>%(content)s </b><br/>"
|
|
|
|
"Time: <b>%(time)s </b><br/>"
|
|
|
|
"Depth: <b>%(depth)s </b><br/>"
|
|
|
|
">"
|
|
|
|
) % {
|
|
|
|
"name": name,
|
|
|
|
"type": pdu.get("pdu_type"),
|
|
|
|
"state_key": pdu.get("state_key"),
|
|
|
|
"content": cgi.escape(json.dumps(pdu.get("content")), quote=True),
|
|
|
|
"time": t,
|
|
|
|
"depth": pdu.get("depth"),
|
|
|
|
}
|
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
node = pydot.Node(name=name, label=label, color=color_map[pdu.get("origin")])
|
2014-08-12 10:10:52 -04:00
|
|
|
node_map[name] = node
|
|
|
|
graph.add_node(node)
|
|
|
|
|
|
|
|
for pdu in pdus:
|
|
|
|
start_name = make_name(pdu.get("pdu_id"), pdu.get("origin"))
|
|
|
|
for i, o in pdu.get("prev_pdus", []):
|
|
|
|
end_name = make_name(i, o)
|
|
|
|
|
|
|
|
if end_name not in node_map:
|
2019-06-17 13:21:30 -04:00
|
|
|
print("%s not in nodes" % end_name)
|
2014-08-12 10:10:52 -04:00
|
|
|
continue
|
|
|
|
|
|
|
|
edge = pydot.Edge(node_map[start_name], node_map[end_name])
|
|
|
|
graph.add_edge(edge)
|
|
|
|
|
|
|
|
# Add prev_state edges, if they exist
|
|
|
|
if pdu.get("prev_state_id") and pdu.get("prev_state_origin"):
|
|
|
|
prev_state_name = make_name(
|
|
|
|
pdu.get("prev_state_id"), pdu.get("prev_state_origin")
|
|
|
|
)
|
|
|
|
|
|
|
|
if prev_state_name in node_map:
|
|
|
|
state_edge = pydot.Edge(
|
2019-06-20 05:32:02 -04:00
|
|
|
node_map[start_name], node_map[prev_state_name], style="dotted"
|
2014-08-12 10:10:52 -04:00
|
|
|
)
|
|
|
|
graph.add_edge(state_edge)
|
|
|
|
|
2019-06-20 05:32:02 -04:00
|
|
|
graph.write("%s.dot" % filename_prefix, format="raw", prog="dot")
|
|
|
|
# graph.write_png("%s.png" % filename_prefix, prog='dot')
|
|
|
|
graph.write_svg("%s.svg" % filename_prefix, prog="dot")
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
|
2022-06-10 08:30:14 -04:00
|
|
|
def get_pdus(host: str, room: str) -> List[dict]:
|
2014-08-12 10:10:52 -04:00
|
|
|
transaction = json.loads(
|
2022-06-10 08:30:14 -04:00
|
|
|
urllib.request.urlopen(
|
|
|
|
f"http://{host}/_matrix/federation/v1/context/{room}/"
|
2014-08-12 10:10:52 -04:00
|
|
|
).read()
|
|
|
|
)
|
|
|
|
|
|
|
|
return transaction["pdus"]
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
parser = argparse.ArgumentParser(
|
|
|
|
description="Generate a PDU graph for a given room by talking "
|
2019-06-20 05:32:02 -04:00
|
|
|
"to the given homeserver to get the list of PDUs. \n"
|
|
|
|
"Requires pydot."
|
2014-08-12 10:10:52 -04:00
|
|
|
)
|
|
|
|
parser.add_argument(
|
2019-06-20 05:32:02 -04:00
|
|
|
"-p", "--prefix", dest="prefix", help="String to prefix output files with"
|
2014-08-12 10:10:52 -04:00
|
|
|
)
|
2019-06-20 05:32:02 -04:00
|
|
|
parser.add_argument("host")
|
|
|
|
parser.add_argument("room")
|
2014-08-12 10:10:52 -04:00
|
|
|
|
|
|
|
args = parser.parse_args()
|
|
|
|
|
|
|
|
host = args.host
|
|
|
|
room = args.room
|
|
|
|
prefix = args.prefix if args.prefix else "%s_graph" % (room)
|
|
|
|
|
|
|
|
pdus = get_pdus(host, room)
|
|
|
|
|
2022-06-10 08:30:14 -04:00
|
|
|
make_graph(pdus, prefix)
|