Sunil Mohan Adapa 3a0db947b2
system: Add tags to all remaining apps
Tests:

- Visit the system page and notice that tags appear as expected for all items on
the page.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
2024-12-29 22:58:23 -08:00

125 lines
4.2 KiB
Python

# SPDX-License-Identifier: AGPL-3.0-or-later
"""
FreedomBox app to configure system date and time.
"""
import subprocess
from django.utils.translation import gettext_lazy as _
from django.utils.translation import gettext_noop
from plinth import app as app_module
from plinth import menu
from plinth.daemon import Daemon, RelatedDaemon
from plinth.diagnostic_check import DiagnosticCheck, Result
from plinth.modules.backups.components import BackupRestore
from plinth.package import Packages
from . import manifest
_description = [
_('Network time server is a program that maintains the system time '
'in synchronization with servers on the Internet.')
]
class DateTimeApp(app_module.App):
"""FreedomBox app for date and time if time syncronization is unmanaged."""
app_id = 'datetime'
_version = 2
_time_managed = None
@property
def can_be_disabled(self):
"""Return whether the app can be disabled."""
return self._is_time_managed()
def _is_time_managed(self):
"""Check whether time should be syncronized by the systemd-timesyncd.
systemd-timesyncd does not run if we have another NTP daemon installed
or FreedomBox runs inside a container where the host manages the time.
"""
if self._time_managed is None:
try:
# Replace with the command 'systemd-analyze condition
# --unit=systemd-timesyncd.service' when --unit argument
# becomes available in a newer systemd.
process = subprocess.run(
['systemd-detect-virt', '--container'], check=False,
stdout=subprocess.PIPE)
self._time_managed = (
process.stdout.decode().strip() == 'none')
except (FileNotFoundError, subprocess.CalledProcessError):
# When systemd-timesyncd will not run.
self._time_managed = False
return self._time_managed
def __init__(self) -> None:
"""Create components for the app."""
super().__init__()
info = app_module.Info(app_id=self.app_id, version=self._version,
is_essential=True, name=_('Date & Time'),
icon='fa-clock-o', description=_description,
manual_page='DateTime', tags=manifest.tags)
self.add(info)
menu_item = menu.Menu('menu-datetime', info.name, None, info.icon,
'datetime:index',
parent_url_name='system:system', order=40)
self.add(menu_item)
packages = Packages('packages-datetime', ['systemd-timesyncd'])
self.add(packages)
related_daemon = RelatedDaemon('daemon-datetime-timedated',
'systemd-timedated')
self.add(related_daemon)
if self._is_time_managed():
daemon = Daemon('daemon-datetime', 'systemd-timesyncd')
self.add(daemon)
backup_restore = BackupRestore('backup-restore-datetime',
**manifest.backup)
self.add(backup_restore)
def diagnose(self) -> list[DiagnosticCheck]:
"""Run diagnostics and return the results."""
results = super().diagnose()
if self._is_time_managed():
results.append(_diagnose_time_synchronized())
return results
def has_diagnostics(self):
"""Return that app has diagnostics only when time is managed."""
return self._is_time_managed()
def setup(self, old_version):
"""Install and configure the app."""
super().setup(old_version)
self.enable()
def _diagnose_time_synchronized() -> DiagnosticCheck:
"""Check whether time is synchronized to NTP server."""
result = Result.FAILED
try:
output = subprocess.check_output(
['timedatectl', 'show', '--property=NTPSynchronized', '--value'])
if 'yes' in output.decode():
result = Result.PASSED
except subprocess.CalledProcessError:
pass
return DiagnosticCheck('datetime-ntp-sync',
gettext_noop('Time synchronized to NTP server'),
result)