diff --git a/data/scripting_support/python/konversation/dbus.py b/data/scripting_support/python/konversation/dbus.py index 1584633d..d0059e52 100644 --- a/data/scripting_support/python/konversation/dbus.py +++ b/data/scripting_support/python/konversation/dbus.py @@ -1,101 +1,100 @@ -#!/usr/bin/env python # -*- coding: utf-8 -*- # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License as # published by the Free Software Foundation; either version 2 of # the License or (at your option) version 3 or any later version # accepted by the membership of KDE e.V. (or its successor appro- # ved by the membership of KDE e.V.), which shall act as a proxy # defined in Section 14 of version 3 of the license. # # 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 General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see http://www.gnu.org/licenses/. # # Copyright (C) 2011 Eike Hein """ This module provides several functions and attributes for use in interacting with Konversation's D-Bus API. The 'connection' and 'target' attributes are fetched from the arguments given to your script by Konversation when you import this module. Modify the 'default_message_prefix' attribute if you want to prefix all messages sent through the say/info/error functions with a common string rather than pass a prefix with each call (but doing so overrides this fallback attribute). This module is considered EXPERIMENTAL at this time and not part of the public, stable scripting interface. """ import subprocess import sys __all__ = ('info', 'error', 'say') # Functions def info(message, prefix=None): """Shows an info message in the active tab in Konversation.""" _dispatch('info', _prefix(message, prefix)) def error(message, prefix=None, exit=False): """Shows an error message in the active tab in Konversation.""" _dispatch('error', _prefix(message, prefix)) if exit: sys.exit(1) def say(message, prefix=None): """ Instructs Konversation to send a message to the destination (a channel or nickname in a particular connection context) the importing script was given as arguments. """ _dispatch('say', connection, target, _prefix(message, prefix)) def _prefix(message, prefix): """Prefix message, using the argument or falling back to the global.""" if prefix is None: prefix = default_message_prefix return prefix + message def _dispatch(*args): """Dispatch to Konversation's D-Bus API.""" subprocess.call(_dbus_command + args) # Attributes try: connection = sys.argv[1] target = sys.argv[2] except IndexError: connection = None target = None default_message_prefix = '' _dbus_command = ('qdbus', 'org.kde.konversation', '/irc')