From: Olivier Aubert <olivier.aubert@liris.cnrs.fr>
Date: Wed, 22 Feb 2006 13:19:29 +0000 (+0000)
Subject: vlcdebug.py: add documentation
X-Git-Tag: 0.9.0-test0~12205
X-Git-Url: https://git.sesse.net/?a=commitdiff_plain;h=e36d03947c3a23270abd4a58922d4c5d41660e38;p=vlc

vlcdebug.py: add documentation
---

diff --git a/bindings/mediacontrol-python/vlcdebug.py b/bindings/mediacontrol-python/vlcdebug.py
index b5524bd478..be67d3a72c 100644
--- a/bindings/mediacontrol-python/vlcdebug.py
+++ b/bindings/mediacontrol-python/vlcdebug.py
@@ -8,6 +8,10 @@ class VLCObject(object):
         object.__setattr__(self, '_o', vlc.Object(id))
 
     def find(self, typ):
+	"""Returns a VLCObject for the given child.
+
+	See vlc.Object.find_object.__doc__ for the different values of typ.
+	"""
         t=self._o.find_object(typ)
         if t is not None:
             return VLCObject(t.info()['object-id'])
@@ -15,13 +19,16 @@ class VLCObject(object):
             return None
 
     def __str__(self):
+	"""Returns a string representation of the object.
+	"""
         i=self._o.info()
         return "VLCObject %d (%s) : %s" % (i['object-id'],
                                            i['object-type'],
                                            i['object-name'])
 
     def tree(self, prefix=" "):
-        """Displays the children as a tree."""
+        """Displays all children as a tree of VLCObject
+	"""
         print prefix, self
         for i in self._o.children():
             t=VLCObject(i)
@@ -29,8 +36,10 @@ class VLCObject(object):
         return
 
     def __getattribute__(self, attr):
-        #print "Getting %s" % attr
+	"""Converts attribute access to access to variables.
+	"""
         if attr == '__members__':
+	    # Return the list of variables
             o=object.__getattribute__(self, '_o')
             l=dir(o)
             l.extend([ n.replace('-','_') for n in o.list() ])
@@ -48,19 +57,20 @@ class VLCObject(object):
                     raise e
 
     def __setattr__(self, name, value):
+	"""Handle attribute assignment.
+	"""
         n=name.replace('_', '-')
         if n in self._o.list():
             self._o.set(n, value)
         else:
             object.__setattr__(self, name, value)
 
-#mc=vlc.MediaControl()
-#mc.playlist_add_item('/tmp/k.mpg')
-#mc.start(0)
-
-def test():
+def test(f='/tmp/k.mpg'):
     global mc,o
     mc=vlc.MediaControl()
-    mc.playlist_add_item('/tmp/k.mpg')
+    mc.playlist_add_item(f)
     mc.start(0)
+    mc.pause(0)
     o=VLCObject(0)
+    v=o.find('vout')
+