libervia-backend: libervia/cli/cmd

annotate libervia/cli/cmd_identity.py @ 4306:94e0968987cd

plugin XEP-0033: code modernisation, improve delivery, data validation: - Code has been rewritten using Pydantic models and `async` coroutines for data validation and cleaner element parsing/generation. - Delivery has been completely rewritten. It now works even if server doesn't support multicast, and send to local multicast service first. Delivering to local multicast service first is due to bad support of XEP-0033 in server (notably Prosody which has an incomplete implementation), and the current impossibility to detect if a sub-domain service handles fully multicast or only for local domains. This is a workaround to have a good balance between backward compatilibity and use of bandwith, and to make it work with the incoming email gateway implementation (the gateway will only deliver to entities of its own domain). - disco feature checking now uses `async` corountines. `host` implementation still use Deferred return values for compatibility with legacy code. rel 450

author	Goffi <goffi@goffi.org>
date	Thu, 26 Sep 2024 16:12:01 +0200
parents	0d7bb4df2343
children

rev	line source
3137 559a625a236b fixed shebangs Goffi <goffi@goffi.org> parents: 3136 diff changeset	1 #!/usr/bin/env python3
559a625a236b fixed shebangs Goffi <goffi@goffi.org> parents: 3136 diff changeset	2
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	3
4075 47401850dec6 refactoring: rename `libervia.frontends.jp` to `libervia.cli` Goffi <goffi@goffi.org> parents: 4074 diff changeset	4 # Libervia CLI
3479 be6d91572633 date update Goffi <goffi@goffi.org> parents: 3254 diff changeset	5 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	6
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	7 # This program is free software: you can redistribute it and/or modify
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	8 # it under the terms of the GNU Affero General Public License as published by
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	9 # the Free Software Foundation, either version 3 of the License, or
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	10 # (at your option) any later version.
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	11
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	12 # This program is distributed in the hope that it will be useful,
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	15 # GNU Affero General Public License for more details.
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	16
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	17 # You should have received a copy of the GNU Affero General Public License
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	19
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	20
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2771 diff changeset	21 from . import base
4071 4b842c1fb686 refactoring: renamed `sat` package to `libervia.backend` Goffi <goffi@goffi.org> parents: 4037 diff changeset	22 from libervia.backend.core.i18n import _
4075 47401850dec6 refactoring: rename `libervia.frontends.jp` to `libervia.cli` Goffi <goffi@goffi.org> parents: 4074 diff changeset	23 from libervia.cli.constants import Const as C
4071 4b842c1fb686 refactoring: renamed `sat` package to `libervia.backend` Goffi <goffi@goffi.org> parents: 4037 diff changeset	24 from libervia.backend.tools.common import data_format
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	25
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	26 __commands__ = ["Identity"]
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	27
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	28
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	29 class Get(base.CommandBase):
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	30 def __init__(self, host):
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	31 base.CommandBase.__init__(
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	32 self,
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	33 host,
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	34 "get",
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	35 use_output=C.OUTPUT_DICT,
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	36 use_verbose=True,
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2771 diff changeset	37 help=_("get identity data"),
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	38 )
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	39
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	40 def add_parser_options(self):
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	41 self.parser.add_argument(
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	42 "--no-cache", action="store_true", help=_("do no use cached values")
6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	43 )
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4075 diff changeset	44 self.parser.add_argument("jid", help=_("entity to check"))
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	45
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	46 async def start(self):
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	47 jid_ = (await self.host.check_jids([self.args.jid]))[0]
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	48 try:
4037 524856bd7b19 massive refactoring to switch from camelCase to snake_case: Goffi <goffi@goffi.org> parents: 3825 diff changeset	49 data = await self.host.bridge.identity_get(
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4075 diff changeset	50 jid_, [], not self.args.no_cache, self.profile
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	51 )
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	52 except Exception as e:
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	53 self.disp(f"can't get identity data: {e}", error=True)
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	54 self.host.quit(C.EXIT_BRIDGE_ERRBACK)
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	55 else:
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	56 data = data_format.deserialise(data)
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	57 await self.output(data)
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	58 self.host.quit()
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	59
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	60
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	61 class Set(base.CommandBase):
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	62 def __init__(self, host):
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	63 super(Set, self).__init__(host, "set", help=_("update identity data"))
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	64
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	65 def add_parser_options(self):
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	66 self.parser.add_argument(
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	67 "-n",
6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	68 "--nickname",
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	69 action="append",
3825 10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	70 metavar="NICKNAME",
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	71 dest="nicknames",
6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	72 help=_("nicknames of the entity"),
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	73 )
3825 10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	74 self.parser.add_argument(
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	75 "-d",
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	76 "--description",
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	77 help=_("description of the entity"),
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	78 )
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	79
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	80 async def start(self):
3825 10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	81 id_data = {}
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	82 for field in ("nicknames", "description"):
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	83 value = getattr(self.args, field)
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	84 if value is not None:
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	85 id_data[field] = value
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	86 if not id_data:
10a4846818e5 CLI (identity): add description to `identity set`: Goffi <goffi@goffi.org> parents: 3479 diff changeset	87 self.parser.error("At least one metadata must be set")
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	88 try:
4037 524856bd7b19 massive refactoring to switch from camelCase to snake_case: Goffi <goffi@goffi.org> parents: 3825 diff changeset	89 self.host.bridge.identity_set(
3254 6cf4bd6972c2 core, frontends: avatar refactoring: Goffi <goffi@goffi.org> parents: 3137 diff changeset	90 data_format.serialise(id_data),
3040 fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	91 self.profile,
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	92 )
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	93 except Exception as e:
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	94 self.disp(f"can't set identity data: {e}", error=True)
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	95 self.host.quit(C.EXIT_BRIDGE_ERRBACK)
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	96 else:
fee60f17ebac jp: jp asyncio port: Goffi <goffi@goffi.org> parents: 3028 diff changeset	97 self.host.quit()
2254 6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	98
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	99
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	100 class Identity(base.CommandBase):
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	101 subcommands = (Get, Set)
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	102
6297817c3dc9 jp (identity): new identity command to handle the new plugin identity in backend, and maybe other plugins like vcard in the future Goffi <goffi@goffi.org> parents: diff changeset	103 def __init__(self, host):
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	104 super(Identity, self).__init__(
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	105 host, "identity", use_profile=False, help=_("identity management")
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2562 diff changeset	106 )

Mercurial > libervia-backend

annotate libervia/cli/cmd_identity.py @ 4306:94e0968987cd