# # 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 action_utils from plinth import app as app_module from plinth import cfg, frontpage, menu from plinth.daemon import Daemon from plinth.modules.firewall.components import Firewall from plinth.utils import format_lazy from plinth.views import AppView from .manifest import backup, clients version = 1 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' port_forwarding_info = [('TCP', 4242)] app = None class QuasselApp(app_module.App): """FreedomBox app for Quassel.""" app_id = 'quassel' def __init__(self): """Create components for the app.""" super().__init__() menu_item = menu.Menu('menu-quassel', name, short_description, 'quassel', 'quassel:index', parent_url_name='apps') self.add(menu_item) shortcut = frontpage.Shortcut( 'shortcut-quassel', name, short_description=short_description, icon='quassel', description=description, configure_url=reverse_lazy('quassel:index'), clients=clients, login_required=True) self.add(shortcut) firewall = Firewall('firewall-quassel', name, ports=['quassel-plinth'], is_external=True) self.add(firewall) daemon = Daemon('daemon-quassel', managed_services[0]) self.add(daemon) def init(): """Initialize the quassel module.""" global app app = QuasselApp() setup_helper = globals()['setup_helper'] if setup_helper.get_state() != 'needs-setup' and app.is_enabled(): app.set_enabled(True) class QuasselAppView(AppView): app_id = 'quassel' diagnostics_module_name = 'quassel' name = name description = description clients = clients manual_page = manual_page port_forwarding_info = port_forwarding_info def setup(helper, old_version=None): """Install and configure the module.""" helper.install(managed_packages) helper.call('post', app.enable) 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