WebOS Internals - User contributions [en]

Tutorials Export Text Messages Using Perl

2010-08-17T07:07:30Z

Newacct:

This is a rather simple script to export text messages in a readable format from [[PalmDatabase.db3 File|PalmDatabase.db3]]. You must first import PalmDatabase.db3 to your pc from /var/luna/data/dbdata /PalmDatabase.db3 on the Pre. 

Run this code (assuming PalmDatabase.db3 is in the same folder and the name is unchanged) and it will spit out information in an "ID - NAME" format. Copy the ID for the second script.
<source lang="perl">
#!/usr/bin/perl

use DBI;

$dbh = DBI->connect( "dbi:SQLite:PalmDatabase.db3" ) || die "Cannot connect: $DBI::errstr";

$res = $dbh->selectall_arrayref( q( SELECT firstName, lastName,id FROM com_palm_messaging_data_ChatThread WHERE _class_id = 11) );
foreach( @$res ) {

$first = $_->[0];
$last = $_->[1];
$id = $_->[2];
print "$id - $first $last \n";

}
</source>

 
Run the following as "perl script2.pl id yourname otherpersonsname" format. The last 2 variables are optional. Set the $time_zone variable as needed. In the code below, it is set for Central Standard Time. See [http://search.cpan.org/~drolsky/DateTime-0.55/lib/DateTime.pm#%22Set%22_Methods CPAN#DateTime] for more info.
<source lang="perl">
#!/usr/bin/perl

use DBI;
use DateTime;

($input,$me,$you) = @ARGV;

$time_zone = 'America/Chicago';

if ($me eq '')
{
$me = 'Me';
}

if ($you eq '')
{
$you = 'You';
}

$me.= " : ";
$you.= " : ";

$dbh = DBI->connect( "dbi:SQLite:PalmDatabase.db3" ) || die "Cannot connect: $DBI::errstr";

$res = $dbh->selectall_arrayref( qq( SELECT belongs_id FROM com_palm_messaging_data_ChatThread_com_palm_pim_FolderEntry_Chat_Messages WHERE has_id = $input) );

foreach( @$res ) {

$id = $_->[0];
$temp = $dbh->selectall_arrayref( qq( SELECT timeStamp, messageText,flags FROM com_palm_pim_FolderEntry WHERE messageType = 'SMS' and id=$id) );
foreach $x (@$temp)
{
$time = $x->[0];
$time = $time/1000;
$tofrom = find_code ( $x->[2] );
$dt = DateTime->from_epoch(epoch => $time);
$dt->set_time_zone( $time_zone );

print $dt->month.'/'.$dt->day.'/'.$dt->year.' '.$dt->hour.':'.$dt->minute.':'.$dt->second.' '.$tofrom.$x->[1];
}

print "\n";

}

sub find_code {
($code) = @_;
if ($code == 133)
{
return $me;
}

if ($code == 5)
{
return $you;
}

return "Unknown";

}
</source>

OpenGL Triangle of Doom

2010-06-26T15:45:26Z

Newacct:

[[Category:SDL]]

== The demo app ==

[[Image:Opengldemo.png|160px|left]]This app is loosely based on a [http://wiki.maemo.org/SimpleGL_Example an OpenGL example from the maemo project] and is ported from X11 OpenGL code to SDL to function in webos

First, follow the tutorial [[WebOS Internals PDK]] to set up the cross compilation environment.

Next, copy the source below into a file doomtriangle.c

Now run scratchbox2 with the webos / pre mapping file:
$ sb2 -M /srv/preware/cross-compile/staging/mapping-armv7

You will get a different prompt indicating you are in a scratchbox shell, like:
[SB2 mapping-armv7 armv7] $

Now just

<pre>
export LIBS="-Wl,-rpath-link=/usr/local/lib -L/usr/local/lib"
gcc -I/usr/local/include/SDL $LIBS -o doomtriangle doomtriangle.c -lSDL -lGLESv2
</pre>

Now, copy the resulting binary doomtriangle to your pre and run it.

===doomtriangle.c===

<pre>
#include <stdio.h>
#include <stdlib.h>
#include "SDL.h"
#include "SDL_opengles.h"
#include "SDL_video.h"
#include <math.h>
#include <sys/time.h>
#include <unistd.h>
#include <string.h>

const char* vertexSrc = "attribute vec4 position; varying mediump vec2 pos; void main() { gl_Position = position; pos = position.xy; }";
const char* fragmentSrc = "varying mediump vec2 pos; uniform mediump float phase; void main() { gl_FragColor = vec4(1, 1, 1, 1) * sin((pos.x * pos.x + pos.y * pos.y) * 40.0 + phase); }";
//const char* fragmentSrc = "varying mediump vec2 pos; uniform mediump float phase; void main() { gl_FragColor = vec4(1, 1, 1, 1) * step(pos.x * pos.x + pos.y * pos.y, phase * 0.2); }";

void printShaderInfoLog(GLuint shader) {
GLint length;
glGetShaderiv(shader, GL_INFO_LOG_LENGTH, &length);
if(length) {
char* buffer = malloc( sizeof(char) * length ) ;
glGetShaderInfoLog(shader, length, NULL, buffer);
printf("%s", buffer);
free( buffer ) ;
GLint success;
glGetShaderiv(shader, GL_COMPILE_STATUS, &success);
if(success != GL_TRUE) {
exit(1);
}
}
}

GLuint createShader(GLenum type, const char* pSource) {
GLuint shader = glCreateShader(type);
glShaderSource(shader, 1, &pSource, NULL);
glCompileShader(shader);
printShaderInfoLog(shader);
return shader;
}

int phaseLocation ;

const float vertexArray[] = {
0, -1, 0, 1,
1, 1, 0, 1,
-1, 1, 0, 1
};

#define false 0
#define true 1
#define bool int

void render() {
static float offset = 0;

glViewport(0, 0, 320, 480 ) ;
glClearColor(0, 1, 0, 1);
glClear(GL_COLOR_BUFFER_BIT);

glUniform1f(phaseLocation, offset);

glVertexAttribPointer(0, 4, GL_FLOAT, false, 0, vertexArray);
glEnableVertexAttribArray(0);
glDrawArrays(GL_TRIANGLE_STRIP, 0, 3);

SDL_GL_SwapBuffers( ) ;

offset = fmodf(offset + 0.2, 2*3.141f);
}

int main() {

if( SDL_Init( SDL_INIT_VIDEO ) < 0 ) {
fprintf( stderr, "Couldn't initialize SDL: %s\n", SDL_GetError() ) ;
exit( 1 ) ;
}

if ( SDL_SetVideoMode( 320, 480, 32, SDL_OPENGLES ) == NULL ) {
fprintf(stderr, "Couldn't set GL mode: %s\n", SDL_GetError());
SDL_Quit();
exit(1);
}

printf("Screen BPP: %d\n", SDL_GetVideoSurface()->format->BitsPerPixel);
printf("\n");
printf( "Vendor : %s\n", glGetString( GL_VENDOR ) );
printf( "Renderer : %s\n", glGetString( GL_RENDERER ) );
printf( "Version : %s\n", glGetString( GL_VERSION ) );
printf( "Extensions : %s\n", glGetString( GL_EXTENSIONS ) );
printf("\n");

GLuint shaderProgram = glCreateProgram();
GLuint vertexShader = createShader(GL_VERTEX_SHADER, vertexSrc);
GLuint fragmentShader = createShader(GL_FRAGMENT_SHADER, fragmentSrc);

glAttachShader(shaderProgram, vertexShader);
glAttachShader(shaderProgram, fragmentShader);

glLinkProgram(shaderProgram);

glUseProgram(shaderProgram);

phaseLocation = glGetUniformLocation(shaderProgram, "phase");
if(phaseLocation < 0) {
printf("Unable to get uniform location\n");
return 1;
}

bool quit = false;

//timeval startTime;
//timezone tz;
//gettimeofday(&startTime, &tz);
int numFrames = 0;

while(!quit) {
SDL_Event event ;
while( SDL_PollEvent( &event ) ) {
if( event.type == SDL_KEYDOWN && event.key.keysym.sym == SDLK_ESCAPE ) quit = 1 ;
}
render();
numFrames++;
if(numFrames % 100 == 0) {
//timeval now;
//gettimeofday(&now, &tz);
//float delta = now.tv_sec - startTime.tv_sec + (now.tv_usec - startTime.tv_usec) * 0.000001f;
//printf("fps: %f\n", numFrames / delta);
}
}
return 0;
}
</pre>

Introspecting Dbus

2010-03-19T04:57:51Z

Newacct:

__FORCETOC__

=Palm/DBUS Namspaces=

(these should be split up into Palm and 3rd-party lists at some point)
{{article-three-columns
|width1=30%
|width2=30%
|column1=
* com.palm.accounts
* com.palm.accountservices
* com.palm.amazon
* com.palm.applicationManager
* com.palm.audio
* com.palm.bluetooth
* com.palm.browserServer
* com.palm.bus
* com.palm.calendar
* com.palm.certificatemanager
* com.palm.connectionmanager
* com.palm.contacts
* com.palm.crotest
* com.palm.customization
* com.palm.data.carriernetworksettings

|column2=
* com.palm.dataimport
* com.palm.deviceprofile
* com.palm.display
* com.palm.downloadmanager
* com.palm.hidd
* com.palm.keys
* com.palm.location
* com.palm.lunabus
* com.palm.mail
* com.palm.mediadb
* com.palm.mediaevents
* com.palm.messaging
* com.palm.office
* com.palm.omadm
* com.palm.pdf

|column3=
* com.palm.photos
* com.palm.pimsync
* com.palm.power
* com.palm.provisioning
* com.palm.preferences
* com.palm.superlog
* com.palm.systemmanager
* com.palm.systemservice
* com.palm.taskScheduler
* com.palm.telephony
* com.palm.update
* com.palm.wan
* com.palm.wifi

}}
=Python Code=

Below is a Python app (shamelessly ripped from http://code.google.com/p/dbus-tools/wiki/DBusCli) for doing some dbus introspection...

Use the link above for usage help.

<source lang="python">
#! /usr/bin/env python

import dbus, sys
from xml.dom import minidom
from optparse import OptionParser

class Signature(dbus.Signature):
def Variant(x):
return x

_dbus_types = {
"{": dbus.Dictionary,
"(": dbus.Struct,
"a": dbus.Array,
"y": dbus.Byte,
"b": dbus.Boolean,
"n": dbus.Int16,
"q": dbus.UInt16,
"i": dbus.Int32,
"u": dbus.UInt32,
"x": dbus.Int64,
"t": dbus.UInt64,
"d": dbus.Double,
"s": dbus.String,
"o": dbus.ObjectPath,
"g": dbus.Signature,
"v": Variant }

def __iter__(self):
return ( Signature(x) for x in dbus.Signature.__iter__(self) )

def get_type(self):
return self._dbus_types[self[0]]

def container_type(self):
if self.startswith("("): return dbus.Struct
elif self.startswith("a{"): return dbus.Dictionary
elif self.startswith("a"): return dbus.Array
else: return None

def container_content(self):
if self.container_type() == dbus.Struct: return Signature(self[1:-1])
elif self.container_type() == dbus.Dictionary: return Signature(self[2:-1])
elif self.container_type() == dbus.Array: return Signature(self[1:])
else: return None

def tostring(self):
if len(tuple(self)) > 1:
return ", ".join( x.tostring() for x in self )

t, c = self.container_type(), self.container_content()
if t is None:
return self.get_type().__name__
elif t == dbus.Array:
return c.tostring() + "[]"
else:
return t.__name__ + " {" + c.tostring() + "}"

class Object(object):
class XMLChild(object):
def __init__(self, obj, name):
self.obj = obj
self.name = name
self.xml = None

def node(self):
if not self.xml:
for iface in self.parent().getElementsByTagName(self.tag):
if iface.getAttribute('name') == self.name:
self.xml = iface
return self.xml

return self.xml

def children(self, tag):
for method in self.node().getElementsByTagName(tag):
name = method.getAttribute('name')
if name:
yield name

class Interface(XMLChild):
tag = "interface"

def parent(self):
return self.obj.introspect()

def methods(self):
return self.children('method')

def signals(self):
return self.children('signal')

def method(self, name):
return self.obj.method(name, self.name)

def signal(self, name):
return self.obj.signal(name, self.name)

class MethodSignal(XMLChild):
class Argument:
def __getattr__(self, x):
return self.xml.getAttribute(x)

def __init__(self, obj, name, iface):
Object.XMLChild.__init__(self, obj, name)
self.iface = iface

def parent(self):
return self.obj.interface(self.iface).node()

def args(self):
for arg in self.node().getElementsByTagName("arg"):
argobj = Object.MethodSignal.Argument()
argobj.xml = arg
assert argobj.type
argobj.signature = Signature(argobj.type)
yield argobj

class Method(MethodSignal):
tag = "method"

def inargs(self):
for arg in self.args():
if arg.direction == "in":
yield arg

def outargs(self):
for arg in self.args():
if arg.direction == "out":
yield arg

class Signal(MethodSignal):
tag = "signal"

def outargs(self):
for arg in self.args():
assert arg.direction != "out"
return []

def inargs(self):
for arg in self.args():
assert not arg.direction or arg.direction == "in"
yield arg

def __init__(self, bus, service, path):
self.bus = bus
self.service = service
self.path = path
self.object = None
self.intr_data = None
self.cached_childrens = {}
self.cached_interfaces = {}
self.cached_methods = {}
self.cached_signals = {}

def get_object(self):
if not self.object:
self.object = self.bus.get_object(self.service, self.path)
return self.object

def introspect(self):
if not self.intr_data:
self.intr_data = minidom.parseString(self.get_object().Introspect())
return self.intr_data

def children(self):
intr_data = self.introspect()
for node in intr_data.getElementsByTagName('node'):
name = node.getAttribute("name")
if node == intr_data.documentElement or not name:
continue
else:
yield name

def interfaces(self):
for node in self.introspect().getElementsByTagName('interface'):
name = node.getAttribute("name")
if name:
yield name

def methods(self, iface):
return self.interface(iface).methods()

def signals(self, iface):
return self.interface(iface).signals()

def _cached(self, list, name, constr, *constr_args):
if name not in list:
list[name] = constr(*constr_args)
return list[name]

def child(self, name):
if self.path == '/':
full_name = '/' + name
else:
full_name = self.path + '/' + name
return self._cached(self.cached_childrens, full_name, Object, self.bus, self.service, full_name)

def interface(self, name):
return self._cached(self.cached_interfaces, name, Object.Interface, self, name)

def method(self, name, iface):
full_name = iface + '.' + name
return self._cached(self.cached_methods, full_name, Object.Method, self, name, iface)

def signal(self, name, iface):
full_name = iface + '.' + name
return self._cached(self.cached_methods, full_name, Object.Signal, self, name, iface)

def nonempty_generator(generator):
try:
x = generator.next() # this is not good; it loses the first thing generated by the generator
return True
except StopIteration:
return False

def nonempty_iface(iface):
if options.signals and nonempty_generator(iface.signals()):
return True
if nonempty_generator(iface.methods()):
return True
return False

def nonempty_object(obj, recursive = True):
# Check wether an object has a method or a signal (of options.signals)
# If recursive is True, then it will also return True if the object don't has any method nor signal but one of its child has
try:
for iface in obj.interfaces():
if nonempty_iface(obj.interface(iface)):
return True

if not recursive:
return False

for child in obj.children():
if nonempty_object(obj.child(child)):
return True

return False
except: # HACK: HAL returns a non-existent object in the list of chilren, ignore this error
return False

opts = OptionParser()
opts.add_option("-a", "--all", help="Equivalent to -u -e -s -t", action="store_true", default=False)
opts.add_option("-c", "--completion", help="Set this ON if you are ZSH", action="store_true", default=False)
opts.add_option("-e", "--empty", help="Also show empty services/objects", action="store_true", default=False)
opts.add_option("-s", "--signals", help="Also show signals", action="store_true", default=False)
opts.add_option("-t", "--activatables", help="Also show activatables services", action="store_true", default=False)
opts.add_option("-u", "--unnamed", help="Also show unnamed services (most likely clients)", action="store_true", default=False)
opts.add_option("-y", "--system-bus", help="Work on system bus instead of session bus", action="store_true", default=False)
options, args = opts.parse_args()
if options.all:
options.empty = options.signals = options.unnamed = options.activatables = True

if options.system_bus:
bus = dbus.SystemBus()
else:
bus = dbus.SessionBus()

if len(args) == 0:
def nonempty_service(service):
# A service is empty if all its (registered) objects are empty
return nonempty_object(Object(bus, service, '/'))

def named(service):
return not service.startswith(':')

dbusd = Object(bus, 'org.freedesktop.DBus', '/')
services = dbusd.get_object().ListNames(dbus_interface = 'org.freedesktop.DBus')
if options.activatables:
services += dbusd.get_object().ListActivatableNames(dbus_interface = 'org.freedesktop.DBus')
if not options.unnamed: # Delete unnamed services if needed
services = filter(named, services)
if not options.empty: # Delete empty services if needed
services = filter(nonempty_service, services)

for service in services:
print service
elif len(args) == 1:
def obj_path(obj):
return obj.path

def list_objects(root_obj):
# Return a list of objects contained in root_obj, including root_obj
# but excluding (including root_obj) empty objects if needed
if not options.empty and not nonempty_object(root_obj):
# The object and its children are empty, no need to continue
return []
if not options.empty and not nonempty_object(root_obj, False):
# The object is empty but one of its children isn't, so continue
result = []
else:
result = [root_obj]

for child in root_obj.children():
result.extend(list_objects(root_obj.child(child)))
return result

for obj in map(obj_path, list_objects(Object(bus, args[0], '/'))):
print obj
elif len(args) == 2:
def pprint(method, signal = False):
def pprint_arg(arg):
s = arg.signature
n = arg.name
x = s.tostring()
if n:
x += " " + n
return x

inargs = list(method.inargs())
outargs = list(method.outargs())

if signal:
print " signal",
elif len(outargs) == 0:
print " void",
else:
print " " + ", ".join(map(pprint_arg, outargs)),

print method.name + '(' + ", ".join(map(pprint_arg, inargs)) + ')'

obj = Object(bus, args[0], args[1])

if options.completion:
for ifname in obj.interfaces():
iface = obj.interface(ifname)
for x in iface.methods():
print x
print ifname + "." + x
if options.signals:
for x in iface.signals():
print x
print ifname + "." + x
else:
for ifname in obj.interfaces():
iface = obj.interface(ifname)
if not options.empty and not nonempty_iface(iface):
continue
print "Interface %s:" % ifname

i = 0
for methodname in iface.methods():
pprint(iface.method(methodname))
i += 1
if i:
print

if not options.signals:
if not i:
print
continue

j = 0
for signalname in iface.signals():
pprint(iface.signal(signalname), True)
j += 1
if j or not i:
print
else:
def indent(level):
sys.stdout.write(" "*level)

def print_arg(arg, name):
def dump(data, lvl):
indent(lvl)

if type(data) in (dbus.Struct, dbus.Array):
print type(data).__name__
for x in arg:
dump(x, lvl + 1)
print
elif type(data) == dbus.Dictionary:
print type(data).__name__
for k, v in data.iteritems():
dump(k, lvl+1)
print ":",
dump(v, 0)
print
else:
print data,

if name:
print name,"= ",
dump(arg, 0)
print

service, path, method = args[0:3]
obj = Object(bus, service, path)
args = args[3:]
if "." in method:
iface, method = method.rsplit(".", 1)
else:
iface = None
try:
for iface in obj.interfaces():
if method in list(obj.interface(iface).methods()):
break
except:
raise

if options.completion:
try:
for i, arg in enumerate(obj.interface(iface).method(method).inargs()):
if i == len(args):
print arg.signature.tostring(),
if arg.name:
print arg.name,
print
except:
pass

sys.exit(0)

args2 = []
for arg in args:
if len(arg) >= 2 and arg[0] == '%':
if arg[1] == '%':
args2.append('%' + arg[2:])
else:
args2.append(eval(arg[1:], {}))
else:
args2.append(arg)
args = args2

ret = obj.get_object().get_dbus_method(method, iface)(*args)
try:
outargs = list(obj.method(method, iface).outargs())
except:
outargs = []

if not isinstance(ret, tuple) or isinstance(ret, dbus.Struct):
ret = (ret,)

for i, arg in enumerate(ret):
if len(outargs) > i:
print_arg(arg, outargs[i].name)
else:
print_arg(arg, None)
</source>

Introspecting Dbus

2010-02-28T09:17:49Z

Newacct:

__FORCETOC__

=Palm/DBUS Namspaces=

(these should be split up into Palm and 3rd-party lists at some point)
{{article-three-columns
|width1=30%
|width2=30%
|column1=
* com.palm.accounts
* com.palm.accountservices
* com.palm.amazon
* com.palm.applicationManager
* com.palm.audio
* com.palm.bluetooth
* com.palm.browserServer
* com.palm.bus
* com.palm.calendar
* com.palm.certificatemanager
* com.palm.connectionmanager
* com.palm.contacts
* com.palm.crotest
* com.palm.customization
* com.palm.data.carriernetworksettings

|column2=
* com.palm.dataimport
* com.palm.deviceprofile
* com.palm.display
* com.palm.downloadmanager
* com.palm.hidd
* com.palm.keys
* com.palm.location
* com.palm.lunabus
* com.palm.mail
* com.palm.mediadb
* com.palm.mediaevents
* com.palm.messaging
* com.palm.office
* com.palm.omadm
* com.palm.pdf

|column3=
* com.palm.photos
* com.palm.pimsync
* com.palm.power
* com.palm.provisioning
* com.palm.preferences
* com.palm.superlog
* com.palm.systemmanager
* com.palm.systemservice
* com.palm.taskScheduler
* com.palm.telephony
* com.palm.update
* com.palm.wan
* com.palm.wifi

}}
=Python Code=

Below is a Python app (shamelessly ripped from http://code.google.com/p/dbus-tools/wiki/DBusCli) for doing some dbus introspection...

Use the link above for usage help.

<source lang="python">
#! /usr/bin/env python

import dbus, sys
from xml.dom import minidom
from optparse import OptionParser

class Signature(dbus.Signature):
def Variant(x):
return x

_dbus_types = {
"{": dbus.Dictionary,
"(": dbus.Struct,
"a": dbus.Array,
"y": dbus.Byte,
"b": dbus.Boolean,
"n": dbus.Int16,
"q": dbus.UInt16,
"i": dbus.Int32,
"u": dbus.UInt32,
"x": dbus.Int64,
"t": dbus.UInt64,
"d": dbus.Double,
"s": dbus.String,
"o": dbus.ObjectPath,
"g": dbus.Signature,
"v": Variant }

def __iter__(self):
return ( Signature(x) for x in dbus.Signature.__iter__(self) )

def get_type(self):
return self._dbus_types[self[0]]

def container_type(self):
if self.startswith("("): return dbus.Struct
elif self.startswith("a{"): return dbus.Dictionary
elif self.startswith("a"): return dbus.Array
else: return None

def container_content(self):
if self.container_type() == dbus.Struct: return Signature(self[1:-1])
elif self.container_type() == dbus.Dictionary: return Signature(self[2:-1])
elif self.container_type() == dbus.Array: return Signature(self[1:])
else: return None

def tostring(self):
if len(tuple(self)) > 1:
return ", ".join( x.tostring() for x in self )

t, c = self.container_type(), self.container_content()
if t is None:
return self.get_type().__name__
elif t == dbus.Array:
return c.tostring() + "[]"
else:
return t.__name__ + " {" + c.tostring() + "}"

class Object(object):
class XMLChild(object):
def __init__(self, obj, name):
self.obj = obj
self.name = name
self.xml = None

def node(self):
if not self.xml:
for iface in self.parent().getElementsByTagName(self.tag):
if iface.getAttribute('name') == self.name:
self.xml = iface
return self.xml

return self.xml

def children(self, tag):
for method in self.node().getElementsByTagName(tag):
name = method.getAttribute('name')
if name:
yield name

class Interface(XMLChild):
tag = "interface"

def parent(self):
return self.obj.introspect()

def methods(self):
return self.children('method')

def signals(self):
return self.children('signal')

def method(self, name):
return self.obj.method(name, self.name)

def signal(self, name):
return self.obj.signal(name, self.name)

class MethodSignal(XMLChild):
class Argument:
def __getattr__(self, x):
return self.xml.getAttribute(x)

def __init__(self, obj, name, iface):
Object.XMLChild.__init__(self, obj, name)
self.iface = iface

def parent(self):
return self.obj.interface(self.iface).node()

def args(self):
for arg in self.node().getElementsByTagName("arg"):
argobj = Object.MethodSignal.Argument()
argobj.xml = arg
assert(argobj.type)
argobj.signature = Signature(argobj.type)
yield argobj

class Method(MethodSignal):
tag = "method"

def inargs(self):
for arg in self.args():
if arg.direction == "in":
yield arg

def outargs(self):
for arg in self.args():
if arg.direction == "out":
yield arg

class Signal(MethodSignal):
tag = "signal"

def outargs(self):
for arg in self.args():
if arg.direction == "out":
assert(0)
return []

def inargs(self):
for arg in self.args():
assert(not arg.direction or arg.direction == "in")
yield arg

def __init__(self, bus, service, path):
self.bus = bus
self.service = service
self.path = path
self.object = None
self.intr_data = None
self.cached_childrens = {}
self.cached_interfaces = {}
self.cached_methods = {}
self.cached_signals = {}

def get_object(self):
if not self.object:
self.object = self.bus.get_object(self.service, self.path)
return self.object

def introspect(self):
if not self.intr_data:
self.intr_data = minidom.parseString(self.get_object().Introspect())
return self.intr_data

def children(self):
intr_data = self.introspect()
for node in intr_data.getElementsByTagName('node'):
name = node.getAttribute("name")
if node == intr_data.documentElement or not name:
continue
else:
yield name

def interfaces(self):
for node in self.introspect().getElementsByTagName('interface'):
name = node.getAttribute("name")
if name:
yield name

def methods(self, iface):
return self.interface(iface).methods()

def signals(self, iface):
return self.interface(iface).signals()

def _cached(self, list, name, constr, *constr_args):
if not (name in list):
list[name] = constr(*constr_args)
return list[name]

def child(self, name):
if self.path == '/':
full_name = '/' + name
else:
full_name = self.path + '/' + name
return self._cached(self.cached_childrens, full_name, Object, self.bus, self.service, full_name)

def interface(self, name):
return self._cached(self.cached_interfaces, name, Object.Interface, self, name)

def method(self, name, iface):
full_name = iface + '.' + name
return self._cached(self.cached_methods, full_name, Object.Method, self, name, iface)

def signal(self, name, iface):
full_name = iface + '.' + name
return self._cached(self.cached_methods, full_name, Object.Signal, self, name, iface)

def nonempty_generator(generator):
try:
x = generator.next()
return True
except StopIteration:
return False

def nonempty_iface(iface):
if options.signals and nonempty_generator(iface.signals()):
return True
if nonempty_generator(iface.methods()):
return True
return False

def nonempty_object(obj, recursive = True):
# Check wether an object has a method or a signal (of options.signals)
# If recursive is True, then it will also return True if the object don't has any method nor signal but one of its child has
try:
for iface in obj.interfaces():
if nonempty_iface(obj.interface(iface)):
return True

if not recursive:
return False

for child in obj.children():
if nonempty_object(obj.child(child)):
return True

return False
except: # HACK: HAL returns a non-existent object in the list of chilren, ignore this error
return False

opts = OptionParser()
opts.add_option("-a", "--all", help="Equivalent to -u -e -s -t", action="store_true", default=False)
opts.add_option("-c", "--completion", help="Set this ON if you are ZSH", action="store_true", default=False)
opts.add_option("-e", "--empty", help="Also show empty services/objects", action="store_true", default=False)
opts.add_option("-s", "--signals", help="Also show signals", action="store_true", default=False)
opts.add_option("-t", "--activatables", help="Also show activatables services", action="store_true", default=False)
opts.add_option("-u", "--unnamed", help="Also show unnamed services (most likely clients)", action="store_true", default=False)
opts.add_option("-y", "--system-bus", help="Work on system bus instead of session bus", action="store_true", default=False)
options, args = opts.parse_args()
if options.all:
options.empty = options.signals = options.unnamed = options.activatables = True

if options.system_bus:
bus = dbus.SystemBus()
else:
bus = dbus.SessionBus()

if len(args) == 0:
def nonempty_service(service):
# A service is empty if all its (registered) objects are empty
return nonempty_object(Object(bus, service, '/'))

def named(service):
return not service.startswith(':')

dbusd = Object(bus, 'org.freedesktop.DBus', '/')
services = dbusd.get_object().ListNames(dbus_interface = 'org.freedesktop.DBus')
if options.activatables:
services += dbusd.get_object().ListActivatableNames(dbus_interface = 'org.freedesktop.DBus')
if not options.unnamed: # Delete unnamed services if needed
services = filter(named, services)
if not options.empty: # Delete empty services if needed
services = filter(nonempty_service, services)

for service in services:
print service
elif len(args) == 1:
def obj_path(obj):
return obj.path

def list_objects(root_obj):
# Return a list of objects contained in root_obj, including root_obj
# but excluding (including root_obj) empty objects if needed
if not options.empty and not nonempty_object(root_obj):
# The object and its children are empty, no need to continue
return []
if not options.empty and not nonempty_object(root_obj, False):
# The object is empty but one of its children isn't, so continue
result = []
else:
result = [root_obj]

for child in root_obj.children():
result.extend(list_objects(root_obj.child(child)))
return result

for obj in map(obj_path, list_objects(Object(bus, args[0], '/'))):
print obj
elif len(args) == 2:
def pprint(method, signal = False):
def pprint_arg(arg):
s = arg.signature
n = arg.name
x = s.tostring()
if n:
x += " " + n
return x

inargs = list(method.inargs())
outargs = list(method.outargs())

if signal:
print " signal",
elif len(outargs) == 0:
print " void",
else:
print " " + ", ".join(map(pprint_arg, outargs)),

print method.name + '(' + ", ".join(map(pprint_arg, inargs)) + ')'

obj = Object(bus, args[0], args[1])

if options.completion:
for ifname in obj.interfaces():
iface = obj.interface(ifname)
for x in iface.methods():
print x
print ifname + "." + x
if options.signals:
for x in iface.signals():
print x
print ifname + "." + x
else:
for ifname in obj.interfaces():
iface = obj.interface(ifname)
if not options.empty and not nonempty_iface(iface):
continue
print "Interface %s:" % ifname

i = 0
for methodname in iface.methods():
pprint(iface.method(methodname))
i += 1
if i:
print

if not options.signals:
if not i:
print
continue

j = 0
for signalname in iface.signals():
pprint(iface.signal(signalname), True)
j += 1
if j or (not j and not i):
print
else:
def indent(level):
sys.stdout.write(" "*level)

def print_arg(arg, name):
def dump(data, lvl):
indent(lvl)

if type(data) in (dbus.Struct, dbus.Array):
print type(data).__name__
for x in arg:
dump(x, lvl + 1)
print
elif type(data) == dbus.Dictionary:
print type(data).__name__
for k, v in data.iteritems():
dump(k, lvl+1)
print ":",
dump(v, 0)
print
else:
print data,

if name:
print name,"= ",
dump(arg, 0)
print

service, path, method = args[0:3]
obj = Object(bus, service, path)
args = args[3:]
if "." in method:
iface, method = method.rsplit(".", 1)
else:
iface = None
try:
for iface in obj.interfaces():
if method in list(obj.interface(iface).methods()):
break
except:
raise

if options.completion:
try:
for i, arg in enumerate(obj.interface(iface).method(method).inargs()):
if i == len(args):
print arg.signature.tostring(),
if arg.name:
print arg.name,
print
except:
pass

sys.exit(0)

args2 = []
for arg in args:
if len(arg) >= 2 and arg[0] == '%':
if arg[1] == '%':
args2.append('%' + arg[2:])
else:
args2.append(eval(arg[1:], {}))
else:
args2.append(arg)
args = args2

ret = obj.get_object().get_dbus_method(method, iface)(*args)
try:
outargs = list(obj.method(method, iface).outargs())
except:
outargs = []

if not isinstance(ret, tuple) or isinstance(ret, dbus.Struct):
ret = (ret,)

for i, arg in enumerate(ret):
if len(outargs) > i:
print_arg(arg, outargs[i].name)
else:
print_arg(arg, None)
</source>