-=[ Mr. Bumblebee ]=-
_Indonesia_
ó
X`Oc @@ s1 d Z d d l m Z d d l m Z m Z d d l m Z e e ƒ d ƒ d e j f d „ ƒ YZ
d< d= d> d? d@ dA dB dC dD dE dF dG dH dI dJ f Z e
ƒ Z x* e D]" \ Z
Z Z e j e
e e ƒ q¨ W[ [
[ [ d3 „ Z d4 e f d5 „ ƒ YZ d6 e f d7 „ ƒ YZ d8 Z d9 „ Z i Z d: „ Z d; S(K s! Support for plugin hooking logic.i ( t absolute_import( t registryt symbol_versioning( t lazy_imports
import textwrap
from bzrlib import (
_format_version_tuple,
errors,
pyutils,
)
from bzrlib.i18n import gettext
t KnownHooksRegistryc B@ s# e Z d „ Z d „ Z d „ Z RS( c C@ s | j | | f | | ƒ d S( N( t
register_lazy( t selft hook_module_namet hook_member_namet hook_factory_member_name( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt register_lazy_hook, s c c@ s/ x( | j ƒ D] } | | j | ƒ f Vq
Wd S( s. 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 bzrlib.tests.TestCase._clear_hooks.
N( t keyst key_to_parent_and_attribute( R t key( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt iter_parent_objects1 s c C@ s= | \ } } t j | | ƒ \ } } } t j | | ƒ | f S( s= 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.
( t pyutilst calc_parent_namet get_named_object( R t .1t module_namet member_namet
parent_modt
parent_membert attr( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR < s ( t __name__t
__module__R
R R ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR & s s
bzrlib.branchs Branch.hookst BranchHookss bzrlib.controldirs ControlDir.hookst ControlDirHookss bzrlib.commandss
Command.hookst CommandHookss
bzrlib.configt ConfigHookst _ConfigHookss bzrlib.infot hookst InfoHookss bzrlib.locks
Lock.hookst LockHookss bzrlib.merges Merger.hookst
MergeHookss bzrlib.msgeditort MessageEditorHookss bzrlib.mutabletrees MutableTree.hookst MutableTreeHookss bzrlib.smart.clients _SmartClient.hookst SmartClientHookss bzrlib.smart.servers SmartTCPServer.hookst SmartServerHookss
bzrlib.statust StatusHookss bzrlib.transports Transport.hookst TransportHookss& bzrlib.version_info_formats.format_rios RioVersionInfoBuilder.hookst RioVersionInfoBuilderHookss bzrlib.merge_directives BaseMergeDirective.hookst MergeDirectiveHooksc C@ s | \ } } t j | | ƒ S( sÁ 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 R ( t .0R R ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt known_hooks_key_to_objectc s t Hooksc B@ sh e Z d Z d
d
d „ Z d
d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z RS( s“ 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.
c C@ s5 t j | ƒ i | _ i | _ | | _ | | _ d S( s 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( t dictt __init__t _callable_namest _lazy_callable_namest _modulet _member_name( R t moduleR ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR/ t s
c C@ s† | | k r t j | ƒ ‚ n | j rK t j | j | j | f g ƒ } n d } t d | d | d | d | d | ƒ } | | | <d S( sO 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.
t namet doct
introducedt
deprecatedt callbacksN( t errorst DuplicateKeyR2 t _lazy_hookst
setdefaultR3 t Nonet HookPoint( R R5 R6 R7 R8 R9 t hookpoint( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt add_hook‚ s c C@ s t | j ƒ ƒ } g } | j j } | j | ƒ | j d t | ƒ ƒ | j d ƒ x› | D]“ } | | } y | j | j ƒ ƒ Wq\ t k
rî g } | j | ƒ | j d t | ƒ ƒ | j d ƒ | j d | f ƒ | j | ƒ q\ Xq\ Wd j | ƒ S( s Generate the documentation for this Hooks instance.
This introspects all the individual hooks and returns their docs as well.
t -t t ~sE An old-style hook. For documentation see the __init__ method of '%s'
s
(
t sortedR t __class__R t appendt lent docst AttributeErrort extendt join( R t
hook_namest hook_docsR5 t hook_namet hookt strings( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRI – s&
c C@ se | j j | d ƒ } | d k rQ | d k rQ | j j | j | j f d ƒ } n | d k ra d S| S( s> 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.
s No hook nameN( R0 t getR> R1 R R ( R t
a_callableR5 ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt
get_hook_name° s c C@ s¬ y | | } Wn) t k
r9 t j | j j | ƒ ‚ n Xy t | d ƒ } Wn& t k
ru t j | j | ƒ ‚ n X| | | | ƒ | d k r¨ | j
| | | ƒ n d S( s» 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.
t hook_lazyN( t KeyErrorR: t UnknownHookRF R t getattrRJ t UnsupportedOperationt install_named_hook_lazyR> t name_hook_lazy( R RO t callable_modulet callable_memberR5 RP RU ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRZ Â s
c C@ s’ y | | } Wn) t k
r9 t j | j j | ƒ ‚ n Xy | j | ƒ Wn! t k
rn | j | | ƒ n X| d k rŽ | j | | ƒ n d S( sß 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(
RV R: RW RF R RG RJ RP R> t name_hook( R RO RS R5 RP ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt install_named_hookÜ s
c C@ s„ y | | } Wn) t k
r9 t j | j j | ƒ ‚ n Xy t | d ƒ } Wn& t k
ru t j | j | ƒ ‚ n X| | ƒ d S( sƒ Uninstall named hooks.
:param hook_name: Hook point name
:param label: Label of the callable to uninstall
t uninstallN( RV R: RW RF R RX RJ RY t uninstall_named_hook( R RO t labelRP R` ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRa ó s
c C@ s | | j | <d S( s= Associate name with a_callable to show users what is running.N( R0 ( R RS R5 ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR^ s c C@ s | | j | | f <d S( N( R1 ( R R\ R] t
callable_name( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR[ s N(
R R t __doc__R> R/ RA RI RT RZ R_ Ra R^ R[ ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR- m s R? c B@ se e Z d Z d
d
d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d „ Z d „ Z RS( sL A single hook that clients can register to be called back when it fires.
:ivar name: The name of the hook.
:ivar doc: The docs for using the hook.
:ivar introduced: A version tuple specifying what version the hook was
introduced in. None indicates an unknown version.
:ivar 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.
c C@ sI | | _ | | _ | | _ | | _ | d k r< g | _ n | | _ d S( s> 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( R5 Rd R7 R8 R> t
_callbacks( R R5 R6 R7 R8 R9 ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR/ s c C@ sí g } | j | j ƒ | j d t | j ƒ ƒ | j d ƒ | j rX t | j ƒ } n d } | j t d ƒ | ƒ | j r§ t | j ƒ } | j t d ƒ | ƒ n | j d ƒ | j t j | j
d t ƒƒ | j d ƒ d j | ƒ S( sc Generate the documentation for this HookPoint.
:return: A string terminated in
.
RD RC t unknowns Introduced in: %ss Deprecated in: %st break_long_wordss
(
RG R5 RH R7 t _format_version_tuplet gettextR8 RK t textwrapt wrapRd t FalseRL ( R RQ t introduced_stringt deprecated_string( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRI , s
c C@ s( t | ƒ t | ƒ k o' | j | j k S( N( t typet __dict__( R t other( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt __eq__C s c C@ s, t j | | ƒ } | j j | | f ƒ d S( sV 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 t _LazyObjectGetterRe RG ( R t callback_modulet callback_membert callback_labelt
obj_getter( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRU F s c C@ s) t j | ƒ } | j j | | f ƒ d S( sõ 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 t
_ObjectGetterRe RG ( R t callbackRv Rw ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyRP S s c C@ s† g } x9 | j D]. } | \ } } | | k r | j | ƒ q q W| g k ra t d | ƒ ‚ n x | D] } | j j | ƒ qh Wd S( sp Uninstall the callback with the specified label.
:param label: Label of the entry to uninstall
s No entry with label %rN( Re RG RV t remove( R Rb t entries_to_removet entryt entry_callbackt entry_label( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR` ] s
c C@ s d „ | j Dƒ S( Nc s@ s! | ] \ } } | j ƒ Vq d S( N( t get_obj( R+ Ry R5 ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pys <genexpr>m s ( Re ( R ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt __iter__l s c C@ s
t | j ƒ S( N( RH Re ( R ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt __len__o s c C@ sÖ g } | j d t | ƒ j ƒ | j | j ƒ | j d ƒ | j } xT | D]L \ } } | j t | j ƒ ƒ ƒ | j d ƒ | j | ƒ | j d ƒ qM Wt | ƒ d k r¼ d | d <n | j d ƒ d j | ƒ S(
Ns <%s(s ), callbacks=[t (s ),i t )iÿÿÿÿs ]>RC ( RG Ro R R5 Re t reprR RH RL ( R RQ R9 Ry t
callback_name( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt __repr__r s
N(
R R Rd R> R/ RI Rr RU RP R` R€ R R† ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyR?
s
sý
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
`bzrlib.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 C@ sR t g } x9 t t j ƒ ƒ D]% } t | ƒ } | j | j ƒ ƒ q Wd j | ƒ S( Ns
( t _help_prefixRE t known_hooksR R, RG RI RL ( t topict segmentst hook_keyR ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt hooks_help_text¤ s
c C@ sA | | | f } t j | ƒ } t j | g ƒ j | | f ƒ d S( si 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 Rx R< R= RG ( t hookpoints_modulet hookpoints_nameRO RS R5 R
Rw ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt install_lazy_named_hook± s N( s
bzrlib.branchs Branch.hooksR ( s bzrlib.controldirs ControlDir.hooksR ( s bzrlib.commandss
Command.hooksR ( s
bzrlib.configR R ( s bzrlib.infos hooksR ( s bzrlib.locks
Lock.hooksR! ( s bzrlib.merges Merger.hooksR" ( s bzrlib.msgeditors hooksR# ( s bzrlib.mutabletrees MutableTree.hooksR$ ( s bzrlib.smart.clients _SmartClient.hooksR% ( s bzrlib.smart.servers SmartTCPServer.hooksR& ( s
bzrlib.statuss hooksR' ( s bzrlib.transports Transport.hooksR( ( s& bzrlib.version_info_formats.format_rios RioVersionInfoBuilder.hooksR) ( s bzrlib.merge_directives BaseMergeDirective.hooksR* ( Rd t
__future__R t bzrlibR R t bzrlib.lazy_importR t globalst RegistryR t _builtin_known_hooksRˆ t _hook_modulet _hook_attributet _hook_classR
R, R. R- t objectR? R‡ RŒ R< R ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/hooks.pyt <module> sD $
•
Copyright © 2017 || Recoded By Mr.Bumblebee