# # 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 . # """ Plinth module to configure Privoxy. """ from django.utils.translation import ugettext_lazy as _ from plinth import actions from plinth import action_utils from plinth import cfg from plinth import service as service_module from plinth.utils import format_lazy version = 1 is_essential = False depends = ['apps'] title = _('Web Proxy (Privoxy)') description = [ _('Privoxy is a non-caching web proxy with advanced filtering ' 'capabilities for enhancing privacy, modifying web page data and ' 'HTTP headers, controlling access, and removing ads and other ' 'obnoxious Internet junk. '), format_lazy( _('You can use Privoxy by modifying your browser proxy settings to ' 'your {box_name} hostname (or IP address) with port 8118. ' 'While using Privoxy, you can see its configuration details and ' 'documentation at ' 'http://config.privoxy.org/ ' 'or http://p.p.'), box_name=_(cfg.box_name)) ] service = None def init(): """Intialize the module.""" menu = cfg.main_menu.get('apps:index') menu.add_urlname(title, 'glyphicon-cloud-upload', 'privoxy:index', 1000) global service service = service_module.Service( 'privoxy', title, is_external=False, enabled=is_enabled()) def setup(helper, old_version=None): """Install and configure the module.""" helper.install(['privoxy']) helper.call('post', actions.superuser_run, 'privoxy', ['setup']) helper.call('post', service.notify_enabled, None, True) def get_status(): """Get the current settings from server.""" return {'enabled': is_enabled(), 'is_running': is_running()} def is_enabled(): """Return whether the module is enabled.""" return action_utils.service_is_enabled('privoxy') def is_running(): """Return whether the service is running.""" return action_utils.service_is_running('privoxy') def enable(should_enable): """Enable/disable the module.""" sub_command = 'enable' if should_enable else 'disable' actions.superuser_run('privoxy', [sub_command]) service.notify_enabled(None, should_enable) def diagnose(): """Run diagnostics and return the results.""" results = [] results.append(action_utils.diagnose_port_listening(8118, 'tcp4')) results.append(action_utils.diagnose_port_listening(8118, 'tcp6')) results.append(action_utils.diagnose_url('https://www.debian.org')) results.extend(diagnose_url_with_proxy()) return results def diagnose_url_with_proxy(): """Run a diagnostic on a URL with a proxy.""" url = 'https://debian.org/' results = [] for address in action_utils.get_addresses(): if address['kind'] == '6': address['address'] = '[{0}]'.format(address['address']) proxy = 'http://{host}:8118/'.format(host=address['address']) if address['kind'] == '4': env = {'http_proxy': proxy} else: env = {'https_proxy': proxy} result = action_utils.diagnose_url(url, kind=address['kind'], env=env) result[0] = _('Access {url} with proxy {proxy} on tcp{kind}') \ .format(url=url, proxy=proxy, kind=address['kind']) results.append(result) return results