view libervia/cli/cmd_profile.py @ 4340:ea72364131d5 default tip @

doc (components): Update Email Gateway documentation: A section has been added to explain how attachments are handled. fix 453
author Goffi <goffi@goffi.org>
date Tue, 03 Dec 2024 00:53:18 +0100
parents 0d7bb4df2343
children
line wrap: on
line source

#!/usr/bin/env python3


# Libervia CLI
# 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/>.

"""This module permits to manage profiles. It can list, create, delete
and retrieve information about a profile."""

from libervia.cli.constants import Const as C
from libervia.backend.core.log import getLogger
from libervia.backend.core.i18n import _
from libervia.cli import base

log = getLogger(__name__)


__commands__ = ["Profile"]

PROFILE_HELP = _("The name of the profile")


class ProfileConnect(base.CommandBase):
    """Dummy command to use profile_session parent, i.e. to be able to connect without doing anything else"""

    def __init__(self, host):
        # it's weird to have a command named "connect" with need_connect=False, but it can be handy to be able
        # to launch just the session, so some paradoxes don't hurt
        super(ProfileConnect, self).__init__(
            host, "connect", need_connect=False, help=("connect a profile")
        )

    def add_parser_options(self):
        pass

    async def start(self):
        # connection is already managed by profile common commands
        # so we just need to check arguments and quit
        if not self.args.connect and not self.args.start_session:
            self.parser.error(_("You need to use either --connect or --start-session"))
        self.host.quit()


class ProfileDisconnect(base.CommandBase):

    def __init__(self, host):
        super(ProfileDisconnect, self).__init__(
            host, "disconnect", need_connect=False, help=("disconnect a profile")
        )

    def add_parser_options(self):
        pass

    async def start(self):
        try:
            await self.host.bridge.disconnect(self.args.profile)
        except Exception as e:
            self.disp(f"can't disconnect profile: {e}", error=True)
            self.host.quit(C.EXIT_BRIDGE_ERRBACK)
        else:
            self.host.quit()


class ProfileCreate(base.CommandBase):
    def __init__(self, host):
        super(ProfileCreate, self).__init__(
            host, "create", use_profile=False, help=("create a new profile")
        )

    def add_parser_options(self):
        self.parser.add_argument("profile", type=str, help=_("the name of the profile"))
        self.parser.add_argument(
            "-p",
            "--password",
            type=str,
            default="",
            help=_("the password of the profile"),
        )
        self.parser.add_argument(
            "-j", "--jid", type=str, help=_("the jid of the profile")
        )
        self.parser.add_argument(
            "-x",
            "--xmpp-password",
            type=str,
            help=_(
                "the password of the XMPP account (use profile password if not specified)"
            ),
            metavar="PASSWORD",
        )
        self.parser.add_argument(
            "-A",
            "--autoconnect",
            choices=[C.BOOL_TRUE, C.BOOL_FALSE],
            nargs="?",
            const=C.BOOL_TRUE,
            help=_("connect this profile automatically when backend starts"),
        )
        self.parser.add_argument(
            "-C",
            "--component",
            default="",
            help=_("set to component import name (entry point) if this is a component"),
        )

    async def start(self):
        """Create a new profile"""
        if self.args.profile in await self.host.bridge.profiles_list_get():
            self.disp(f"Profile {self.args.profile} already exists.", error=True)
            self.host.quit(C.EXIT_BRIDGE_ERROR)
        try:
            await self.host.bridge.profile_create(
                self.args.profile, self.args.password, self.args.component
            )
        except Exception as e:
            self.disp(f"can't create profile: {e}", error=True)
            self.host.quit(C.EXIT_BRIDGE_ERRBACK)

        try:
            await self.host.bridge.profile_start_session(
                self.args.password, self.args.profile
            )
        except Exception as e:
            self.disp(f"can't start profile session: {e}", error=True)
            self.host.quit(C.EXIT_BRIDGE_ERRBACK)

        if self.args.jid:
            await self.host.bridge.param_set(
                "JabberID", self.args.jid, "Connection", profile_key=self.args.profile
            )
        xmpp_pwd = self.args.password or self.args.xmpp_password
        if xmpp_pwd:
            await self.host.bridge.param_set(
                "Password", xmpp_pwd, "Connection", profile_key=self.args.profile
            )

        if self.args.autoconnect is not None:
            await self.host.bridge.param_set(
                "autoconnect_backend",
                self.args.autoconnect,
                "Connection",
                profile_key=self.args.profile,
            )

        self.disp(f"profile {self.args.profile} created successfully", 1)
        self.host.quit()


class ProfileDefault(base.CommandBase):
    def __init__(self, host):
        super(ProfileDefault, self).__init__(
            host, "default", use_profile=False, help=("print default profile")
        )

    def add_parser_options(self):
        pass

    async def start(self):
        print(await self.host.bridge.profile_name_get("@DEFAULT@"))
        self.host.quit()


class ProfileDelete(base.CommandBase):
    def __init__(self, host):
        super(ProfileDelete, self).__init__(
            host, "delete", use_profile=False, help=("delete a profile")
        )

    def add_parser_options(self):
        self.parser.add_argument("profile", type=str, help=PROFILE_HELP)
        self.parser.add_argument(
            "-f",
            "--force",
            action="store_true",
            help=_("delete profile without confirmation"),
        )

    async def start(self):
        if self.args.profile not in await self.host.bridge.profiles_list_get():
            log.error(f"Profile {self.args.profile} doesn't exist.")
            self.host.quit(C.EXIT_NOT_FOUND)
        if not self.args.force:
            message = f"Are you sure to delete profile [{self.args.profile}] ?"
            cancel_message = "Profile deletion cancelled"
            await self.host.confirm_or_quit(message, cancel_message)

        await self.host.bridge.profile_delete_async(self.args.profile)
        self.host.quit()


class ProfileInfo(base.CommandBase):

    def __init__(self, host):
        super(ProfileInfo, self).__init__(
            host,
            "info",
            need_connect=False,
            use_output=C.OUTPUT_DICT,
            help=_("get information about a profile"),
        )
        self.to_show = [
            (_("jid"), "Connection", "JabberID"),
        ]

    def add_parser_options(self):
        self.parser.add_argument(
            "--show-password",
            action="store_true",
            help=_("show the XMPP password IN CLEAR TEXT"),
        )

    async def start(self):
        if self.args.show_password:
            self.to_show.append((_("XMPP password"), "Connection", "Password"))
        self.to_show.append(
            (_("autoconnect (backend)"), "Connection", "autoconnect_backend")
        )
        data = {}
        for label, category, name in self.to_show:
            try:
                value = await self.host.bridge.param_get_a_async(
                    name, category, profile_key=self.host.profile
                )
            except Exception as e:
                self.disp(f"can't get {name}/{category} param: {e}", error=True)
            else:
                data[label] = value

        await self.output(data)
        self.host.quit()


class ProfileList(base.CommandBase):
    def __init__(self, host):
        super(ProfileList, self).__init__(
            host, "list", use_profile=False, use_output="list", help=("list profiles")
        )

    def add_parser_options(self):
        group = self.parser.add_mutually_exclusive_group()
        group.add_argument(
            "-c", "--clients", action="store_true", help=_("get clients profiles only")
        )
        group.add_argument(
            "-C",
            "--components",
            action="store_true",
            help=("get components profiles only"),
        )

    async def start(self):
        if self.args.clients:
            clients, components = True, False
        elif self.args.components:
            clients, components = False, True
        else:
            clients, components = True, True
        await self.output(await self.host.bridge.profiles_list_get(clients, components))
        self.host.quit()


class ProfileModify(base.CommandBase):

    def __init__(self, host):
        super(ProfileModify, self).__init__(
            host, "modify", need_connect=False, help=_("modify an existing profile")
        )

    def add_parser_options(self):
        profile_pwd_group = self.parser.add_mutually_exclusive_group()
        profile_pwd_group.add_argument(
            "-w", "--password", help=_("change the password of the profile")
        )
        profile_pwd_group.add_argument(
            "--disable-password",
            action="store_true",
            help=_("disable profile password (dangerous!)"),
        )
        self.parser.add_argument("-j", "--jid", help=_("the jid of the profile"))
        self.parser.add_argument(
            "-x",
            "--xmpp-password",
            help=_("change the password of the XMPP account"),
            metavar="PASSWORD",
        )
        self.parser.add_argument(
            "-D", "--default", action="store_true", help=_("set as default profile")
        )
        self.parser.add_argument(
            "-A",
            "--autoconnect",
            choices=[C.BOOL_TRUE, C.BOOL_FALSE],
            nargs="?",
            const=C.BOOL_TRUE,
            help=_("connect this profile automatically when backend starts"),
        )

    async def start(self):
        if self.args.disable_password:
            self.args.password = ""
        if self.args.password is not None:
            await self.host.bridge.param_set(
                "Password", self.args.password, "General", profile_key=self.host.profile
            )
        if self.args.jid is not None:
            await self.host.bridge.param_set(
                "JabberID", self.args.jid, "Connection", profile_key=self.host.profile
            )
        if self.args.xmpp_password is not None:
            await self.host.bridge.param_set(
                "Password",
                self.args.xmpp_password,
                "Connection",
                profile_key=self.host.profile,
            )
        if self.args.default:
            await self.host.bridge.profile_set_default(self.host.profile)
        if self.args.autoconnect is not None:
            await self.host.bridge.param_set(
                "autoconnect_backend",
                self.args.autoconnect,
                "Connection",
                profile_key=self.host.profile,
            )

        self.host.quit()


class Profile(base.CommandBase):
    subcommands = (
        ProfileConnect,
        ProfileDisconnect,
        ProfileCreate,
        ProfileDefault,
        ProfileDelete,
        ProfileInfo,
        ProfileList,
        ProfileModify,
    )

    def __init__(self, host):
        super(Profile, self).__init__(
            host, "profile", use_profile=False, help=_("profile commands")
        )