← Back
Editing: interface.cpython-312.opt-1.pyc
� �ic�V � �� � d dl Z d dlZd dl mZ d dlmZ d dlmZ d dlmZ d dl m Z m Z d dl m Z mZmZmZ d dlmZ g d �Zd Zd Zd Zd � Zd� Zd� Z G d� de� Zdd�Z d� Z d� Z G d� de� Z y)� N)� Parameter)�get_type_hints)� get_dbus_name)�Signal)�DBusSpecificationError�DBusSpecification)� get_dbus_type� is_base_type�get_type_arguments�Tuple)� XMLGenerator)� dbus_class�dbus_interface� dbus_signal�get_xml� accepts_additional_arguments�"are_additional_arguments_supported� __dbus_xml__�*__dbus_method_returns_multiple_arguments__�-__dbus_handler_accepts_additional_arguments__c �( � t | t d� | S )a� Decorator for returning multiple arguments from a DBus method. The decorator allows to generate multiple output arguments in the XML specification of the decorated DBus method. Otherwise, there will be only one output argument in the specification. Define a DBus method with multiple output arguments: .. code-block:: python @returns_multiple_arguments def Method(self) -> Tuple[Int, Bool]: return 0, False The generated XML specification of the example: .. code-block:: xml <method name="Method"> <arg direction="out" name="return_0" type="i"/> <arg direction="out" name="return_1" type="b"/> </method> If the XML specification is not generated by the dbus_interface decorator, the returns_multiple_arguments decorator has no effect. :param method: a DBus method :return: a DBus method with a flag T)�setattr�$RETURNS_MULTIPLE_ARGUMENTS_ATTRIBUTE��methods �</usr/lib/python3.12/site-packages/dasbus/server/interface.py�returns_multiple_argumentsr : s � �< �F�8�$�?� �M� c �( � t | t d� | S )a[ Decorator for accepting extra arguments in a DBus method. The decorator allows the server object handler to propagate additional information about the DBus call into the decorated method. Use a dictionary of keyword arguments: .. code-block:: python @accepts_additional_arguments def Method(x: Int, y: Str, **info): pass Or use keyword only parameters: .. code-block:: python @accepts_additional_arguments def Method(x: Int, y: Str, *, call_info): pass At this moment, the library provides only the call_info argument generated by GLibServer.get_call_info, but the additional arguments can be customized in the _get_additional_arguments method of the server object handler. :param method: a DBus method :return: a DBus method with a flag T)r �&ACCEPTS_ADDITIONAL_ARGUMENTS_ATTRIBUTEr s r r r \ s � �> �F�:�D�A� �Mr c �$ � t | t d� S )zyDoes the given DBus method accept additional arguments? :param method: a DBus method :return: True or False F)�getattrr r s r r r s � � �6�A�5� I�Ir c �. � e Zd ZdZdefd�Zd� Zd� Zd� Zy)r a� DBus signal. Can be used as: .. code-block:: python Signal = dbus_signal() Or as a method decorator: .. code-block:: python @dbus_signal def Signal(x: Int, y: Double): pass Signal is defined by the type hints of a decorated method. This method is accessible as: signal.definition If the signal is not defined by a method, it is expected to have no arguments and signal.definition is equal to None. Nc �. � || _ || _ d| _ y)z�Create a signal descriptor. :param definition: a definition of the emit function :param factory: a signal factory N)� definition�factory�name)�selfr% r& s r �__init__zdbus_signal.__init__� s � � %��� �� ��� r c � � | j �ydj t | � j j � |j � � | _ y)aV Set a name of the descriptor The descriptor has been assigned to the specified name. Generate a name of a private attribute that will be set to a signal in the ``__get__`` method. For example: ``__dbus_signal_my_name`` :param owner: the owning class :param name: the descriptor name Nz__{}_{})r' �format�type�__name__�lower)r( �ownerr' s r � __set_name__zdbus_signal.__set_name__� sB � � �9�9� � � �$�$� ��J� � � %� %� '� �J�J�L� �� r c � � |�| S t || j d� }|�'| j � }t || j |� |S )a� Get a value of the descriptor. If the descriptor is accessed as a class attribute, return the descriptor. If the descriptor is accessed as an instance attribute, return a signal created by the signal factory. :param instance: an instance of the owning class :param owner: an owning class :return: a value of the attribute N)r" r' r& r )r( �instancer/ �signals r �__get__zdbus_signal.__get__� sF � � � ��K���4�9�9�d�3�� �>��\�\�^�F� �H�d�i�i�� 0�� r c � � t d� �)z Set a value of the descriptor.zCan't set DBus signal.)�AttributeError)r( r2 �values r �__set__zdbus_signal.__set__� s � � � 5�6�6r ) r- � __module__� __qualname__�__doc__r r) r0 r4 r8 � r r r r � s" � ��, #'�� � �(�07r r c � � �� � �fd�}|S )ae DBus interface. A new DBus interface can be defined as: .. code-block:: python @dbus_interface class Interface(): ... The interface will be generated from the given class cls with a name interface_name and added to the DBus XML specification of the class. The XML specification is accessible as: .. code-block:: python Interface.__dbus_xml__ It is conventional for member names on DBus to consist of capitalized words with no punctuation. The generator of the XML specification enforces this convention to prevent unintended changes in the specification. You can provide the XML specification yourself, or override the generator class to work around these constraints. :param interface_name: a DBus name of the interface :param namespace: a sequence of strings c �p �� t g ������ }t j | |� }t | t |� | S �N)r �DBusSpecificationGenerator�generate_specificationr �DBUS_XML_ATTRIBUTE)�clsr' �xml�interface_name� namespaces ��r � decoratedz!dbus_interface.<locals>.decorated� s9 �� � �8�i�8� �8��(�?�?��T�J����'��-�� r r< )rE rF rG s `` r r r � s �� �<� �r c �R � t j | � }t | t |� | S )a� DBus class. A new DBus class can be defined as: .. code-block:: python @dbus_class class Class(Interface): ... DBus class can implement DBus interfaces, but it cannot define a new interface. The DBus XML specification will be generated from implemented interfaces (inherited) and it will be accessible as: .. code-block:: python Class.__dbus_xml__ )r@ rA r rB )rC rD s r r r s& � �. %� ;� ;�C� @�C� �C�#�S�)� �Jr c �h � t | t d� }|� t dj t � � �|S )z�Return XML specification of an object. :param obj: an object decorated with @dbus_interface or @dbus_class :return: a string with XML specification Nz)XML specification is not defined at '{}'.)r" rB r r+ )�obj�xml_specifications r r r s@ � � ��%7��>��� �$� 7� >� >�"� � � � � r c �: � e Zd ZdZeZ ej d� Ze dd�� Z e d� � Z e d� � Z e d� � Z e d� � Ze d � � Ze d � � Ze d � � Ze d � � Ze d � � Ze d� � Ze d� � Ze d� � Ze d� � Ze d� � Ze d� � Zy)r@ z,Class for generating DBus XML specification.z[A-Z][A-Za-z0-9]*Nc �� � | j |� }|r9| j � }|j |� | j |||� }|||< | j ||� }| j j |� S )aE Generates DBus XML specification for given class. If class defines a new interface, it will be added to the specification. :param interface_cls: class object to decorate :param str interface_name: name of the interface defined by class :return str: DBus specification in XML )�_collect_interfaces� _collect_standard_interfaces�update�_generate_interface�_generate_node� xml_generator�element_to_xml)rC � interface_clsrE � interfaces�all_interfaces� interface�nodes r rA z1DBusSpecificationGenerator.generate_specification8 s� � � �,�,�]�;� � � � =� =� ?�N� � !� !�*� -��/�/� � � ��I� *3�J�~� &� �!�!�-��<��� � �/�/��5�5r c � � | j j t j � }| j j |� S )z�Collect standard interfaces. Standard interfaces are implemented by default. :return: a dictionary of standard interfaces )rS �xml_to_elementr �STANDARD_INTERFACES�get_interfaces_from_node)rC rY s r rO z7DBusSpecificationGenerator._collect_standard_interfacesU s< � � � � �/�/� � 1� 1� �� � � �9�9�$�?�?r c � � i }t t j |� � D ]] }t |t d� }|s�| j j |� }| j j |� }|j |� �_ |S )z�Collect interfaces implemented by the class. Returns a dictionary that maps interface names to interface elements. :param interface_cls: a class object :return: a dictionary of implemented interfaces N) �reversed�inspect�getmror" rB rS r[ r] rP )rC rU rV �member� member_xmlrY �node_interfacess r rN z.DBusSpecificationGenerator._collect_interfacesb s| � � � � �w�~�~�m� <�=�F� ��);�T�B�J� �� �$�$�3�3�J�?�D� !� /� /� H� H�� N�O� � � �o� .� >� �r c � � | j j |� }t j |� D ]� \ }}| j |� s�| j ||� r�+| j |� r| j ||� }nb| j |� r| j ||� }n>| j |� r| j ||� }nt dj |� � �| j j ||� �� |S )ap Generate interface defined by given class. :param interface_cls: a class object that defines the interface :param interfaces: a dictionary of implemented interfaces :param interface_name: a name of the new interface :return: a new interface element :raises DBusSpecificationError: if a class member cannot be exported z+Unsupported definition of DBus member '{}'.)rS �create_interfacer` � getmembers�_is_exportable� _is_defined� _is_signal�_generate_signal� _is_property�_generate_property� _is_method�_generate_methodr r+ � add_child)rC rU rV rE rX � member_namerb �elements r rQ z.DBusSpecificationGenerator._generate_interface| s� � � �%�%�6�6�~�F� � $+�#5�#5�m�#D� �K���%�%�k�2�� ���z�;�7�� �~�~�f�%� �.�.�v�{�C���!�!�&�)� �0�0���E��� � ��'� �.�.�v�{�C��,�A�H�H�#��� � � � � '� '� �7� ;�1 $E�4 �r c �J � t | j j |� � S )z�Is the name of a class member exportable? The name is exportable if it follows the DBus specification. Only CamelCase names are allowed. )�bool� NAME_PATTERN� fullmatch)rC rq s r rh z)DBusSpecificationGenerator._is_exportable� s � � �C�$�$�.�.�{�;�<�<r c � � |j � D ]D }|D ]= }| j j |� s� | j j ||� s�< y �F y)z�Is the member name defined in given interfaces? :param interfaces: a dictionary of interfaces :param member_name: a name of the class member :return: True if the name is defined, otherwise False TF)�valuesrS � is_member�has_name)rC rV rq rX rb s r ri z&DBusSpecificationGenerator._is_defined� sY � � $�*�*�,�I�#���(�(�2�2�6�:� ��(�(�1�1�&�+�F� �� $� -� r c �" � t |t � S )z"Is the class member a DBus signal?)� isinstancer �rC rb s r rj z%DBusSpecificationGenerator._is_signal� s � � �&�+�.�.r c � � | j j |� }|j }|s|S | j |� D ]� \ }}}|t j k( rt dj |� � �t j }| j j |t |� |� }| j j ||� �� |S )z�Generate signal defined by a class member. :param member: a dbus_signal object. :param member_name: a name of the signal :return: a signal element raises DBusSpecificationError: if signal has defined return type z(Invalid return type of DBus signal '{}'.) rS � create_signalr% �_iterate_parametersr � DIRECTION_OUTr r+ �create_parameterr rp ) rC rb rq rr r r' � type_hint� direction� parameters r rk z+DBusSpecificationGenerator._generate_signal� s� � � �#�#�1�1�+�>���"�"����N�*-�*A�*A�&�*I� &�D�)�Y�� -� ;� ;�;�,� � "�F�;� /�� � *�7�7�I��)�)�:�:�� �i�(���I� � � � '� '��� ;�! +J�$ �r c # � K � t j |� }| j ||� E d{ ��� | j ||� E d{ ��� y7 � 7 ��w)z�Iterate over method parameters. For every parameter returns its name, a type hint and a direction. :param member: a method object :return: an iterator raises DBusSpecificationError: if parameters are invalid N)r` � signature�_iterate_in_parameters�_iterate_out_parameters)rC rb r� s r r� z.DBusSpecificationGenerator._iterate_parameters� sN � �� � �%�%�f�-� ��-�-�f�i�@�@�@��.�.�v�y�A�A�A� A��A�s! �+A�A �A�A�A�Ac # � K � t j }t |� }t |j � dd D ]� }|j | j }|t j t j fv r t |� r�J|t j k7 r t d� �||vrt dj |� � �||| |f�� �� y�w)z Iterate over input parameters.� Nz1Only positional or keyword arguments are allowed.z!Undefined type of parameter '{}'.) r � DIRECTION_INr �list� parameters�kindr � VAR_KEYWORD� KEYWORD_ONLYr �POSITIONAL_OR_KEYWORDr r+ )rC rb r� r� � type_hintsr' r� s r r� z1DBusSpecificationGenerator._iterate_in_parameters� s� � �� � &�2�2� �#�F�+� � ��-�-�.�q�r�2�D� �'�'��-�2�2�D� � �-�-�y�/E�/E�F�F�:�6�B���y�6�6�6�,�G�� � �:�%�,�7�>�>�t�D�� � � �4�(�)�3� 3�+ 3�s �CC c # � K � t j }t j }|j }||j u ry|�yt |t d� rjt |t � s t d� �t |� }t |� dk r t d� �t |� D ] \ }}dj ||� ||f�� � y|||f�� y�w)z Iterate over output parameters.NFz'Expected a tuple of multiple arguments.� z+Expected a tuple of more than one argument.z{}_{})r �RETURN_PARAMETERr� �return_annotation�emptyr" r r r r r �len� enumerater+ ) rC rb r� r' r� r� � type_args�i�type_args r r� z2DBusSpecificationGenerator._iterate_out_parameters s� � �� � !�1�1��%�3�3� � �/�/� � � ��� '� � � � � �6�?�� G� � �5�1�,�=�� � +�9�5�I��9�~��!�,�A�� � )�� 3� ��8� �n�n�T�1�-�x��B�B� 4� � �I�y�(�(�s �CCc �" � t |t � S )z$Is the class member a DBus property?)r| �propertyr} s r rl z'DBusSpecificationGenerator._is_propertyC s � � �&�(�+�+r c �$ � d}d} |j r1| j |j � \ \ }}}t j }|j r1| j |j � \ \ }}}t j }|j r |j rt j }|�t dj |� � �| j j |t |� |� S # t $ r t dj |� � d�w xY w)z�Generate DBus property defined by class member. :param member: a property object :param member_name: a property name :return: a property element raises DBusSpecificationError: if the property is invalid Nz%Undefined type of DBus property '{}'.z%DBus property '{}' is not accessible.) �fsetr� r � ACCESS_WRITE�fget� ACCESS_READ� ValueErrorr r+ �ACCESS_READWRITErS �create_propertyr )rC rb rq �accessr� �_s r rm z-DBusSpecificationGenerator._generate_propertyH s � � ��� � ��{�{�&)�&=�&=�f�k�k�&J�#�"�!�Y��*�7�7�� �{�{�&)�&=�&=�f�k�k�&J�#�"�!�Y��*�6�6�� �;�;�6�;�;�&�7�7�F� �>�(�7�>�>�{�K�� � � � �0�0� � �)� $� � � �� � �(�7�>�>�{�K��� � �s �A:C* �*%Dc �Z � t j |� xs t j |� S )a Is the class member a DBus method? Ignore the difference between instance method and class method. For example: .. code-block:: python class Foo(object): def bar(cls, x): pass inspect.isfunction(Foo.bar) # True inspect.isfunction(Foo().bar) # False inspect.ismethod(Foo.bar) # False inspect.ismethod(Foo().bar) # True _is_method(Foo.bar) # True _is_method(Foo().bar) # True )r` �ismethod� isfunctionr} s r rn z%DBusSpecificationGenerator._is_methodt s% � �0 � � ��'�E�7�+=�+=�f�+E�Er c �� � | j j |� }| j |� D ]H \ }}}| j j |t |� |� }| j j ||� �J |S )z�Generate method defined by given class member. :param member: a method object :param member_name: a name of the method :return: a method element )rS � create_methodr� r� r rp )rC rb rq r r' r� r� r� s r ro z+DBusSpecificationGenerator._generate_method� sz � � �"�"�0�0��=�� +.�*A�*A�&�*I� &�D�)�Y��)�)�:�:��m�I�.� ��I� � � � '� '�� � :� +J� � r c � � | j j � }| j j |dj |j � � t |j � � D ]! }| j j ||| � �# |S )z�Generate node element that specifies the given class. :param interface_cls: a class object :param interfaces: a dictionary of interfaces :return: a node element z Specifies {})rS � create_node� add_commentr+ r- �sorted�keysrp )rC rU rV rY rE s r rR z)DBusSpecificationGenerator._generate_node� s~ � � � � �,�,�.�� ���%�%� �.�'�'� �(>�(>�?� � %�Z�_�_�%6� 7�N� � � � '� '��j� �.H� I� 8� � r r? )r- r9 r: r; r rS �re�compileru � classmethodrA rO rN rQ rh ri rj rk r� r� r� rl rm rn ro rR r< r r r@ r@ / sg � �6� !�M� �2�:�:� 2�3�L��6� �6�8 � @� � @� �� ��2 �'� �'�R �=� �=� �� ��( �/� �/� �!� �!�F � B� � B� � 4� � 4�< �%)� �%)�N �,� �,� �) � �) �V �F� �F�2 �� ��( �� �r r@ )r< ) r` r� r �typingr �dasbus.namespacer � dasbus.signalr �dasbus.specificationr r � dasbus.typingr r r r � dasbus.xmlr �__all__rB r r r r r �objectr r r r r@ r< r r �<module>r� s� ��0 � � � !� *� � J� � � #� �� $� � 1� %� 4� '� �D �FJ�O7�&� O7�d$�N�8 �$G�� Gr
Save File
Cancel