annotate 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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4247
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
1 #!/usr/bin/env python3
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
2
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
3 # Libervia plugin for Jingle (XEP-0166)
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
4 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
5
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
6 # This program is free software: you can redistribute it and/or modify
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 # it under the terms of the GNU Affero General Public License as published by
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
8 # the Free Software Foundation, either version 3 of the License, or
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
9 # (at your option) any later version.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
10
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
11 # This program is distributed in the hope that it will be useful,
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
14 # GNU Affero General Public License for more details.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
15
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
16 # You should have received a copy of the GNU Affero General Public License
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
18
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
19
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
20 import abc
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
21 from pathlib import Path
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
22
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
23 from libervia.backend.core.i18n import _
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
24
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
25
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
26 class AppManagerBackend(abc.ABC):
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
27 """Abstract class for App Manager."""
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
28
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
29 name: str
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
30 discover_path: Path|None = None
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
31
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
32 def __init__(self, host) -> None:
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
33 """Initialize the App Manager.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
34
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
35 @param host: The host object.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
36 """
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
37 self.host = host
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
38 self._am = host.plugins["APP_MANAGER"]
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
39 self._am.register(self)
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
40
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
41 @abc.abstractmethod
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
42 async def start(self, app_data: dict) -> None:
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
43 """Start the app.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
44
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
45 @param app_data: A dictionary containing app data.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
46 """
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
47 pass
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
48
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
49 @abc.abstractmethod
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
50 async def stop(self, app_data: dict) -> None:
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
51 """Stop the app.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
52
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
53 @param app_data: A dictionary containing app data.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
54 """
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
55 pass
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
56
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
57 @abc.abstractmethod
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
58 async def compute_expose(self, app_data: dict) -> None:
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
59 """Compute exposed data for the app.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
60
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
61 @param app_data: A dictionary containing app data.
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
62 """
4aa62767f501 plugin app manager: various improvements:
Goffi <goffi@goffi.org>
parents:
diff changeset
63 pass