← Back
Editing: property.cpython-312.pyc
� �ic � � � d dl mZ d dlmZ d dlmZ d dlmZ d dlm Z m Z d dl m Z m Z d dlmZmZmZmZ g d�Zd � Z G d � d e� Z G d � d e� Z G d� de�� Zy)� )�ABCMeta)� defaultdict��wraps)�Dict)� dbus_signal�get_xml)�DBusSpecification�DBusSpecificationError)� get_variant�Str�Variant�List)�emits_properties_changed�PropertiesException�PropertiesInterfacec �. � � t � � � fd�� }|S )a" Decorator for emitting properties changes. The decorated method has to be a member of a class that inherits PropertiesInterface. :param method: a DBus method of a class that inherits PropertiesInterface :return: a wrapper of a DBus method that emits PropertiesChanged c �@ �� �| g|��i |��}| j � |S )N)� flush_changes)�obj�args�kwargs�result�methods ��;/usr/lib/python3.12/site-packages/dasbus/server/property.py�wrapperz)emits_properties_changed.<locals>.wrapper1 s( �� ���-�d�-�f�-�� ����� � r )r r s ` r r r ( s" �� � �6�]�� �� �Nr c � � e Zd ZdZy)r z Exception for DBus properties.N)�__name__� __module__� __qualname__�__doc__� r r r r : s � �(�r r c �. � e Zd ZdZd� Zd� Zd� Zd� Zd� Zy)�PropertiesChangesz�Cache for properties changes. This class is useful to collect the changed properties and their values, before they are emitted on DBus. c �\ � || _ t � | _ | j |� | _ y)zNCreate the cache. :param obj: an object with DBus properties N)�_object�set�_properties_names�_find_properties_specs�_properties_specs)�selfr s r �__init__zPropertiesChanges.__init__F s( � � �� �!$��� �!%�!<�!<�S�!A�� r c � � t j t |� � }i }|j D ]^ }t |t j � s� |j |v r$t dj |j � � �|||j < �` |S )z�Find specifications of DBus properties. :param obj: an object with DBus properties :return: a map of property names and their specifications z9DBus property '{}' is defined in more than one interface.) r �from_xmlr �members� isinstance�Property�namer �format)r, r � specification�properties_specs�members r r* z(PropertiesChanges._find_properties_specsO s� � � *�2�2�7�3�<�@� � ��#�+�+�F� �f�&7�&@�&@�A���{�{� .�.�,�%�%+�V�F�K�K�%8�� � -3� �V�[�[� )� ,� � r c �2 � | j }t � | _ t t � }|D ]Y }| j | }t | j |� }t |j |� }|||j |j < �[ |j � S )af Flush the cache. The content of the cache will be composed to requests and the cache will be cleared. The requests can be used to emit the PropertiesChanged signal. The requests are a list of tuples, that contain an interface name and a dictionary of properties changes. :return: a list of requests ) r) r( r �dictr+ �getattrr' r �type�interface_namer3 �items)r, �content�requests� property_namer7 �value�variants r �flushzPropertiesChanges.flushf s� � � �(�(��!$��� � �t�$�� $�M��+�+�M�:�F� �D�L�L�-�8�E�!�&�+�+�u�5�G� <C�H�V�*�*� +�F�K�K� 8� %� �~�~� � r c �T � || j vrt dj |� � �y)z$Check if the property name is valid.z!DBus object has no property '{}'.N)r+ r r4 �r, r@ s r �check_propertyz PropertiesChanges.check_property� s3 � � �� 6� 6� 6�%�3�:�:�!��� � 7r c �\ � | j |� | j j |� y)zUpdate the cache.N)rF r) �addrE s r �updatezPropertiesChanges.update� s$ � � ���M�*� � � �"�"�=�1r N) r r r! r" r- r* rC rF rI r# r r r% r% ? s! � �� B� �. �:�2r r% c �P � e Zd ZdZd� Zededeeef de e fd�� Z d� Z d� Z y ) r a� Standard DBus interface org.freedesktop.DBus.Properties. DBus objects don't have to inherit this class, because the DBus library provides support for this interface by default. This class only extends this support. Report the changed property: .. code-block:: python self.report_changed_property('X') Emit all changes when the method is done: .. code-block:: python @emits_properties_changed def SetX(x: Int): self.set_x(x) c �$ � t | � | _ y)zInitialize the interface.N)r% �_properties_changes)r, s r r- z PropertiesInterface.__init__� s � �#4�T�#:�� r � interface�changed�invalidc � � y)z�Standard signal properties changed. :param interface: a name of an interface :param changed: a dictionary of changed properties :param invalid: a list of invalidated properties :return: Nr# )r, rM rN rO s r �PropertiesChangedz%PropertiesInterface.PropertiesChanged� s � � r c �: � | j j |� y)z`Reports changed DBus property. :param property_name: a name of a DBus property N)rL rI rE s r �report_changed_propertyz+PropertiesInterface.report_changed_property� s � � � � �'�'� �6r c �r � | j j � }|D ] \ }}| j ||g � � y)zFlush properties changes.N)rL rC rQ )r, r? rM �changess r r z!PropertiesInterface.flush_changes� s7 � ��+�+�1�1�3��"*� �I�w� � "� "�9�g�r� :� #+r N) r r r! r" r- r r r r r rQ rS r r# r r r r � sM � ��,;� � �3� ��c�7�l�9K� �#'��9� � � �7�;r r )� metaclassN)�abcr � collectionsr � functoolsr �typingr �dasbus.server.interfacer r �dasbus.specificationr r � dasbus.typingr r r r �__all__r � Exceptionr �objectr% r r# r r �<module>ra sR ��0 � #� � � 8� J� 9� 9� ���$ �)� � P2�� P2�f3;�G� 3;r
Save File
Cancel