view cagou/core/platform_/base.py @ 400:71f51198478c

android: handle runtime permissions: - some mandatory permissions are requested on Cagou start, Cagou won't start at all and display a warning message if they are not granted (we request 5 times before showing the warning) - transfer plugin can now use "android_permissions" in plugin_info, to indicate what is necessary. The permissions will then be requested, and the plugin widget won't be shown if they are not granted (and a warning not will then be displayed)
author Goffi <goffi@goffi.org>
date Sun, 09 Feb 2020 23:47:29 +0100
parents 4d660b252487
children 355326a3501c
line wrap: on
line source

#!/usr/bin/env python3

# Cagou: desktop/mobile frontend for Salut à Toi XMPP client
# Copyright (C) 2016-2020 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/>.

import webbrowser
from pathlib import Path
from urllib.parse import urlparse
from kivy.config import Config as KivyConfig
from sat.core.log import getLogger
from sat.tools.common import files_utils
from sat_frontends.quick_frontend.quick_widgets import QuickWidget
from cagou import G


log = getLogger(__name__)


class Platform:
    """Base class to handle platform specific behaviours"""

    def init_platform(self):
        # we don't want multi-touch emulation with mouse

        # this option doesn't make sense on Android and cause troubles, so we only
        # activate it for other platforms (cf. https://github.com/kivy/kivy/issues/6229)
        KivyConfig.set('input', 'mouse', 'mouse,disable_multitouch')

    def on_app_build(self, wid):
        pass

    def on_host_init(self, host):
        pass

    def on_initFrontendState(self):
        pass

    def do_postInit(self):
        return True

    def on_pause(self):
        pass

    def on_resume(self):
        pass

    def on_stop(self):
        pass

    def on_key_back_root(self):
        """Back key is called while being on root widget"""
        return True

    def on_key_back_share(self, share_widget):
        """Back key is called while being on share widget"""
        share_widget.close()
        return True

    def on_extra_menu_init(self, extra_menu):
        pass

    def updateParamsExtra(self, extra):
        pass

    def check_plugin_permissions(self, plug_info, callback, errback):
        """Check that plugin permissions for this platform are granted"""
        callback()

    def open_url(self, url, wid=None):
        """Open an URL in the way appropriate for the platform

        @param url(str): URL to open
        @param wid(CagouWidget, None): widget requesting the opening
            it may influence the way the URL is opened
        """
        parsed_url = urlparse(url)
        if parsed_url.scheme == "aesgcm" and wid is not None:
            # aesgcm files need to be decrypted first
            # so we download them before opening
            name = Path(parsed_url.path).name.strip() or "unnamed_file"
            log.info(f"downloading/decrypting file {name!r}")
            dest_path = files_utils.get_unique_name(Path(G.host.downloads_dir)/name)
            quick_widget = G.host.getAncestorWidget(wid, QuickWidget)
            if quick_widget is None:
                log.error("Can't find ancestor QuickWidget")
                return
            profile = quick_widget.profile
            G.host.bridge.fileDownloadComplete(
                url,
                str(dest_path),
                '',
                profile,
                callback=webbrowser.open,
                errback=G.host.errback
            )
        else:
            webbrowser.open(url)