�
@ia�` � � � S SK r S SKJr S SKrS SKJr S SKJ r J
r
J r J r Sr
\ R " S5 rS SKJrJrJrJrJr S SKJr " S S
5 r " S S 5 r " S
S\5 r " S S\5 rg! \ a S SKJr Nwf = f)� N)�RLock)�process_introspection_data)�
DBusException� IntrospectionParserException� MissingErrorHandlerException� MissingReplyHandlerException�restructuredtextz dbus.proxies)�BUS_DAEMON_IFACE�BUS_DAEMON_NAME�BUS_DAEMON_PATH�INTROSPECTABLE_IFACE�
LOCAL_PATH)�is_py2c �* � \ rS rSrSrS rS rS rSrg)�_DeferredMethod�4 zPA proxy method which will only get called once we have its
introspection reply.
c �J � Xl UR U l X l X0l g �N)�
_proxy_method� _method_name�_append�_block)�self� proxy_method�append�blocks �./usr/lib/python3/dist-packages/dbus/proxies.py�__init__�_DeferredMethod.__init__8 s � � )�� (� 5� 5��� � �� � c � � SU; d UR SS5 ( a U R U R X5 g U R 5 U R " U0 UD6$ )N�
reply_handler� ignore_replyF)�getr r r �r �args�keywordss r �__call__�_DeferredMethod.__call__? sS � � �x� '� �L�L� �� /� /� �L�L��+�+�T� <��
�K�K�M��%�%�t�8�x�8� 8r c �< � U R U R X5 g r )r r r% s r �
call_async�_DeferredMethod.call_asyncJ s � � � � �T�'�'��8r )r r r r N� �__name__�
__module__� __qualname__�__firstlineno__�__doc__r r( r+ �__static_attributes__� r r r r 4 s � �� � 9�9r r c �* � \ rS rSrSrS rS rS rSrg)� _ProxyMethod�N z�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 �� � U[ :X a [ S[ - 5 eXl X l X0l X@l [ R " U5 XPl Ub [ R " U5 X`l
g )Nz1Methods may not be called on the reserved path %s) r r �_proxy� _connection�_named_service� _object_path�_dbus_bindings�validate_member_namer �validate_interface_name�_dbus_interface)r �proxy�
connection�bus_name� object_path� method_name�ifaces r r �_ProxyMethod.__init__U sk � � �*� $� � !*�,6�!7� 8�
8� %� � )�� '�� *���+�+�K�8� *�� � � � 2� 2�5� 9� $� r c
�� � UR SS 5 nUR SS 5 nUR SS5 nUR SS 5 nUc Ub, Uc
[ 5 eUc
[ 5 eU( a [ S5 eUR SU R 5 nUcH Uc
U R
nOUS- U R
- nU R R R US 5 nU( d UbC U R R " U R U R UU R
UUUU40 UD6 g U R R " U R U R UU R
UU40 UD6$ ) Nr" �
error_handlerr# F� signaturez6ignore_reply and reply_handler cannot be used together�dbus_interface�.)�popr r � TypeErrorr@ r r9 �_introspect_method_mapr$ r: r+ r; r< �
call_blocking) r r& r' r" rI r# rJ rK �keys r r( �_ProxyMethod.__call__i sx � � � � �_�d�;�
� � � �_�d�;�
� �|�|�N�E�:� � �L�L��d�3� � � $�
�(A� �$�2�4�4� �&�2�4�4� � � !0� 1� 1� "� � �&6��8L�8L�M�� � � �%��'�'��$�s�*�T�->�->�>�� � � �:�:�>�>�s�D�I�I� �=�4� � � � '� '��(;�(;�(,�(9�(9�(6�(,�(9�(9�(1�(,�(5�(5�
4� +3�
4� �#�#�1�1�$�2E�2E�26�2C�2C�2@�26�2C�2C�2;�26� >� 5=�
>�
>r c
�� � UR SS 5 nUR SS 5 nUR SS 5 nUR SU R 5 nUcL U( a US- U R - nO U R nU R R R US 5 nU R R " U R U R UU R UUUU40 UD6 g )Nr" rI rJ rK rL )
rM r@ r r9 rO r$ r: r+ r; r< )r r& r' r" rI rJ rK rQ s r r+ �_ProxyMethod.call_async� s� � � � � �_�d�;�
� � � �_�d�;�
� �L�L��d�3� �!� � �&6��8L�8L�M�� � � �$�s�*�T�->�->�>���'�'�� � � �:�:�>�>�s�D�I�I� ���#�#�D�$7�$7�$(�$5�$5�$2�$(�$5�$5�$-�$(�$1�$1� 0� '/� 0r )r: r@ r r; r< r9 Nr- r4 r r r6 r6 N s � �� %�(*>�X0r r6 c �� � \ rS rSrSr\r\rSr Sr
Sr SS jr \
" S SSS 5 r\
" S
SSS 5 r\
" S SSS
5 rSS jrS rS rS rS rS rS rS rSS jrS r\rSr g)� ProxyObject� z�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.
r � � Nc �, � UR SS5 nUb" Ub [ S5 eUnSSKJn U" S[ SS9 UR S S5 n U b" Ub [ S
5 eU nSSKJn U" S [ SS9 U( a+ [ S S
R UR
5 5 - 5 eU( a UR 5 Xl Ub [ R " U5 U=U l U l [ R " U5 X0l U( d UR U5 U l SU l / U l 0 U l [' 5 U l U( a U R [* :X a U R, U l gU R0 U l U R3 5 U l g)ah 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
�busNz%conn and bus cannot both be specifiedr )�warnz`Passing the bus parameter to ProxyObject by name is deprecated: please use positional parametersrY )�
stacklevel�
named_servicez3bus_name and named_service cannot both be specifiedzjPassing the named_service parameter to ProxyObject by name is deprecated: please use positional parametersz>ProxyObject.__init__ does not take these keyword arguments: %sz, )rM rN �warningsr\ �DeprecationWarning�join�keys�_require_main_loop�_busr= �validate_bus_namer; �_requested_bus_name�validate_object_path�__dbus_object_path__�activate_name_owner�_pending_introspect�_pending_introspect_queuerO r �_introspect_lockr � INTROSPECT_STATE_DONT_INTROSPECT�_introspect_state�'INTROSPECT_STATE_INTROSPECT_IN_PROGRESS� _Introspect)
r �connrC rD �
introspect�follow_name_owner_changes�kwargsr[ r\ r^ s
r r �ProxyObject.__init__� s� � �, �j�j���%�� �?�� � � G�H�H��D� %� � @�#��
3� �
�
�?�D�9�
� � $��#� � !,� -� -�$�H� %� � C�#��
3� �� 4� "�i�i�� � �
� 6� 7� 8�
8� %�
� #� #� %�� � � � � ,� ,�X� 6� :B�A���d� 6��+�+�K�8�$/�!�(�"&�":�":�8�"D�D� � $(�� �)+��&�&(��#� !&��� ��T� 6� 6�*� D�%)�%J�%J�D� "�%)�%Q�%Q�D� "�'+�'7�'7�'9�D� $r c � � U R $ r )r; �r s r �<lambda>�ProxyObject.<lambda> s
� �T�%8�%8r a� 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 � � U R $ r )rf rw s r rx ry s
� �t�/G�/Gr z[The bus name which was requested when this proxy was
instantiated.
c � � U R $ r )rh rw s r rx ry & s
� ��(A�(Ar z The object-path of this proxy.c �n � U R R " U4UUU R U R S.UD6$ )a�
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).
)� signal_namerK rC �path)rd �add_signal_receiverr; rh �r r} �handler_functionrK r' s r �connect_to_signal� ProxyObject.connect_to_signal2 sF � �x
� � �%�%�&6� 2�2=�5C�/3�/B�/B�+/�+D�+D� 2�
)1� 2� 2r c
� � 0 nU R R " U R U R [ SSSU R
U R 4SS0UD6$ )N�
Introspect� r4 �require_main_loopF)rd r+ r; rh r
�_introspect_reply_handler�_introspect_error_handler)r rt s r rp �ProxyObject._Introspectu sd � ����y�y�#�#�D�$7�$7�$(�$=�$=�$8�,��B�$(�$B�$B�$(�$B�$B� G�
7<� G�
@F� G� Gr c �N � U R H u pnU" U0 UD6 M / U l g r )rk )r r r& r' s r �_introspect_execute_queue�%ProxyObject._introspect_execute_queue~ s/ � � /3�.L�.L� *�\�� �$� +�(� +� /M�)+��&r c � � U R R 5 [ U5 U l U R U l S U l U R 5 U R R
5 g ! [ a5 nU R U5 S nAU R R
5 g S nAff = f! U R R
5 f = fr ) rl �acquirer rO r r� �release� INTROSPECT_STATE_INTROSPECT_DONErn rj r� )r �data�es r r� �%ProxyObject._introspect_reply_handler� s� � � � � �%�%�'� ,�
�.H��.N��+�
&*�%J�%J�D� "�'+�D� $� � *� *� ,� � !� !� )� )� +�� 0�
��.�.�q�1��
� !� !� )� )� +��
��
� !� !� )� )� +�s. �A0 �(B2 �0
B/�:B*� B2 �*B/�/B2 �2 Cc � � [ R " 5 [ R SU R U R
UR R UR R U5 U R R 5 [ R S5 U R U l
S U l U R 5 U R R! 5 g ! U R R! 5 f = f)Nz$Introspect error on %s:%s: %s.%s: %sz'Executing introspect queue due to error)�logging� basicConfig�_logger�errorr; rh � __class__r/ r. rl r� �debugrm rn rj r� r� )r r� s r r� �%ProxyObject._introspect_error_handler� s� � ���� ��
�
�<��)�)�4�+D�+D��o�o�0�0�%�/�/�2J�2J�� �
� � �%�%�'� ,� �M�M�C� D�%)�%J�%J�D� "�'+�D� $� � *� *� ,� � !� !� )� )� +��D� !� !� )� )� +�s �=C � C;c � � U R R 5 U R b U R R 5 U R R 5 g ! U R R 5 f = fr )rl r� rj r r� rw s r �_introspect_block� ProxyObject._introspect_block� s^ � � � � �%�%�'� ,��'�'�3��(�(�.�.�0�
� !� !� )� )� +��D� !� !� )� )� +�s �'A � A:c �, � U R R 5 U R U R :X a U R R XU45 OU" U0 UD6 U R R
5 g ! U R R
5 f = fr )rl r� rn ro rk r r� )r �callbackr& rt s r �_introspect_add_to_queue�$ProxyObject._introspect_add_to_queue� sz � � � � �%�%�'� ,��%�%��)U�)U�U��.�.�5�5�x�v�6N�O� �$�)�&�)� � !� !� )� )� +��D� !� !� )� )� +�s �A A7 �7 Bc � � UR S5 ( a! UR S5 ( a [ U5 eU R U5 $ �N�__)�
startswith�endswith�AttributeError�get_dbus_method�r �members r � __getattr__�ProxyObject.__getattr__� s= � � � � �T� "� "�v���t�'<�'<� ��(� (��'�'��/� /r c �� � U R X R U R U R UU5 nU R U R
:X a& U R
X0R U R 5 nU$ )a� 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.
) �ProxyMethodClassrd r; rh rn ro �DeferredMethodClassr� r� )r r� rK �rets r r� �ProxyObject.get_dbus_method� sp � �. �#�#�D�)�)�$(�$7�$7�$(�$=�$=�v�$2�4�� � !� !�T�%Q�%Q� Q��*�*�3�0M�0M�+/�+A�+A�C�C� �
r c �b � SU R U R U R [ U 5 4- $ )Nz&<ProxyObject wrapping %s %s %s at %#x>)rd r; rh �idrw s r �__repr__�ProxyObject.__repr__� s4 � �7� �I�I�t�*�*�D�,E�,E�r�$�x�9Q� Q� Qr ) rh rd rl rO rn r; rj rk rf )NNNTFr ) r. r/ r0 r1 r2 r6 r� r r� rm ro r� r �propertyrC �requested_bus_namerD r� rp r� r� r� r� r� r� r� r� �__str__r3 r4 r r rV rV � s� � ��
$��)��'(�$�./�+�'(�$�=A�<A�Q:�f �8�$��
��H�$ "�"G� �$�
��� �A� �$� 0�2�K�A2�FG�,�
,�
,� ,�
,�0� $�LQ� �Gr rV c � � \ rS rSrSrS r\" S SSS5 r\r\" S SSS5 r \" S SSS
5 r
\" S SSS 5 r \" S
SSS5 r SS jr
S rSS jrS r\rSrg)� Interfacei� z�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 �j � [ U[ 5 ( a UR U l OXl X l g)a
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)�
isinstancer� � proxy_object�_objr@ )r �objectrK s r r �Interface.__init__� s) � � �f�i� (� (� �+�+�D�I� �I� -� r c �. � U R R $ r )r� rD rw s r rx �Interface.<lambda> s � ����)>�)>r Nz.The D-Bus object path of the underlying objectc �. � U R R $ r )r� rC rw s r rx r� s � �d�i�i�&8�&8r z:The bus name to which the underlying proxy object is boundc �. � U R R $ r )r� r� rw s r rx r� s � �� � �0L�0Lr zGThe bus name which was requested when the underlying object was createdc � � U R $ r )r� rw s r rx r�
s � �$�)�)r zThe underlying proxy objectc � � U R $ r )r@ rw s r rx r� s
� �D�,@�,@r z The D-Bus interface representedc �d � U( d U R nU R R " XU40 UD6$ )a1 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� s r r� �Interface.connect_to_signal s9 � � � !� 1� 1�N��y�y�*�*�;�+9�G�=E�G� Gr c � � UR S5 ( a! UR S5 ( a [ U5 eU R R XR
5 $ r� )r� r� r� r� r� r@ r� s r r� �Interface.__getattr__" sG � � � � �T� "� "�v���t�'<�'<� ��(� (��9�9�,�,�V�5I�5I�J� Jr c �V � Uc U R nU R R X5 $ )z�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.
)r@ r� r� )r r� rK s r r� �Interface.get_dbus_method( s* � � � !� !� 1� 1�N��y�y�(�(��@�@r c �L � SU R U R [ U 5 4- $ )Nz%<Interface %r implementing %r at %#x>)r� r@ r� rw s r r� �Interface.__repr__4 s) � �6� � � �4�'�'��D��83� 3� 3r )r@ r� r )r. r/ r0 r1 r2 r r� rD rh rC r� r� rK r� r� r� r� r� r3 r4 r r r� r� � s� � ��
.� � >��d� L�N�K�&���8�$��$�%�H� "�#L�#'��$C�D�� � 3�T�4� >�@�L� � @�$�� D�F�N� *.�G� K�
A�3� �Gr r� ) r� � threadingr � ImportError�dummy_threadingr= � dbus._expat_introspect_parserr �dbus.exceptionsr r r r �
__docformat__� getLoggerr� r
r r r
r � dbus._compatr r r6 r� rV r� r4 r r �<module>r� s� ��8 �&� � � D�"� "� #�
� �
�
�N�
+��� � �9� 9�4]0� ]0�@{�&� {�| K�� K��Y � &�%�&�s �A5 �5 B�B