← Back
Editing: handler.cpython-312.pyc
� �icwL � � � d dl Z d dlmZmZ d dlmZ d dlmZ d dlm Z d dl m Z m Z d dl mZmZ d dlmZmZmZ d dlZ ej* d d � d d lmZ e j0 e� Zg d �Z G d � de � Z G d� de�� Z G d� de � Z y)� N)�ABCMeta�abstractmethod)�partial)� ErrorMapper)�Signal)�get_xml�"are_additional_arguments_supported)�DBusSpecification�DBusSpecificationError)� get_variant�unwrap_variant�is_tuple_of_one�Gioz2.0)r )� GLibServer�AbstractServerObjectHandler�ServerObjectHandlerc � � e Zd ZdZe d d�� Ze d d�� Zed� � Zed� � Zed� � Z ed� � Z ed � � Z ed � � Z y) r z0The low-level DBus server library based on GLib.Nc �. � |j |||||� y)zEmit a DBus signal.N)� emit_signal)�cls� connection� object_path�interface_name� signal_name� parameters� destinations �:/usr/lib/python3.12/site-packages/dasbus/server/handler.pyr zGLibServer.emit_signal/ s! � � � � � � � � � � � c �@ � t j j |� }t | j ||f�� }g }|j s t d� �|j D ]( } |j || |dd� } |j | � �* t | j ||� S )zRegister an object on DBus.)� user_dataz$No DBus interfaces for registration.N) r � DBusNodeInfo� new_for_xmlr �_object_callback� interfacesr �register_object�append�_unregister_object) r r r � object_xml�callback� callback_args� node_info�method_call_closure� registrations�interface_info�registration_ids r r% zGLibServer.register_object; s� � � �$�$�0�0� � � � &� � � � � �/� �� � ��#�#�(�6�� � (� 2� 2�N� (� 8� 8�� �#��� �O� � � � � 1� 3� � � "� "� � � � r c �4 � |D ] }|j |� � y)z Unregister an object from DBus.N)�unregister_object)r r r- r/ s r r' z GLibServer._unregister_object] s � � -�O� � (� (� � 9� -r c �& � |\ } } | ||||g| ��� y �N� ) r r �senderr r � method_namer � invocationr r) r* s r r# zGLibServer._object_callbackc s. � � #,� ��-� � � � � � � � r c �& � d|j � iS )a9 Get information about the DBus call. Supported items: sender str: The bus name that invoked the method There can be more supported items in the future. :param invocation: an invocation of a DBus call :return: a dictionary of information about the DBus call r5 )� get_sender)r r7 s r � get_call_infozGLibServer.get_call_infos s � � �j�+�+�-� � r c �( � |j ||� y)z�Set the error of the DBus call. :param invocation: an invocation of a DBus call :param error_name: a DBus name of the error :param error_message: an error message N)�return_dbus_error)r r7 � error_name� error_messages r �set_call_errorzGLibServer.set_call_error� s � � �$�$�Z� �?r c �J � | j ||� }|j |� y)z�Set the reply of the DBus call. :param invocation: an invocation of a DBus call :param out_type: a type of the reply :param out_value: a value of the reply N)�_get_reply_value� return_value)r r7 �out_type� out_value� reply_values r �set_call_replyzGLibServer.set_call_reply� s$ � � �*�*�8�Y�?� �� � � �,r c �< � |�yt |� r|f}t ||� S )z%Get the reply value of the DBus call.N)r r )r rC rD s r rA zGLibServer._get_reply_value� s) � � � �� �8� $�"� �I��8�Y�/�/r r3 )r4 ) �__name__� __module__� __qualname__�__doc__� classmethodr r% r' r# r: r? rF rA r4 r r r r , s� � �:��9=� � � � �02� � � �B �:� �:� � � � � � � � � �@� �@� �-� �-� �0� �0r r c � � e Zd ZdZg d�Zd� Zed� � Zd� Ze d� � Z e d� � Z e d� � Z e d � � Z e d � � Zd � Zd � Zd � Zd� Ze d� � Zy)r z+The abstract handler of a published object.�� _message_bus� _object_path�_object�_specificationc �< � || _ || _ || _ d| _ y)z�Create a new handler. :param message_bus: a message bus :param object_path: a DBus path of the object :param obj: a Python instance of the object NrN )�self� message_busr �objs r �__init__z$AbstractServerObjectHandler.__init__� s# � � (��� '����� � "��r c �\ � | j s| j � | _ | j S )zDBus specification.)rR �_get_specification�rT s r � specificationz)AbstractServerObjectHandler.specification� s* � � �"�"�"&�"9�"9�";�D� ��"�"�"r c �H � t j | j � � S )zKGet the DBus specification. :return: a DBus specification )r �from_xml�_get_xml_specificationrZ s r rY z.AbstractServerObjectHandler._get_specification� s# � � !�)�)� � '� '� )� � r c � � y)�IGet the XML specification. :return: a XML specification � r4 rZ s r r^ z2AbstractServerObjectHandler._get_xml_specification� s � � r c � � y)z�Connect the object to DBus. Handle emitted signals of the object with the _emit_signal method and handle incoming DBus calls with the _handle_call method. Nr4 rZ s r �connect_objectz*AbstractServerObjectHandler.connect_object� � � � r c � � y)zdDisconnect the object from DBus. Unregister the object and disconnect all signals. Nr4 rZ s r �disconnect_objectz-AbstractServerObjectHandler.disconnect_object� s � � r c � � y)z�Connect a DBus signal. :param interface_name: a DBus interface name :param signal_name: a DBus signal name Nr4 �rT r r s r �_connect_signalz+AbstractServerObjectHandler._connect_signal� s � � r c � � y)z�Handle a DBus signal. :param interface_name: a DBus interface name :param signal_name: a DBus name of the signal :param parameters: a signal parameters Nr4 )rT r r r s r � _emit_signalz(AbstractServerObjectHandler._emit_signal� rd r c �P � | j ||� }t |� si } ||i |��S )a* Handle a DBus call. :param interface_name: a name of the interface :param method_name: a name of the called method :param parameters: parameters of the call :param additional_args: additional arguments of the call :return: a result of the DBus call )� _find_handlerr )rT r r6 r �additional_args�handlers r � _handle_callz(AbstractServerObjectHandler._handle_call� s5 � � �$�$�^�[�A�� 2�'�:� �O�� �6�o�6�6r c �: � | j j ||� S )z�Find a specification of the DBus member. :param interface_name: a name of the interface :param member_name: a name of the member :return: a specification of the member )r[ � get_member�rT r � member_names r �_find_member_specz-AbstractServerObjectHandler._find_member_spec s" � � �!�!�,�,� �K� � r c � � | j ||� xs | j ||� }|st dj ||� � �|S )z�Find a handler of a DBus member. :param interface_name: a name of the interface :param member_name: a name of the method :return: a handler z The member {}.{} has no handler.)�_find_object_handler�_find_default_handler�AttributeError�format)rT r rt ro s r rm z)AbstractServerObjectHandler._find_handler s[ � � �+�+�N�K�H� G��)�)�.�+�F� � � �!C�!J�!J� � �"� � � �r c �0 � t | j |d� S )ae Get an object handler of a DBus call. By default, DBus interfaces with members of the same name are not supported, so the given interface name is not used to find the object handler. :param interface_name: a name of the interface. :param member_name: a name of the member :return: a handler or None N)�getattrrQ rs s r rw z0AbstractServerObjectHandler._find_object_handler' s � � �t�|�|�[�$�7�7r c � � y)��Find a default handler of a DBus call. :param interface_name: a name of the interface :param member_name: a name of the member :return: a handler or None Nr4 rs s r rx z1AbstractServerObjectHandler._find_default_handler4 rd r N)rH rI rJ rK � __slots__rW �propertyr[ rY r r^ rc rf ri rk rp ru rm rw rx r4 r r r r � s� � �5��I� #� �#� �#� � �� �� � � � � � � � � � � � � � � � �7�$ ��" 8� � � � r r )� metaclassc � � � e Zd ZdZg d�Zdeef� fd� Zd� Zd� Z d� Z d� Z d � Z d � Z d � Zd � Zd � Zd� Zd� Zd� Zd� Zd� Zd� Zd� Zd� Zed� � Z� xZS )r z+The handler of an object published on DBus.)�_server�_signal_factory� _error_mapper�_registrationsNc �x �� t �| � |||� || _ || _ |xs t � | _ g | _ y)aA Create a new handler. :param message_bus: a message bus :param object_path: a DBus path of the object :param obj: a Python instance of the object :param error_mapper: a DBus error mapper :param server: a DBus server library :param signal_factory: a signal factory N)�superrW r� r� r r� r� )rT rU r rV � error_mapper�server�signal_factory� __class__s �r rW z ServerObjectHandler.__init__I s< �� � ����k�3�7� �� � -�� � )� :�[�]��� ��r c �, � t | j � S )r` )r rQ rZ s r r^ z*ServerObjectHandler._get_xml_specificationZ s � � �t�|�|�$�$r c �D � | j � | j � y)zConnect the object to DBus.N)�_register_object�_connect_signalsrZ s r rc z"ServerObjectHandler.connect_objecta s � � � � � � � � � r c �z � | j r/| j j � } |� | j r�.yy)z Disconnect the object from DBus.N)r� �pop)rT r) s r rf z%ServerObjectHandler.disconnect_objectf s/ � ��!�!��*�*�.�.�0�H� �J� �!�!r c �� � | j j | j j | j | j � | j � }| j j |� y)zLRegister to DBus calls. :return: an unregistering callback N) r� r% rO r rP r^ �_method_callbackr� r& )rT � unregisters r r� z$ServerObjectHandler._register_objectl s[ � � �\�\�1�1� � � � (� (� � � � � '� '� )� � !� !� � � ���"�"�:�.r c � � | j j D ]C }t |t j � s� | j |j |j � �E y)zConnect all DBus signals.N)r[ �members� isinstancer r ri r �name)rT �members r r� z$ServerObjectHandler._connect_signalsz sJ � ��(�(�0�0�F� �f�&7�&>�&>�?�� � � ��%�%�� � � � 1r c �� � | j ||� }| j ||� }|j |� t |j |� }| j j |� y)z�Connect a DBus signal. :param interface_name: a DBus interface name :param signal_name: a DBus signal name :return: a disconnecting callback N)� _find_emitterrm �connectr � disconnectr� r& )rT r r r) �signalr� s r ri z#ServerObjectHandler._connect_signal� sZ � � �%�%�n�k�B���#�#�N�K�@�����x� � �V� .� .��9� � ���"�"�:�.r c �0 � t | j ||� S )z�Find an emitter of a DBus signal. :param interface_name: a DBus interface name :param signal_name: a DBus signal name :return: a callback )r rk rh s r r� z!ServerObjectHandler._find_emitter� s � � �t�(�(�.�+�F�Fr c �� � | j ||� }|sd}|j �t |j |� }| j j | j j | j |||� y)z�Handle a DBus signal. :param interface_name: a DBus interface name :param signal_name: a DBus signal name :param parameters: a signal parameters N)ru �typer r� r rO r rP )rT r r r r� s r rk z ServerObjectHandler._emit_signal� sk � � �'�'�� �D��� �J� �;�;� "�$�V�[�[�*�=�J� � � � � � � � � (� (� � � � � � � r c � � | j ||||� }| j ||� } | j ||gt |� ��i |��}| j |||� y# t $ r }| j ||||� Y d}~yd}~ww xY w)z�The callback for a DBus call. :param invocation: an invocation of the DBus call :param interface_name: a DBus interface name :param method_name: a DBus method name :param parameters: a variant of DBus arguments N)�_get_additional_argumentsru rp r �_handle_method_result� Exception�_handle_method_error) rT r7 r r6 r rn r� �result�errors r r� z$ServerObjectHandler._method_callback� s� � � � "� <� <�� ��� �O� �+�+� ���F� '�T�&�&� ��� � �+�� "� �F� � &� &���� �� � � � %� %�� ��� � �� �s �AA � B�%A>�>Bc �< � d| j j |� iS )aB Get additional arguments of a DBus call. Supported items: call_info dict: Information about the DBus call This method is useful for customizations. It shouldn't be changed in this library unless we make sure that the change won't break the existing use cases. :param invocation: an invocation of the DBus call :param interface_name: a DBus interface name :param method_name: a DBus method name :param parameters: a variant of DBus arguments :return: a dictionary of additional info � call_info)r� r: )rT r7 r r6 r s r r� z-ServerObjectHandler._get_additional_arguments� s" � �& �� � �3�3�J�?� � r c �� � t j d||d�� | j j t |� � }| j j ||t |� � y)a Handle an error of a DBus call. :param invocation: an invocation of the DBus call :param interface_name: a DBus interface name :param method_name: a DBus method name :param error: an exception raised during the call z,The call %s.%s has failed with an exception:T)�exc_infoN)�log�warningr� �get_error_namer� r� r? �str)rT r7 r r6 r� r= s r r� z(ServerObjectHandler._handle_method_error� s_ � � � � � :� �K�$� � � �'�'�6�6� ��K� � � � � �#�#� � � ��J� r c �R � | j j ||j |� y)z�Handle a result of a DBus call. :param invocation: an invocation of a DBus call :param method_spec: a method specification :param method_reply: a method reply N)r� rF rC )rT r7 � method_spec� method_replys r r� z)ServerObjectHandler._handle_method_result s% � � � � �#�#� � � � � � r c � � |dk( rD|dk( r | j S |dk( r | j S |dk( r | j S |dk( r | j S y)r~ z org.freedesktop.DBus.Properties�Get�Set�GetAll�PropertiesChangedN)� _get_property� _set_property�_get_all_properties�_properties_changedrs s r rx z)ServerObjectHandler._find_default_handler sa � � � >� >��e�#��)�)�)� ��%��)�)�)� ��(��/�/�/� � 3�3��/�/�/�r c �� � | j ||� }|j st dj ||� � �t | j |� }t |j |� S )z�The default handler of the Get method. :param interface_name: an interface name :param property_name: a property name :return: a variant with a property value z#The property {}.{} is not readable.)ru �readablery rz r| rQ r r� )rT r � property_namer� �values r r� z!ServerObjectHandler._get_property& s` � � �'�'�� �F����� �!F�!M�!M� � �"� � � �� � �m�4���6�;�;��.�.r c � � | j ||� }|j st dj ||� � �t | j |t |� � y)z�The default handler of the Set method. :param interface_name: an interface name :param property_name: a property name :param property_value: a variant with a property value z#The property {}.{} is not writable.N)ru �writablery rz �setattrrQ r )rT r r� �property_valuer� s r r� z!ServerObjectHandler._set_property7 sT � � �'�'�� �F����� �!F�!M�!M� � �"� � � �� � �m�^�N�-K�Lr c �� � | j j D �cg c]C }t |t j � r'|j |k( r|j r |j ��E c}S c c}w )z�Find all properties of the given interface. :param interface_name: an interface name :return: a list of property names )r[ r� r� r �Propertyr r� r� )rT r r� s r �_find_all_propertiesz(ServerObjectHandler._find_all_propertiesG s_ � � '+�&8�&8�&@�&@� �&@�F��&�"3�"<�"<�=��%�%� �7���� �K�K�&@� � �� s �AA$c �l � | j |� D �ci c] }|| j ||� �� c}S c c}w )z�The default handler of the GetAll method. :param interface_name: an interface name :return: a dictionary of properties )r� r� )rT r r� s r r� z'ServerObjectHandler._get_all_propertiesT sF � � "&�!:�!:�>�!J� �!J� � �4�-�-�n�m�L� L�!J� � �� s �1c �" � | j � S )zXThe default handler of the PropertiesChanged method. :return: a signal )r� rZ s r r� z'ServerObjectHandler._properties_changed_ s � � �#�#�%�%r ) rH rI rJ rK r r r rW r^ rc rf r� r� ri r� rk r� r� r� r� rx r� r� r� r� r� r� � __classcell__)r� s @r r r ? s� �� �5��I� DH�"�6�!�"%� � � /� � /� G� �.%�N �, �, ��&/�"M� � � �&� �&r r ) �logging�abcr r � functoolsr � dasbus.errorr � dasbus.signalr �dasbus.server.interfacer r �dasbus.specificationr r � dasbus.typingr r r �gi�require_version� gi.repositoryr � getLoggerrH r� �__all__�objectr r r r4 r r �<module>r� s� ��* � '� � $� � O� J� F� F� � �� � �5�%� � ��g����!�� ��v0�� v0�rW �G� W �tf&�5� f&r
Save File
Cancel