# SPDX-License-Identifier: AGPL-3.0-or-later """FreedomBox app to configure Tiny Tiny RSS.""" from django.urls import reverse_lazy from django.utils.translation import gettext_lazy as _ from plinth import app as app_module from plinth import cfg, frontpage, menu from plinth.config import DropinConfigs from plinth.daemon import Daemon from plinth.modules.apache.components import Webserver from plinth.modules.backups.components import BackupRestore from plinth.modules.firewall.components import Firewall from plinth.modules.users.components import UsersAndGroups from plinth.package import Packages, install from plinth.utils import Version, format_lazy from . import manifest, privileged _description = [ _('Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator, ' 'designed to allow reading news from any location, while feeling as ' 'close to a real desktop application as possible.'), format_lazy( _('When enabled, Tiny Tiny RSS can be accessed by ' 'any user belonging to the ' 'feed-reader group.'), box_name=_(cfg.box_name), users_url=reverse_lazy('users:index')), format_lazy( _('When using a mobile or desktop application for Tiny Tiny RSS, use ' 'the URL /tt-rss or ' '/tt-rss-app for connecting.')) ] class TTRSSApp(app_module.App): """FreedomBox app for TT-RSS.""" app_id = 'ttrss' _version = 6 def __init__(self) -> None: """Create components for the app.""" super().__init__() groups = {'feed-reader': _('Read and subscribe to news feeds')} info = app_module.Info(app_id=self.app_id, version=self._version, name=_('Tiny Tiny RSS'), icon_filename='ttrss', short_description=_('News Feed Reader'), description=_description, manual_page='TinyTinyRSS', clients=manifest.clients, donation_url='https://www.patreon.com/cthulhoo') self.add(info) menu_item = menu.Menu('menu-ttrss', info.name, info.short_description, info.icon_filename, 'ttrss:index', parent_url_name='apps') self.add(menu_item) shortcut = frontpage.Shortcut('shortcut-ttrss', info.name, short_description=info.short_description, icon=info.icon_filename, url='/tt-rss', clients=info.clients, login_required=True, allowed_groups=list(groups)) self.add(shortcut) packages = Packages('packages-ttrss', [ 'tt-rss', 'postgresql', 'dbconfig-pgsql', 'php-pgsql', 'python3-psycopg2' ]) self.add(packages) dropin_configs = DropinConfigs('dropin-configs-ttrss', [ '/etc/apache2/conf-available/tt-rss-plinth.conf', ]) self.add(dropin_configs) firewall = Firewall('firewall-ttrss', info.name, ports=['http', 'https'], is_external=True) self.add(firewall) webserver = Webserver('webserver-ttrss', 'tt-rss-plinth', urls=['https://{host}/tt-rss'], last_updated_version=5) self.add(webserver) daemon = Daemon('daemon-ttrss', 'tt-rss') self.add(daemon) users_and_groups = UsersAndGroups('users-and-groups-ttrss', groups=groups) self.add(users_and_groups) backup_restore = TTRSSBackupRestore('backup-restore-ttrss', **manifest.backup) self.add(backup_restore) def enable(self): """Enable components and API access.""" privileged.enable_api_access() # Try to set the domain to one of the available TLS domains domain = privileged.get_domain() if not domain or domain == 'localhost': from plinth.modules import names domain = next(names.get_available_tls_domains(), None) privileged.set_domain(domain) super().enable() def setup(self, old_version): """Install and configure the app.""" privileged.pre_setup() super().setup(old_version) privileged.setup() if not old_version: self.enable() def uninstall(self): """De-configure and uninstall the app.""" privileged.uninstall() super().uninstall() def force_upgrade(self, packages): """Force update package to resolve conffile prompts.""" if 'tt-rss' not in packages: return False # Allow tt-rss any lower version to upgrade to 21.* package = packages['tt-rss'] if Version(package['new_version']) > Version('22~'): return False install(['tt-rss'], force_configuration='new') privileged.setup() return True class TTRSSBackupRestore(BackupRestore): """Component to backup/restore TT-RSS.""" def backup_pre(self, packet): """Save database contents.""" super().backup_pre(packet) privileged.dump_database() def restore_post(self, packet): """Restore database contents.""" super().restore_post(packet) privileged.restore_database()