annotate sat/tools/common/dynamic_import.py @ 3728:b15644cae50d

component AP gateway: JID/node ⟺ AP outbox conversion: - convert a combination of JID and optional pubsub node to AP actor handle (see `getJIDAndNode` for details) and vice versa - the gateway now provides a Pubsub service - retrieve pubsub node and convert it to AP collection, AP pagination is converted to RSM - do the opposite: convert AP collection to pubsub and handle RSM request. Due to ActivityStream collection pagination limitations, some RSM request produce inefficient requests, but caching should be used most of the time in the future and avoid the problem. - set specific name to HTTP Server - new `local_only` setting (`True` by default) to indicate if the gateway can request or not XMPP Pubsub nodes from other servers - disco info now specifies important features such as Pubsub RSM, and nodes metadata ticket 363
author Goffi <goffi@goffi.org>
date Tue, 25 Jan 2022 17:54:06 +0100
parents 7550ae9cfbac
children 524856bd7b19
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3028
ab2696e34d29 Python 3 port:
Goffi <goffi@goffi.org>
parents: 2771
diff changeset
1 #!/usr/bin/env python3
3137
559a625a236b fixed shebangs
Goffi <goffi@goffi.org>
parents: 3136
diff changeset
2
3480
7550ae9cfbac Renamed the project from "Salut à Toi" to "Libervia":
Goffi <goffi@goffi.org>
parents: 3479
diff changeset
3 # Libervia: an XMPP client
3479
be6d91572633 date update
Goffi <goffi@goffi.org>
parents: 3290
diff changeset
4 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
5
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
6 # This program is free software: you can redistribute it and/or modify
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
7 # it under the terms of the GNU Affero General Public License as published by
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
8 # the Free Software Foundation, either version 3 of the License, or
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
9 # (at your option) any later version.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
10
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
11 # This program is distributed in the hope that it will be useful,
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
14 # GNU Affero General Public License for more details.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
15
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
16 # You should have received a copy of the GNU Affero General Public License
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
18
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
19 """ tools dynamic import """
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
20
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
21 from importlib import import_module
3290
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
22 from sat.core.log import getLogger
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
23
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
24
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
25 log = getLogger(__name__)
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
26
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
27
2624
56f94936df1e code style reformatting using black
Goffi <goffi@goffi.org>
parents: 2562
diff changeset
28 def bridge(name, module_path="sat.bridge"):
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
29 """Import bridge module
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
30
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
31 @param module_path(str): path of the module to import
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
32 @param name(str): name of the bridge to import (e.g.: dbus)
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
33 @return (module, None): imported module or None if nothing is found
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
34 """
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
35 try:
2624
56f94936df1e code style reformatting using black
Goffi <goffi@goffi.org>
parents: 2562
diff changeset
36 bridge_module = import_module(module_path + "." + name)
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
37 except ImportError:
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
38 try:
2624
56f94936df1e code style reformatting using black
Goffi <goffi@goffi.org>
parents: 2562
diff changeset
39 bridge_module = import_module(module_path + "." + name + "_bridge")
3290
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
40 except ImportError as e:
3ff952c042ae tools (common/dynamic_import): log a warning if bridge can't be imported
Goffi <goffi@goffi.org>
parents: 3137
diff changeset
41 log.warning(f"Can't import bridge {name!r}: {e}")
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
42 bridge_module = None
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
43 return bridge_module