# # This file is part of FreedomBox. # # 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 . # """ FreedomBox app for Quassel. """ from django.urls import reverse_lazy from django.utils.translation import ugettext_lazy as _ from plinth import service as service_module from plinth import action_utils, actions, cfg, frontpage from plinth.menu import main_menu from plinth.utils import format_lazy from plinth.views import ServiceView from .manifest import backup, clients version = 1 service = None managed_services = ['quasselcore'] managed_packages = ['quassel-core'] name = _('Quassel') short_description = _('IRC Client') description = [ format_lazy( _('Quassel is an IRC application that is split into two parts, a ' '"core" and a "client". This allows the core to remain connected ' 'to IRC servers, and to continue receiving messages, even when ' 'the client is disconnected. {box_name} can run the Quassel ' 'core service keeping you always online and one or more Quassel ' 'clients from a desktop or a mobile can be used to connect and ' 'disconnect from it.'), box_name=_(cfg.box_name)), _('You can connect to your Quassel core on the default Quassel port ' '4242. Clients to connect to Quassel from your ' 'desktop and ' 'mobile devices ' 'are available.'), ] clients = clients reserved_usernames = ['quasselcore'] manual_page = 'Quassel' def init(): """Initialize the quassel module.""" menu = main_menu.get('apps') menu.add_urlname(name, 'quassel', 'quassel:index', short_description) global service setup_helper = globals()['setup_helper'] if setup_helper.get_state() != 'needs-setup': service = service_module.Service(managed_services[0], name, ports=[ 'quassel-plinth' ], is_external=True, enable=enable, disable=disable) if service.is_enabled(): add_shortcut() class QuasselServiceView(ServiceView): service_id = managed_services[0] diagnostics_module_name = "quassel" description = description clients = clients manual_page = manual_page def setup(helper, old_version=None): """Install and configure the module.""" helper.install(managed_packages) global service if service is None: service = service_module.Service(managed_services[0], name, ports=[ 'quassel-plinth' ], is_external=True, enable=enable, disable=disable) helper.call('post', service.notify_enabled, None, True) helper.call('post', add_shortcut) def add_shortcut(): frontpage.add_shortcut( 'quassel', name, short_description=short_description, details=description, configure_url=reverse_lazy('quassel:index'), login_required=True) def enable(): """Enable the module.""" actions.superuser_run('service', ['enable', managed_services[0]]) add_shortcut() def disable(): """Disable the module.""" actions.superuser_run('service', ['disable', managed_services[0]]) frontpage.remove_shortcut('quassel') def diagnose(): """Run diagnostics and return the results.""" results = [] results.append(action_utils.diagnose_port_listening(4242, 'tcp4')) results.append(action_utils.diagnose_port_listening(4242, 'tcp6')) return results