comparison libervia/backend/plugins/plugin_misc_app_manager/models.py @ 4247:4aa62767f501

plugin app manager: various improvements: - Generated password must now be named and are stored, so they are re-used on following restarts. Password size can now be specified. - New `not` filter for `!libervia_param` to inverse a boolean value. - Former `front_url` field has been renamed to `web_url_path` as it is the URL path used for web frontend. All Web frontend related field are prefixed with `web_`. - `front_url` is now used to specify a whole front URL (notably useful if an app uses its own domain). A list can be used to retrieve a key, like for `url_prefix`, and `https` scheme is added if no scheme is specified. - An abstract class is now used for App Managers. - Last application start time is stored in persistent data.
author Goffi <goffi@goffi.org>
date Fri, 31 May 2024 11:08:14 +0200
parents
children 0d7bb4df2343
comparison
equal deleted inserted replaced
4246:5eb13251fd75 4247:4aa62767f501
1 #!/usr/bin/env python3
2
3 # Libervia plugin for Jingle (XEP-0166)
4 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
5
6 # This program is free software: you can redistribute it and/or modify
7 # it under the terms of the GNU Affero General Public License as published by
8 # the Free Software Foundation, either version 3 of the License, or
9 # (at your option) any later version.
10
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU Affero General Public License for more details.
15
16 # You should have received a copy of the GNU Affero General Public License
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
18
19
20 import abc
21 from pathlib import Path
22
23 from libervia.backend.core.i18n import _
24
25
26 class AppManagerBackend(abc.ABC):
27 """Abstract class for App Manager."""
28
29 name: str
30 discover_path: Path|None = None
31
32 def __init__(self, host) -> None:
33 """Initialize the App Manager.
34
35 @param host: The host object.
36 """
37 self.host = host
38 self._am = host.plugins["APP_MANAGER"]
39 self._am.register(self)
40
41 @abc.abstractmethod
42 async def start(self, app_data: dict) -> None:
43 """Start the app.
44
45 @param app_data: A dictionary containing app data.
46 """
47 pass
48
49 @abc.abstractmethod
50 async def stop(self, app_data: dict) -> None:
51 """Stop the app.
52
53 @param app_data: A dictionary containing app data.
54 """
55 pass
56
57 @abc.abstractmethod
58 async def compute_expose(self, app_data: dict) -> None:
59 """Compute exposed data for the app.
60
61 @param app_data: A dictionary containing app data.
62 """
63 pass