Ñò
9nÛLc
@ s# d d k Z d d k Z y d d k l Z Wn# e j
o d d k l Z n Xd d k Z d d k l Z d d k l
Z
l Z l Z l
Z
d Z e i d ƒ Z d d k l Z l Z l Z l Z l Z d f d „ ƒ YZ d
f d „ ƒ YZ d e f d
„ ƒ YZ d e f d „ ƒ YZ d S( iÿÿÿÿN( t RLock( t process_introspection_data( t MissingReplyHandlerExceptiont MissingErrorHandlerExceptiont IntrospectionParserExceptiont
DBusExceptiont restructuredtexts dbus.proxies( t
LOCAL_PATHt BUS_DAEMON_NAMEt BUS_DAEMON_PATHt BUS_DAEMON_IFACEt INTROSPECTABLE_IFACEt _DeferredMethodc B s) e Z d Z d „ Z d „ Z d „ Z RS( sX A proxy method which will only get called once we have its
introspection reply.
c C s+ | | _ | i | _ | | _ | | _ d S( N( t
_proxy_methodt _method_namet _appendt _block( t selft proxy_methodt appendt block( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt __init__4 s c O s\ | i d ƒ p | i d t ƒ o | i | i | | ƒ d S| i ƒ | i | | Ž Sd S( Nt
reply_handlert ignore_reply( t has_keyt gett FalseR R
t NoneR ( R t argst keywords( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt __call__; s
c O s | i | i | | ƒ d S( N( R R
( R R R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt
call_asyncF s ( t __name__t
__module__t __doc__R R R ( ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR 0 s t _ProxyMethodc B s) e Z d Z d „ Z d „ Z d „ Z RS( s° A proxy method.
Typically a member of a ProxyObject. Calls to the
method produce messages that travel over the Bus and are routed
to a specific named Service.
c C s† | t j o t d t ƒ ‚ n | | _ | | _ | | _ | | _ t i | ƒ | | _ | d j o t i
| ƒ n | | _ d S( Ns1 Methods may not be called on the reserved path %s( R R t _proxyt _connectiont _named_servicet _object_patht _dbus_bindingst validate_member_nameR R t validate_interface_namet _dbus_interface( R t proxyt
connectiont bus_namet object_patht method_namet iface( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR Q s
c
O so | i d d ƒ } | i d d ƒ } | i d t ƒ } | d j p
| d j oO | d j o
t ƒ ‚ qŸ | d j o
t ƒ ‚ qŸ | o t d ƒ ‚ qŸ n | i d | i ƒ } | d j o
| i } n | d | i } | i i i
| d ƒ } | p
| d j o5 | i i | i
| i | | i | | | | | n, | i i | i
| i | | i | | | Sd S( NR t
error_handlerR s6 ignore_reply and reply_handler cannot be used togethert dbus_interfacet .( t popR R R R t TypeErrorR+ R R$ t _introspect_method_mapR R% R R& R' t
call_blocking( R R R R R2 R R3 t keyt introspect_sig( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR e s@
c
O s« | i d d ƒ } | i d d ƒ } | i d | i ƒ } | o | d | i } n
| i } | i i i | d ƒ } | i i | i | i
| | i | | | | | d S( NR R2 R3 R4 ( R5 R R+ R R$ R7 R R% R R& R' ( R R R R R2 R3 R9 R: ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR Ž s ( R R! R" R R R ( ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR# J s )t ProxyObjectc B sò e Z d Z e Z e Z d Z d Z d Z d d d e e d „ Z
e d „ d d d ƒ Z e d „ d d d ƒ Z e d „ d d d
ƒ Z d d „ Z d „ Z d
„ Z d „ Z d „ Z d „ Z d „ Z d „ Z d d „ Z d „ Z e Z RS( s£ A proxy to the remote Object.
A ProxyObject is provided by the Bus. ProxyObjects
have member functions, and can be called like normal Python objects.
i i i c
K sé | i d d
ƒ } | d
j oJ | d
j o t d ƒ ‚ n | } d d k l } | d t d d ƒn | i d d
ƒ } | d
j oJ | d
j o t d ƒ ‚ n | } d d k l } | d
t d d ƒn | o# t d d i | i ƒ ƒ ƒ ‚ n | o | i ƒ n | | _ | d
j o t
i | ƒ n | | _ | _
t
i | ƒ | | _ | p | i | ƒ | _ n d
| _ g | _ h | _ t ƒ | _ | p | i t j o | i | _ n | i | _ | i ƒ | _ d
S( sø Initialize the proxy object.
:Parameters:
`conn` : `dbus.connection.Connection`
The bus or connection on which to find this object.
The keyword argument `bus` is a deprecated alias for this.
`bus_name` : str
A bus name for the application owning the object, to be used
as the destination for method calls and the sender for
signal matches. The keyword argument ``named_service`` is a
deprecated alias for this.
`object_path` : str
The object path at which the application exports the object
`introspect` : bool
If true (default), attempt to introspect the remote
object to find out supported methods and their signatures
`follow_name_owner_changes` : bool
If true (default is false) and the `bus_name` is a
well-known name, follow ownership changes for that name
t buss% conn and bus cannot both be specifiediÿÿÿÿ( t warns` Passing the bus parameter to ProxyObject by name is deprecated: please use positional parameterst
stackleveli t
named_services3 bus_name and named_service cannot both be specifiedsj Passing the named_service parameter to ProxyObject by name is deprecated: please use positional parameterss> ProxyObject.__init__ does not take these keyword arguments: %ss , N( R5 R R6 t warningsR= t DeprecationWarningt joint iterkeyst _require_main_loopt _busR( t validate_bus_nameR& t _requested_bus_namet validate_object_patht __dbus_object_path__t activate_name_ownert _pending_introspectt _pending_introspect_queueR7 R t _introspect_lockR t INTROSPECT_STATE_DONT_INTROSPECTt _introspect_statet' INTROSPECT_STATE_INTROSPECT_IN_PROGRESSt _Introspect(
R t connR. R/ t
introspectt follow_name_owner_changest kwargsR< R= R? ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR ² sJ
c C s | i S( ( R& ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt s sè The bus name to which this proxy is bound. (Read-only,
may change.)
If the proxy was instantiated using a unique name, this property
is that unique name.
If the proxy was instantiated with a well-known name and with
``follow_name_owner_changes`` set false (the default), this
property is the unique name of the connection that owned that
well-known name when the proxy was instantiated, which might
not actually own the requested well-known name any more.
If the proxy was instantiated with a well-known name and with
``follow_name_owner_changes`` set true, this property is that
well-known name.
c C s | i S( ( RG ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV s s[ The bus name which was requested when this proxy was
instantiated.
c C s | i S( ( RI ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV s s The object-path of this proxy.c K s1 | i i | d | d | d | i d | i | S( sx Arrange for the given function to be called when the given signal
is received.
:Parameters:
`signal_name` : str
The name of the signal
`handler_function` : callable
A function to be called when the signal is emitted by
the remote object. Its positional arguments will be the
arguments of the signal; optionally, it may be given
keyword arguments as described below.
`dbus_interface` : str
Optional interface with which to qualify the signal name.
If None (the default) the handler will be called whenever a
signal of the given member name is received, whatever
its interface.
:Keywords:
`utf8_strings` : bool
If True, the handler function will receive any string
arguments as dbus.UTF8String objects (a subclass of str
guaranteed to be UTF-8). If False (default) it will receive
any string arguments as dbus.String objects (a subclass of
unicode).
`byte_arrays` : bool
If True, the handler function will receive any byte-array
arguments as dbus.ByteArray objects (a subclass of str).
If False (default) it will receive any byte-array
arguments as a dbus.Array of dbus.Byte (subclasses of:
a list of ints).
`sender_keyword` : str
If not None (the default), the handler function will receive
the unique name of the sending endpoint as a keyword
argument with this name
`destination_keyword` : str
If not None (the default), the handler function will receive
the bus name of the destination (or None if the signal is a
broadcast, as is usual) as a keyword argument with this name.
`interface_keyword` : str
If not None (the default), the handler function will receive
the signal interface as a keyword argument with this name.
`member_keyword` : str
If not None (the default), the handler function will receive
the signal name as a keyword argument with this name.
`path_keyword` : str
If not None (the default), the handler function will receive
the object-path of the sending object as a keyword argument
with this name
`message_keyword` : str
If not None (the default), the handler function will receive
the `dbus.lowlevel.SignalMessage` as a keyword argument with
this name.
`arg...` : unicode or UTF-8 str
If there are additional keyword parameters of the form
``arg``\ *n*, match only signals where the *n*\ th argument
is the value given for that keyword parameter. As of this time
only string arguments can be matched (in particular,
object paths and signatures can't).
t signal_nameR3 R. t path( RE t add_signal_receiverR& RI ( R RW t handler_functionR3 R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt connect_to_signal) s < c
C s= | i i | i | i t d d d | i | i d t d t ƒS( Nt
Introspectt t utf8_stringst require_main_loop( ( RE R R& RI R t _introspect_reply_handlert _introspect_error_handlert TrueR ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRQ l s c C s. x' | i D] \ } } } | | | Ž q
Wd S( N( RL ( R R R R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt _introspect_execute_queueu s
c C s~ | i i ƒ z\ y t | ƒ | _ Wn# t j
o } | i | ƒ d SX| i | _ d | _ | i
ƒ Wd | i i ƒ Xd S( N( RM t acquireR R7 R Ra t INTROSPECT_STATE_INTROSPECT_DONERO R RK Rc t release( R t datat e( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR` | s
c C sŠ t i ƒ t i d | i | i | i i | i i | ƒ | i i
ƒ z0 t i d ƒ | i | _
d | _ | i ƒ Wd | i i ƒ Xd S( Ns$ Introspect error on %s:%s: %s.%s: %ss' Executing introspect queue due to error( t loggingt basicConfigt _loggert errorR& RI t __class__R! R RM Rd t debugRN RO R RK Rc Rf ( R Rl ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRa ‹ s
c C sG | i i ƒ z% | i d j o | i i ƒ n Wd | i i ƒ Xd S( N( RM Rd RK R R Rf ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt _introspect_blockš s
c C sc | i i ƒ zA | i | i j o | i i | | | f ƒ n | | | Ž Wd | i i ƒ Xd S( N( RM Rd RO RP RL R Rf ( R t callbackR RU ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt _introspect_add_to_queue¤ s
c C sA | i d ƒ o | i d ƒ o t | ƒ ‚ n | i | ƒ Sd S( Nt __( t
startswitht endswitht AttributeErrort get_dbus_method( R t member( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt __getattr__° s c C s] | i | | i | i | i | | ƒ } | i | i j o | i | | i | i ƒ } n | S( s, Return a proxy method representing the given D-Bus method. The
returned proxy method can be called in the usual way. For instance, ::
proxy.get_dbus_method("Foo", dbus_interface='com.example.Bar')(123)
is equivalent to::
proxy.Foo(123, dbus_interface='com.example.Bar')
or even::
getattr(proxy, "Foo")(123, dbus_interface='com.example.Bar')
However, using `get_dbus_method` is the only way to call D-Bus
methods with certain awkward names - if the author of a service
implements a method called ``connect_to_signal`` or even
``__getattr__``, you'll need to use `get_dbus_method` to call them.
For services which follow the D-Bus convention of CamelCaseMethodNames
this won't be a problem.
( t ProxyMethodClassRE R& RI RO RP t DeferredMethodClassRq Ro ( R Rw R3 t ret( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRv ¶ s c C s# d | i | i | i t | ƒ f S( Ns& ( RE R& RI t id( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt __repr__Ü s N( R R! R" R# Ry R Rz RN RP Re R Rb R R t propertyR. t requested_bus_nameR/ R[ RQ Rc R` Ra Ro Rq Rx Rv R} t __str__( ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR; ¥ s6 R
C
& t Interfacec B sÅ e Z d Z d „ Z e d „ d d d ƒ Z e Z e d „ d d d ƒ Z e d „ d d d ƒ Z e d „ d d d ƒ Z
e d
„ d d d ƒ Z d d „ Z d
„ Z
d d „ Z d „ Z e Z RS( s An interface into a remote object.
An Interface can be used to wrap ProxyObjects
so that calls can be routed to their correct
D-Bus interface.
c C s6 t | t ƒ o | i | _ n
| | _ | | _ d S( s: Construct a proxy for the given interface on the given object.
:Parameters:
`object` : `dbus.proxies.ProxyObject` or `dbus.Interface`
The remote object or another of its interfaces
`dbus_interface` : str
An interface the `object` implements
N( t
isinstanceR t proxy_objectt _objR+ ( R t objectR3 ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR ê s c C s
| i i S( ( R„ R/ ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV ù s s. The D-Bus object path of the underlying objectc C s
| i i S( ( R„ R. ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV ü s s: The bus name to which the underlying proxy object is boundc C s
| i i S( ( R„ R ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV ÿ s sG The bus name which was requested when the underlying object was createdc C s | i S( ( R„ ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV s s The underlying proxy objectc C s | i S( ( R+ ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRV s s The D-Bus interface representedc K s- | p
| i } n | i i | | | | S( sa Arrange for a function to be called when the given signal is
emitted.
The parameters and keyword arguments are the same as for
`dbus.proxies.ProxyObject.connect_to_signal`, except that if
`dbus_interface` is None (the default), the D-Bus interface that
was passed to the `Interface` constructor is used.
( R+ R„ R[ ( R RW RZ R3 R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR[ s
c C sJ | i d ƒ o | i d ƒ o t | ƒ ‚ n | i i | | i ƒ Sd S( NRr ( Rs Rt Ru R„ Rv R+ ( R Rw ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRx s c C s- | d j o
| i } n | i i | | ƒ S( s& Return a proxy method representing the given D-Bus method.
This is the same as `dbus.proxies.ProxyObject.get_dbus_method`
except that if `dbus_interface` is None (the default),
the D-Bus interface that was passed to the `Interface` constructor
is used.
N( R R+ R„ Rv ( R Rw R3 ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyRv s
c C s d | i | i t | ƒ f S( Ns% ( R„ R+ R| ( R ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR} * s N( R R! R" R R~ R R/ RI R. R Rƒ R3 R[ Rx Rv R} R€ ( ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyR â s& ( t sysRi t threadingR t ImportErrort dummy_threadingR( t dbus._expat_introspect_parserR t dbus.exceptionsR R R R t
__docformat__t getLoggerRk R R R R
R R R# R… R; R ( ( ( s0 /usr/lib/python2.6/site-packages/dbus/proxies.pyt s "([ÿ >