← Back
Editing: error.cpython-312.pyc
� �ic]" � � � d dl mZmZ d dlmZ g d�Zd� Z G d� de� Z G d� de� � Z G d � d e � Z G d � d e � Z G d� de � Z y)� )�ABCMeta�abstractmethod�� get_dbus_name)�get_error_decorator� DBusError�AbstractErrorRule� ErrorRule�DefaultErrorRule� ErrorMapperc � � � d� fd� }|S )a� Generate a decorator for DBus errors. Create a function for decorating Python exception classes. The decorator will add a new rule to the given error mapper that will map the class to the specified error name. Definition of the decorator: .. code-block:: python decorator(error_name, namespace=()) The decorator accepts a name of the DBus error and optionally a namespace of the DBus name. The namespace will be used as a prefix of the DBus name. Usage: .. code-block:: python # Create an error mapper. error_mapper = ErrorMapper() # Create a decorator for DBus errors and use it to map # the class ExampleError to the name my.example.Error. dbus_error = create_error_decorator(error_mapper) @dbus_error("my.example.Error") class ExampleError(DBusError): pass :param error_mapper: an error mapper :return: a decorator c �0 �� � t g |�� ��� � �� fd�}|S )Nc �@ �� �j t | ��� � | S )N)�exception_type� error_name)�add_ruler )�cls� error_mapperr s ���1/usr/lib/python3.12/site-packages/dasbus/error.py� decoratedz9get_error_decorator.<locals>.decorator.<locals>.decoratedI s% �� � � !� !�)� "�%�#� � �J� r )r � namespacer r s ` �r � decoratorz&get_error_decorator.<locals>.decoratorF s" �� �"�:�I�:�z�:� � � �r )� r )r r s ` r r r # s �� �F � �r c � � e Zd ZdZy)r zA default DBus error.N)�__name__� __module__� __qualname__�__doc__r r r r r U s � � �r r c �T � e Zd ZdZg Zed� � Zed� � Zed� � Zed� � Z y)r z=Abstract rule for mapping a Python exception to a DBus error.c � � y)z�Is this rule matching the given exception type? :param exception_type: a type of the Python error :return: True or False Nr ��selfr s r � match_typez AbstractErrorRule.match_type_ � � � r c � � y)z�Get a DBus name for the given exception type. :param exception_type: a type of the Python error :return: a name of the DBus error Nr r" s r �get_namezAbstractErrorRule.get_nameh r% r c � � y)z�Is this rule matching the given DBus error? :param error_name: a name of the DBus error :return: True or False Nr �r# r s r � match_namez AbstractErrorRule.match_nameq r% r c � � y)z�Get an exception type of the given DBus error. param error_name: a name of the DBus error :return: a type of the Python error Nr r) s r �get_typezAbstractErrorRule.get_typez r% r N) r r r r � __slots__r r$ r' r* r, r r r r r Z sX � �G��I�� � � � � � � � � � � � � � � r r )� metaclassc �6 � e Zd ZdZddgZd� Zd� Zd� Zd� Zd� Z y ) r z4Rule for mapping a Python exception to a DBus error.�_exception_type� _error_namec � � || _ || _ y)aV Create a new error rule. The rule will return the Python type exception_type for the DBue error error_name. The rule will return the DBue name error_name for the Python type exception_type :param exception_type: a type of the Python error :param error_name: a name of the DBus error N)r0 r1 )r# r r s r �__init__zErrorRule.__init__� s � � .�� �%��r c � � | j |k( S )�/Is this rule matching the given exception type?�r0 r" s r r$ zErrorRule.match_type� s � ��#�#�~�5�5r c � � | j S �z-Get a DBus name for the given exception type.�r1 r" s r r' zErrorRule.get_name� s � �� � � r c � � | j |k( S )�+Is this rule matching the given DBus error?r9 r) s r r* zErrorRule.match_name� s � �� � �:�-�-r c � � | j S �z.Get an exception type of the given DBus error.r6 r) s r r, zErrorRule.get_type� s � ��#�#�#r N� r r r r r- r3 r$ r' r* r, r r r r r � s- � �>� ���I� &� 6� �.�$r r c �6 � e Zd ZdZddgZd� Zd� Zd� Zd� Zd� Z y ) r z<Default rule for mapping a Python exception to a DBus error.� _default_type�_default_namespacec � � || _ || _ y)a~ Create a new default rule. The rule will return the Python type default_type for the all DBus errors. The rule will generate a DBus name with the prefix default_namespace for all Python exception types. :param default_type: a default type of the Python error :param default_namespace: a default namespace of the DBus error N)r@ rA )r# � default_type�default_namespaces r r3 zDefaultErrorRule.__init__� s � � *���"3�� r c � � y)r5 Tr r" s r r$ zDefaultErrorRule.match_type� � � �r c �D � t g | j �|j ��� S r8 )r rA r r" s r r' zDefaultErrorRule.get_name� s! � � �O�d� 5� 5�O�~�7N�7N�O�Or c � � y)r; Tr r) s r r* zDefaultErrorRule.match_name� rF r c � � | j S r= )r@ r) s r r, zDefaultErrorRule.get_type� s � ��!�!�!r Nr> r r r r r � s. � �F� � ��I� 4� �P��"r r c �: � e Zd ZdZdgZd� Zdefd�Zd� Zd� Z d� Z y ) r z3Class for mapping Python exceptions to DBus errors.� _error_rulesc �2 � g | _ | j � y)zCreate a new error mapper.N)rK � reset_rules�r# s r r3 zErrorMapper.__init__� s � � ��� ���r �rulec �: � | j j |� y)z�Add a rule to the error mapper. The new rule will have a higher priority than the rules already contained in the error mapper. :param rule: an error rule :type rule: an instance of AbstractErrorRule N)rK �append)r# rO s r r zErrorMapper.add_rule� s � � ��� � ��&r c �R � g | _ | j t t d�� � y)z�Reset rules in the error mapper. Reset the error rules to the initial state. All rules will be replaced with the default ones. )�not�known�Error)rC rD N)rK r r r rN s r rM zErrorMapper.reset_rules� s( � � ��� � � �&�"� 7� � r c �� � t | j � D ]& }|j |� s�|j |� c S t dj |j � � �)a# Get a DBus name of the Python exception. Try to find a matching rule in the error mapper. If a rule matches the given exception type, use the rule to get the name of the DBus error. The rules in the error mapper are processed in the reversed order to respect the priority of the rules. :param exception_type: a type of the Python error :type exception_type: a subclass of Exception :return: a name of the DBus error :raise LookupError: if no name is found zNo name found for '{}'.)�reversedrK r$ r' � LookupError�formatr )r# r rO s r �get_error_namezErrorMapper.get_error_name� sW � � �T� .� .�/�D����~�.��}�}�^�4�4� 0� � %� ,� ,�^�-D�-D� E� � r c � � t | j � D ]& }|j |� s�|j |� c S t dj |� � �)a% Get a Python exception type of the DBus error. Try to find a matching rule in the error mapper. If a rule matches the given name of a DBus error, use the rule to get the type of a Python exception. The rules in the error mapper are processed in the reversed order to respect the priority of the rules. :param error_name: a name of the DBus error :return: a type of the Python exception :rtype: a subclass of Exception :raise LookupError: if no type is found zNo type found for '{}'.)rW rK r* r, rX rY )r# r rO s r �get_exception_typez ErrorMapper.get_exception_type sM � � �T� .� .�/�D����z�*��}�}�Z�0�0� 0� �3�:�:�:�F�G�Gr N) r r r r r- r3 r r rM rZ r\ r r r r r � s/ � �=� � �I�� '� .� '� � �0Hr r N)�abcr r �dasbus.namespacer �__all__r � Exceptionr r r r �objectr r r r �<module>rb s_ ��* (� *� ��/�d � � � ' �'� ' �T%$�!� %$�P%"�(� %"�PPH�&� PHr
Save File
Cancel