Changeset 940 for kde/dbus/knotify-client

Timestamp:

Dec 9, 2010, 8:25:47 PM (14 years ago)

Author:

joergs

Message:

cleanup, added comments, get list of events

File:

• kde/dbus/knotify-client (modified) (3 diffs, 1 prop)

kde/dbus/knotify-client

@@ -2 +2 @@
 # -*- coding: utf-8 -*-
 
+"""
+knotify-client sends messages to the KDE knotify daemon.
+KDE applications can define different types of messages
+and theses types define different actions
+(display message, play sound, start program, ...)
+
+tested on KDE 4.3.5 (openSUSE 11.2)
+"""
+
+# $Id$
+
+
 import sys
 import dbus
+from os import system
 from pprint import pprint
 from time import sleep
@@ -11 +24 @@
 from optparse import OptionParser
 
-parser = OptionParser()
+
+parser = OptionParser(usage = "\n  %prog [options] 'text message to send to knotify'\n  %prog --appevents APPLICATION")
 #parser.add_argument('message', type=string, nargs='+',
 #                   help='message text to send')
 parser.add_option('--event', dest='event', default="notification",
-                   help='event')
-parser.add_option('--app', dest='app', default="kde",
-                   help='fromApp')
+                   help='event (default: %default). Use --appevents to get list of events')
+parser.add_option('--app', dest='application', default="kde",
+                   help='event from application (default: %default)')
 parser.add_option('--title', dest='title', default=sys.argv[0],
-                   help='event')
+                   help='text in title of knotify message')
 parser.add_option('--timeout', dest='timeout', type=int, default=0,
                    help='timeout in seconds. Without timeout, message will stay until it is confirmed, but ' + sys.argv[0] + ' will return immedialy')
+parser.add_option('--appevents', metavar='APPLICATION', dest='appevents',
+                   help='print list of events for application')
 (options, args) = parser.parse_args()
 
 print "options:"
 pprint(options)
+
+if options.appevents:
+    ressource = options.appevents + "/" + options.appevents + ".notifyrc"
+    system("kread-ressource.py --type data " + ressource )
+    exit(0)
 
 message = " ".join( args )
@@ -53 +74 @@
 # specifiing timeout as parameter does not show a effect,
 # therefore notification is closed manually after timeout
-id = knotify.event( options.event, options.app, [], options.title, message, [], [], options.timeout, dbus_interface="org.kde.KNotify")
+id = knotify.event( options.event, options.application, [], options.title, message, [], [], options.timeout, dbus_interface="org.kde.KNotify")
 
 if options.timeout > 0: