Mercurial > libervia-backend
view libervia/backend/tools/common/uri.py @ 4351:6a0a081485b8
plugin autocrypt: Autocrypt protocol implementation:
Implementation of autocrypt: `autocrypt` header is checked, and if present and no public
key is known for the peer, the key is imported.
`autocrypt` header is also added to outgoing message (only if an email gateway is
detected).
For the moment, the JID is use as identifier, but the real email used by gateway should be
used in the future.
rel 456
author | Goffi <goffi@goffi.org> |
---|---|
date | Fri, 28 Feb 2025 09:23:35 +0100 |
parents | 4b842c1fb686 |
children |
line wrap: on
line source
#!/usr/bin/env python3 # SAT: a jabber client # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org) # 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. # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. """ XMPP uri parsing tools """ from typing import Optional import sys import urllib.parse import urllib.request, urllib.parse, urllib.error # FIXME: basic implementation, need to follow RFC 5122 def parse_xmpp_uri(uri): """Parse an XMPP uri and return a dict with various information @param uri(unicode): uri to parse @return dict(unicode, unicode): data depending of the URI where key can be: type: one of ("pubsub", TODO) type is always present sub_type: can be: - microblog only used for pubsub for now path: XMPP path (jid of the service or entity) node: node used id: id of the element (item for pubsub) @raise ValueError: the scheme is not xmpp """ uri_split = urllib.parse.urlsplit(uri) if uri_split.scheme != "xmpp": raise ValueError("this is not a XMPP URI") # XXX: we don't use jid.JID for path as it can be used both in backend and frontend # which may use different JID classes data = {"path": urllib.parse.unquote(uri_split.path)} query_end = uri_split.query.find(";") if query_end == -1: # we just have a JID query_type = None else: query_type = uri_split.query[:query_end] if "=" in query_type: raise ValueError("no query type, invalid XMPP URI") if sys.version_info >= (3, 9): # parse_qs behaviour has been modified in Python 3.9, ";" is not understood as a # parameter separator anymore but the "separator" argument has been added to # change it. pairs = urllib.parse.parse_qs(uri_split.geturl(), separator=";") else: pairs = urllib.parse.parse_qs(uri_split.geturl()) for k, v in list(pairs.items()): if len(v) != 1: raise NotImplementedError("multiple values not managed") if k in ("path", "type", "sub_type"): raise NotImplementedError("reserved key used in URI, this is not supported") data[k] = urllib.parse.unquote(v[0]) if query_type: data["type"] = query_type elif "node" in data: data["type"] = "pubsub" else: data["type"] = "" if "node" in data: if data["node"].startswith("urn:xmpp:microblog:"): data["sub_type"] = "microblog" return data def add_pairs(uri, pairs): for k, v in pairs.items(): uri.append( ";" + urllib.parse.quote_plus(k.encode("utf-8")) + "=" + urllib.parse.quote_plus(v.encode("utf-8")) ) def build_xmpp_uri(type_: Optional[str] = None, **kwargs: str) -> str: uri = ["xmpp:"] subtype = kwargs.pop("subtype", None) path = kwargs.pop("path") uri.append(urllib.parse.quote_plus(path.encode("utf-8")).replace("%40", "@")) if type_ is None: # we have an URI to a JID if kwargs: raise NotImplementedError( "keyword arguments are not supported for URI without type" ) elif type_ == "pubsub": if subtype == "microblog" and not kwargs.get("node"): kwargs["node"] = "urn:xmpp:microblog:0" if kwargs: uri.append("?") add_pairs(uri, kwargs) else: raise NotImplementedError("{type_} URI are not handled yet".format(type_=type_)) return "".join(uri)