# # This file is part of Plinth. # # 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 . # """ Framework for working with servers and their services. """ import collections from django.utils.translation import ugettext_lazy as _ from plinth import cfg from plinth.signals import service_enabled from plinth.utils import format_lazy services = {} class Service(object): """ Representation of an application service provided by the machine containing information such as current status and ports required for operation. """ def __init__(self, service_id, name, ports=None, is_external=False, enabled=True): if not ports: ports = [service_id] self.service_id = service_id self.name = name self.ports = ports self.is_external = is_external self._enabled = enabled # Maintain a complete list of services services[service_id] = self def is_enabled(self): """Return whether the service is enabled.""" if isinstance(self._enabled, collections.Callable): return self._enabled() return self._enabled def notify_enabled(self, sender, enabled): """Notify observers about change in state of service.""" if not isinstance(self._enabled, collections.Callable): self._enabled = enabled service_enabled.send_robust(sender=sender, service_id=self.service_id, enabled=enabled) def init(): """Register some misc. services that don't fit elsewhere.""" Service('http', _('Web Server'), ['http'], is_external=True, enabled=True) Service('https', _('Web Server over Secure Socket Layer'), ['https'], is_external=True, enabled=True) Service('ssh', _('Secure Shell (SSH) Server'), ['ssh'], is_external=True, enabled=True) Service('plinth', format_lazy(_('{box_name} Web Interface (Plinth)'), box_name=_(cfg.box_name)), ['https'], is_external=True, enabled=True)