← Back
Editing: container.cpython-312.pyc
� �ic � �` � d dl mZ d dlmZ d dlmZmZ ddgZ G d� de� Z G d� de � Z y) � )� get_dbus_path)� Publishable)�ObjPath�List�DBusContainerError� DBusContainerc � � e Zd ZdZy)r z,General exception for DBus container errors.N)�__name__� __module__� __qualname__�__doc__� � �</usr/lib/python3.12/site-packages/dasbus/server/container.pyr r s � �6�r c �~ � e Zd ZdZdd�Zd� Zdefd�Zdefd�Zd e e fd �Z de e fd �Z d � Z d e fd�Zd� Zd� Zd� Zy)r a� The container of DBus objects. A DBus container should be used to dynamically publish Publishable objects within the same namespace. It generates a unique DBus path for each object. It is able to resolve a DBus path into an object and an object into a DBus path. Example: .. code-block:: python # Create a container of tasks. container = DBusContainer( namespace=("my", "project"), basename="Task", message_bus=DBus ) # Publish a task. path = container.to_object_path(MyTask()) # Resolve an object path into a task. task = container.from_object_path(path) Nc � � || _ |rg |�|��}|dd | _ |d | _ i | _ t � | _ d| _ y)z�Create a new container. :param message_bus: a message bus :param namespace: a sequence of names :param basename: a string with the base name N���r )� _message_bus� _namespace� _basename� _container�set� _published�_counter)�self� message_bus� namespace�basenames r �__init__zDBusContainer.__init__? sM � � (��� �.�)�.�X�.�I�#�C�R�.���"�2� ��� ��� �%����� r c � � || _ y)z�Set the namespace. All DBus objects from the container should use the same namespace, so the namespace should be set up before any of the DBus objects are published. :param namespace: a sequence of names N)r )r r s r � set_namespacezDBusContainer.set_namespaceR s � � $��r � object_pathc �$ � | j |� S )z�Convert a DBus path to a published object. If no published object is found for the given DBus path, raise DBusContainerError. :param object_path: a DBus path :return: a published object )� _find_object�r r" s r �from_object_pathz DBusContainer.from_object_path] s � � � � ��-�-r �returnc �� � t |t � s-t dj t |� j � � �| j |� s| j |� | j |� S )a4 Convert a publishable object to a DBus path. If no DBus path is found for the given object, publish the object on the container message bus with a unique DBus path generated from the container namespace. :param obj: a publishable object :return: a DBus path z Type '{}' is not publishable.) � isinstancer � TypeError�format�typer �_is_object_published�_publish_object�_find_object_path�r �objs r �to_object_pathz DBusContainer.to_object_pathh sb � � �#�{�+��/�6�6�t�C�y�7I�7I�J�� � �(�(��-� � � �� %��%�%�c�*�*r � object_pathsc �@ � t t | j |� � S )z�Convert DBus paths to published objects. :param object_paths: a list of DBus paths :return: a list of published objects )�list�mapr& )r r3 s r �from_object_path_listz#DBusContainer.from_object_path_list| s � � �C��-�-�|�<�=�=r c �@ � t t | j |� � S )z�Convert publishable objects to DBus paths. :param objects: a list of publishable objects :return: a list of DBus paths )r5 r6 r2 )r �objectss r �to_object_path_listz!DBusContainer.to_object_path_list� s � � �C��+�+�W�5�6�6r c �0 � t |� | j v S )z�Is the given object published? :param obj: an object :return: True if the object is published, otherwise False )�idr r0 s r r- z"DBusContainer._is_object_published� s � � �#�w�$�/�/�)�)r r1 c �� � | j � }| j j ||j � � || j |< | j j t |� � |S )zlPublish the given object. :param obj: an object to publish :return: an object path )�_generate_object_pathr �publish_object�for_publicationr r �addr< )r r1 r" s r r. z DBusContainer._publish_object� sa � � �0�0�2� � ���(�(� � � � � !� � (+���� �$� �����B�s�G�$��r c �l � | j j � D ] \ }}||u s� |c S t d� �)z�Find a DBus path of the object. :param obj: a published object :return: a DBus path :raise: DBusContainerError if no object path is found zNo object path found.)r �itemsr )r r1 r" � found_objs r r/ z DBusContainer._find_object_path� s@ � � '+�o�o�&;�&;�&=� "�K���C� �"�"� '>� !� #� � r c �p � || j v r| j | S t dj |� � �)z�Find an object by its DBus path. :param object_path: a DBus path :return: a published object :raise: DBusContainerError if no object is found zUnknown object path '{}'.)r r r+ r% s r r$ zDBusContainer._find_object� s: � � �$�/�/� )��?�?�;�/� /� � '� .� .�{� ;� � r c � � | xj dz c_ t g | j �| j �t | j � ��� S )zwGenerate a unique object path. This method is not thread safe. :return: a unique object path � )r r r r �str)r s r r> z#DBusContainer._generate_object_path� sJ � � � � ��� � � � �_�_� � �N�N� � �� � � � � r )N)r r r r r r! r r& r2 r r7 r: r- r r. r/ r$ r> r r r r r $ si � ��4�& $� .�G� .�+�W� +�(>�$�w�-� >�7�d�7�m� 7�*��;� �" � � r N) �dasbus.namespacer �dasbus.server.publishabler � dasbus.typingr r �__all__� Exceptionr �objectr r r r �<module>rO s9 ��* +� 1� '� �� �� �� � k �F� k r
Save File
Cancel