| Server IP : 217.160.0.244 / Your IP : 216.73.217.138 Web Server : Apache System : Linux infong-eu155 4.4.400-icpu-108 #2 SMP Wed Feb 11 11:51:01 UTC 2026 x86_64 User : u100174116 ( 6746176) PHP Version : 8.5.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /lib/python3/dist-packages/breezy/__pycache__/ |
Upload File : |
�
p��gA � � � % S r SSKJrJr SSKJr \" \" 5 S5 " S S\R 5 r " S S\R \ S 4 5 r
S
r \
" 5 r \ H u r
rr\ R! \
\\5 M C C
CCS r " S S \5 r " S
S5 rSrS r0 r\\\ \ \ 4 \\\R4 \ 4 4 \S' S r g)�google� )�errors�registry)� lazy_importzd
from breezy import (
_format_version_tuple,
pyutils,
)
from breezy.i18n import gettext
c � � \ rS rSrSrS rSrg)� UnknownHook�$ zBThe %(type)s hook '%(hook)s' is unknown in this version of breezy.c �Z � [ R R U 5 Xl X l g �N)r �BzrError�__init__�type�hook)�self� hook_type� hook_names �./usr/lib/python3/dist-packages/breezy/hooks.pyr
�UnknownHook.__init__' s � ���� � ��&� � � � � )r r N)�__name__�
__module__� __qualname__�__firstlineno__�_fmtr
�__static_attributes__� r r r r $ s � � O�D� r r c �& � \ rS rSrS rS rS rSrg)�KnownHooksRegistry�- c �, � U R X4UU5 g r )�
register_lazy)r �hook_module_name�hook_member_name�hook_factory_member_names r �register_lazy_hook�%KnownHooksRegistry.register_lazy_hook3 s � �
���
� 0� � $�
r c # �b # � U R 5 H nXR U5 4v � M g7f)a Yield (hook_key, (parent_object, attr)) tuples for every registered
hook, where 'parent_object' is the object that holds the hook
instance.
This is useful for resetting/restoring all the hooks to a known state,
as is done in breezy.tests.TestCase._clear_hooks.
N)�keys�key_to_parent_and_attribute)r �keys r �iter_parent_objects�&KnownHooksRegistry.iter_parent_objects< s+ � � � �9�9�;�C��7�7��<�<� <� �s �-/c �\ � [ R " U6 u p#n[ R X#5 U4$ )a Convert a known_hooks key to a (parent_obj, attr) pair.
:param key: A tuple (module_name, member_name) as found in the keys of
the known_hooks registry.
:return: The parent_object of the hook and the name of the attribute on
that parent object where the hook is kept.
)�pyutils�calc_parent_name�get_named_object)r r* �
parent_mod�
parent_member�attrs r r) �.KnownHooksRegistry.key_to_parent_and_attributeG s/ � � +2�*B�*B�C�*H�'�
�4��'�'�
�B�D�H�Hr r N)r r r r r% r+ r) r r r r r r - s � �
� =� Ir r �Hooks))z
breezy.branchz Branch.hooks� BranchHooks)zbreezy.controldirzControlDir.hooks�ControlDirHooks)zbreezy.commandsz
Command.hooks� CommandHooks)z
breezy.config� ConfigHooks� _ConfigHooks)z breezy.info�hooks� InfoHooks)z breezy.lockz
Lock.hooks� LockHooks)z breezy.mergez Merger.hooks�
MergeHooks)zbreezy.msgeditorr; �MessageEditorHooks)zbreezy.mutabletreezMutableTree.hooks�MutableTreeHooks)zbreezy.bzr.smart.clientz_SmartClient.hooks�SmartClientHooks)zbreezy.bzr.smart.serverzSmartTCPServer.hooks�SmartServerHooks)z
breezy.statusr; � StatusHooks)zbreezy.transportzTransport.hooks�TransportHooks)z&breezy.version_info_formats.format_riozRioVersionInfoBuilder.hooks�RioVersionInfoBuilderHooks)zbreezy.merge_directivezBaseMergeDirective.hooks�MergeDirectiveHooksc �( � [ R " U 6 $ )z�Convert a known_hooks key to a object.
:param key: A tuple (module_name, member_name) as found in the keys of
the known_hooks registry.
:return: The object this specifies.
)r. r0 )r* s r �known_hooks_key_to_objectrH o s � � � #� #�S� )�)r c �V � \ rS rSrSrSS jrSS jrS rS rS r S r
S
r S r S r
S
rg)r5 �y z�A dictionary mapping hook name to a list of callables.
e.g. ['FOO'] Is the list of items to be called when the
FOO hook is triggered.
Nc �b � [ R U 5 0 U l 0 U l Xl X l g)z�Create a new hooks dictionary.
:param module: The module from which this hooks dictionary should be loaded
(used for lazy hooks)
:param member_name: Name under which this hooks dictionary should be loaded.
(used for lazy hooks)
N)�dictr
�_callable_names�_lazy_callable_names�_module� _member_name)r �module� member_names r r
�Hooks.__init__� s+ � �
�
�
�d�� !�� �$&��!� � � '�r c �� � X; a [ R " U5 eU R ( a. [ R U R U R
U4/ 5 nOSn[
UUUUUS9nX`U' g)a Add a hook point to this dictionary.
:param name: The name of the hook, for clients to use when registering.
:param doc: The docs for the hook.
:param introduced: When the hook was introduced (e.g. (0, 15)).
:param deprecated: When the hook was deprecated, None for
not-deprecated.
N)�name�doc�
introduced�
deprecated� callbacks)r � DuplicateKeyrO � _lazy_hooks�
setdefaultrP � HookPoint)r rU rV rW rX rY � hookpoints r �add_hook�Hooks.add_hook� sp � � �<��%�%�d�+� +� �<�<�#�.�.�� � �t� 0� 0�$�7���I� �I� ���!�!� �
� � �T�
r c �\ � [ U R 5 5 n/ nU R R nUR U5 UR S[ U5 - 5 UR S5 U H& nX nUR UR
5 5 M( SR U5 $ )zGenerate the documentation for this Hooks instance.
This introspects all the individual hooks and returns their docs as well.
�-� �
)�sortedr( � __class__r �append�len�docs�join)r �
hook_names� hook_docsrU r r s r ri �
Hooks.docs� s� � �
�D�I�I�K�(�
�� ��~�~�&�&������ �����s�4�y� �)����� �#�I��?�D� � � �T�Y�Y�[� )� $� �y�y��#�#r c � � U R R US5 nUc5 Ub2 U R R UR UR 4S5 nUc gU$ )a Get the name for a_callable for UI display.
If no name has been registered, the string 'No hook name' is returned.
We use a fixed string rather than repr or the callables module because
the code names are rarely meaningful for end users and this is not
intended for debugging.
Nz No hook name)rM �getrN r r �r �
a_callablerU s r �
get_hook_name�Hooks.get_hook_name� sa � � �#�#�'�'�
�D�9�� �<�J� 2��,�,�0�0��&�&�
�(;�(;�<�d��D� �<�!�� r c � � X n UR nU" X#U5 Ub U R X#U5 gg! [ a! [ U R R U5 ef = f! [
a" [ R " U R U 5 ef = f)a{ Install a_callable in to the hook hook_name lazily, and label it.
:param hook_name: A hook name. See the __init__ method for the complete
list of hooks.
:param callable_module: Name of the module in which the callable is
present.
:param callable_member: Member name of the callable.
:param name: A name to associate the callable with, to show users what
is running.
N)
�KeyErrorr rf r � hook_lazy�AttributeErrorr �UnsupportedOperation�install_named_hook_lazy�name_hook_lazy)r r �callable_module�callable_memberrU r rv s r ry � Hooks.install_named_hook_lazy� s� � � B��?�D� >� ���I�
�o�� =� � � � � ��$� G� �� � B� �d�n�n� 5� 5�y�A� A� B�� � R��-�-�d�.J�.J�D�Q� Q� R�s �3 � A! �+A �!,B
c � � X n UR U5 Ub U R X#5 gg! [ a! [ U R R U5 ef = f! [
a UR
X#5 Naf = f)a� Install a_callable in to the hook hook_name, and label it name.
:param hook_name: A hook name. See the __init__ method for the complete
list of hooks.
:param a_callable: The callable to be invoked when the hook triggers.
The exact signature will depend on the hook - see the __init__
method for details on each hook.
:param name: A name to associate a_callable with, to show users what is
running.
N)ru r rf r rg rw r � name_hook)r r rq rU r s r �install_named_hook�Hooks.install_named_hook� s � � B��?�D� (� �K�K�
� #� � � �N�N�:� ,� �� � B� �d�n�n� 5� 5�y�A� A� B��
� (� �I�I�j� '� (�s �. �A �+A� A:�9A:c �� � X n UR nU" U5 g! [ a! [ U R R U5 ef = f! [
a" [ R " U R U 5 ef = f)zkUninstall named hooks.
:param hook_name: Hook point name
:param label: Label of the callable to uninstall
N) ru r rf r � uninstallrw r rx �uninstall_named_hook)r r �labelr r� s r r� �Hooks.uninstall_named_hook� s| � � B��?�D� � ���I�
�e� �� � B� �d�n�n� 5� 5�y�A� A� B�� � O��-�-�d�.G�.G��N� N� O�s � � A
�+A�
,A6c � � X R U' g)z=Associate name with a_callable to show users what is running.N)rM rp s r r �Hooks.name_hook s � �+/� � �Z�(r c �" � X0R X4' g r )rN )r r{ r| �
callable_names r rz �Hooks.name_hook_lazy s � �HU�!�!�?�"D�Er )rM rN rP rO �NNr )r r r r �__doc__r
r_ ri rr ry r� r� r rz r r r r r5 r5 y s6 � �� (� �4$� �"H�4-�. �"0�Vr c �R � \ rS rSrSrSS jrS rS rS rS r S r
S
r S r S r
S
rg)r] i an A single hook that clients can register to be called back when it fires.
Attributes:
name: The name of the hook.
doc: The docs for using the hook.
introduced: A version tuple specifying what version the hook was
introduced in. None indicates an unknown version.
deprecated: A version tuple specifying what version the hook was
deprecated or superseded in. None indicates that the hook
is not superseded or deprecated. If the hook is
superseded then the doc should describe the recommended
replacement hook to register for.
Nc �V � Xl X l X0l X@l Uc / U l gXPl g)a Create a HookPoint.
:param name: The name of the hook, for clients to use when registering.
:param doc: The docs for the hook.
:param introduced: When the hook was introduced (e.g. (0, 15)).
:param deprecated: When the hook was deprecated, None for
not-deprecated.
N)rU r� rW rX �
_callbacks)r rU rV rW rX rY s r r
�HookPoint.__init__" s* � � � �� �$��$�� � � �D�O� '�Or c �~ � SSK n/ nUR U R 5 UR S[ U R 5 - 5 UR S5 U R ( a [ U R 5 nOSnUR [
S5 U- 5 U R ( a2 [ U R 5 nUR [
S5 U- 5 UR S5 UR UR U R SS 95 UR S5 S
R U5 $ ) zTGenerate the documentation for this HookPoint.
:return: A string terminated in \n.
� N�~rc �unknownzIntroduced in: %szDeprecated in: %sF)�break_long_wordsrd ) �textwraprg rU rh rW �_format_version_tuple�gettextrX �extend�wrapr� rj )r r� �strings�introduced_string�deprecated_strings r ri �HookPoint.docs4 s� � �
������t�y�y�!����s�S����^�+�,����r�� �?�?� 5�d�o�o� F� � )� ����w� 2�3�6G�G�H� �?�?� 5�d�o�o� F� � �N�N�7�#6�7�:K�K� L����r�����x�}�}�T�\�\�E�}�J�K����r���y�y��!�!r c �l � [ U[ U 5 5 =( a UR U R :H $ r )�
isinstancer �__dict__)r �others r �__eq__�HookPoint.__eq__L s% � ��%��d��,�P�� � �4�=�=�1P�Pr c �h � [ R " X5 nU R R XC45 g)a& Lazily register a callback to be called when this HookPoint fires.
:param callback_module: Module of the callable to use when this
HookPoint fires.
:param callback_member: Member name of the callback.
:param callback_label: A label to show in the UI while this callback is
processing.
N)r �_LazyObjectGetterr� rg )r �callback_module�callback_member�callback_label�
obj_getters r rv �HookPoint.hook_lazyO s) � � �/�/��Q�
� ��� � �
� ;�<r c �h � [ R " U5 nU R R X245 g)z�Register a callback to be called when this HookPoint fires.
:param callback: The callable to use when this HookPoint fires.
:param callback_label: A label to show in the UI while this callback is
processing.
N)r �
_ObjectGetterr� rg )r �callbackr� r� s r r �HookPoint.hook[ s) � � �+�+�H�5�
� ��� � �
� ;�<r c �� � / nU R H nUu pEXQ:X d M UR U5 M! U/ :X a [ SR U5 5 eU H nU R R U5 M g)z`Uninstall the callback with the specified label.
:param label: Label of the entry to uninstall
zNo entry with label {!r}N)r� rg ru �format�remove)r r� �entries_to_remove�entry�entry_callback� entry_labels r r� �HookPoint.uninstalle sq � �
���_�_�E�,1� )�^��#�!�(�(��/� %� �� "��5�<�<�U�C�D� D�&�E� �O�O� "� "�5� )� 'r c �( � S U R 5 $ )Nc 3 �F # � U H u pUR 5 v � M g 7fr )�get_obj)�.0r� rU s r � <genexpr>�%HookPoint.__iter__.<locals>.<genexpr>u s � � �I� �~�x�� � �"�"� �s � !)r� �r s r �__iter__�HookPoint.__iter__t s � �I�� � �I�Ir c �, � [ U R 5 $ r )rh r� r� s r �__len__�HookPoint.__len__w s � ��4�?�?�#�#r c � � / nUR SR [ U 5 R 5 5 UR U R 5 UR S5 U R
nU H` u p4UR [
UR 5 5 5 UR S5 UR U5 UR S5 Mb [ U5 S:X a SUS' UR S5 S R U5 $ )
Nz<{}(z), callbacks=[�(z),r �)���z]>rc )
rg r� r r rU r� �reprr� rh rj )r r� rY r� �
callback_names r �__repr__�HookPoint.__repr__z s� � ������v�}�}�T�$�Z�%8�%8�9�:����t�y�y�!����'�(��O�O� �'0� #�H� �N�N�4�� 0� 0� 2�3� 4� �N�N�3� � �N�N�=� )� �N�N�4� � (1�
�y�>�Q� � �G�B�K����t� ��w�w�w� � r )r� r� rX rW rU r� )r r r r r� r
ri r� rv r r� r� r� r� r r r r r] r] s6 � � � (�$"�0Q�
=�=�
*� J�$� r r] a�
Hooks
=====
Introduction
------------
A hook of type *xxx* of class *yyy* needs to be registered using::
yyy.hooks.install_named_hook("xxx", ...)
See :doc:`Using hooks<../user-guide/hooks>` in the User Guide for examples.
The class that contains each hook is given before the hooks it supplies. For
instance, BranchHooks as the class is the hooks class for
`breezy.branch.Branch.hooks`.
Each description also indicates whether the hook runs on the client (the
machine where bzr was invoked) or the server (the machine addressed by
the branch URL). These may be, but are not necessarily, the same machine.
Plugins (including hooks) are run on the server if all of these is true:
* The connection is via a smart server (accessed with a URL starting with
"bzr://", "bzr+ssh://" or "bzr+http://", or accessed via a "http://"
URL when a smart server is available via HTTP).
* The hook is either server specific or part of general infrastructure rather
than client specific code (such as commit).
c �� � [ /n[ [ R 5 5 H- n[ U5 nUR UR
5 5 M/ SR U5 $ )Nrd )� _help_prefixre � known_hooksr( rH rg ri rj )�topic�segments�hook_keyr; s r �hooks_help_textr� � sN � � �~�H��;�+�+�-�.��)�(�3������
�
� �%� /� �9�9�X� � r r[ c � � XU4n[ R " U5 n[ R U/ 5 R Xd45 g)aM Install a callable in to a hook lazily, and label it name.
:param hookpoints_module: Module name of the hook points.
:param hookpoints_name: Name of the hook points.
:param hook_name: A hook name.
:param callable: a callable to call for the hook.
:param name: A name to associate a_callable with, to show users what is
running.
N)r r� r[ r\ rg )�hookpoints_module�hookpoints_namer rq rU r* r� s r �install_lazy_named_hookr� � s< � � �y�
9�C��'�'�
�3�J����3��#�*�*�J�+=�>r N) �
__docformat__rc r r r �globalsr r �Registry�strr �_builtin_known_hooksr� � _hook_module�_hook_attribute� _hook_classr% rH rL r5 r] r� r� r[ �tuple�listr� �__annotations__r� r r r �<module>r� s ��" ��
� '� � $� � �I�� � �&�/�/� �#I��*�*�3��<�8� #I�L� �, !�"� �2F�.�L�/�;��"�"�<� �+�N� 3G��,���*�WV�D� WV�tu � u �p � �B � UW� �T�%��S�#�
�&��U�8�3I�3I�3�3N�-O�(P�P�
Q� V�?r