← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/hooks.py

  • Committer: IWATA Hidetaka
  • Date: 2010-12-26 13:19:11 UTC
  • mto: This revision was merged to the branch mainline in revision 5593.
  • Revision ID: iwata0303@gmail.com-20101226131911-o7txs0fnji5zekq1
add icon resources tbzrcommand(w)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/hooks.py
16
16
 
17
17
 
18
18
"""Support for plugin hooking logic."""
19
 
from bzrlib import registry
 
19
from bzrlib import (
 
20
    pyutils,
 
21
    registry,
 
22
    symbol_versioning,
 
23
    )
20
24
from bzrlib.lazy_import import lazy_import
21
 
from bzrlib.symbol_versioning import deprecated_method
22
25
lazy_import(globals(), """
23
26
import textwrap
24
27
 
30
33
""")
31
34
 
32
35
 
33
 
known_hooks = registry.Registry()
34
 
# known_hooks registry contains
35
 
# tuple of (module, member name) which is the hook point
36
 
# module where the specific hooks are defined
37
 
# callable to get the empty specific Hooks for that attribute
38
 
known_hooks.register_lazy(('bzrlib.branch', 'Branch.hooks'), 'bzrlib.branch',
39
 
    'BranchHooks')
40
 
known_hooks.register_lazy(('bzrlib.bzrdir', 'BzrDir.hooks'), 'bzrlib.bzrdir',
41
 
    'BzrDirHooks')
42
 
known_hooks.register_lazy(('bzrlib.commands', 'Command.hooks'),
43
 
    'bzrlib.commands', 'CommandHooks')
44
 
known_hooks.register_lazy(('bzrlib.info', 'hooks'),
45
 
    'bzrlib.info', 'InfoHooks')
46
 
known_hooks.register_lazy(('bzrlib.lock', 'Lock.hooks'), 'bzrlib.lock',
47
 
    'LockHooks')
48
 
known_hooks.register_lazy(('bzrlib.merge', 'Merger.hooks'), 'bzrlib.merge',
49
 
    'MergeHooks')
50
 
known_hooks.register_lazy(('bzrlib.msgeditor', 'hooks'), 'bzrlib.msgeditor',
51
 
    'MessageEditorHooks')
52
 
known_hooks.register_lazy(('bzrlib.mutabletree', 'MutableTree.hooks'),
53
 
    'bzrlib.mutabletree', 'MutableTreeHooks')
54
 
known_hooks.register_lazy(('bzrlib.smart.client', '_SmartClient.hooks'),
55
 
    'bzrlib.smart.client', 'SmartClientHooks')
56
 
known_hooks.register_lazy(('bzrlib.smart.server', 'SmartTCPServer.hooks'),
57
 
    'bzrlib.smart.server', 'SmartServerHooks')
58
 
known_hooks.register_lazy(
59
 
    ('bzrlib.version_info_formats.format_rio', 'RioVersionInfoBuilder.hooks'),
60
 
    'bzrlib.version_info_formats.format_rio', 'RioVersionInfoBuilderHooks')
61
 
known_hooks.register_lazy(
62
 
    ('bzrlib.merge_directive', 'BaseMergeDirective.hooks'),
63
 
    'bzrlib.merge_directive', 'MergeDirectiveHooks')
 
36
class KnownHooksRegistry(registry.Registry):
 
37
    # known_hooks registry contains
 
38
    # tuple of (module, member name) which is the hook point
 
39
    # module where the specific hooks are defined
 
40
    # callable to get the empty specific Hooks for that attribute
 
41
 
 
42
    def register_lazy_hook(self, hook_module_name, hook_member_name,
 
43
            hook_factory_member_name):
 
44
        self.register_lazy((hook_module_name, hook_member_name),
 
45
            hook_module_name, hook_factory_member_name)
 
46
 
 
47
    def iter_parent_objects(self):
 
48
        """Yield (hook_key, (parent_object, attr)) tuples for every registered
 
49
        hook, where 'parent_object' is the object that holds the hook
 
50
        instance.
 
51
 
 
52
        This is useful for resetting/restoring all the hooks to a known state,
 
53
        as is done in bzrlib.tests.TestCase._clear_hooks.
 
54
        """
 
55
        for key in self.keys():
 
56
            yield key, self.key_to_parent_and_attribute(key)
 
57
 
 
58
    def key_to_parent_and_attribute(self, (module_name, member_name)):
 
59
        """Convert a known_hooks key to a (parent_obj, attr) pair.
 
60
 
 
61
        :param key: A tuple (module_name, member_name) as found in the keys of
 
62
            the known_hooks registry.
 
63
        :return: The parent_object of the hook and the name of the attribute on
 
64
            that parent object where the hook is kept.
 
65
        """
 
66
        parent_mod, parent_member, attr = pyutils.calc_parent_name(module_name,
 
67
            member_name)
 
68
        return pyutils.get_named_object(parent_mod, parent_member), attr
 
69
 
 
70
 
 
71
_builtin_known_hooks = (
 
72
    ('bzrlib.branch', 'Branch.hooks', 'BranchHooks'),
 
73
    ('bzrlib.bzrdir', 'BzrDir.hooks', 'BzrDirHooks'),
 
74
    ('bzrlib.commands', 'Command.hooks', 'CommandHooks'),
 
75
    ('bzrlib.info', 'hooks', 'InfoHooks'),
 
76
    ('bzrlib.lock', 'Lock.hooks', 'LockHooks'),
 
77
    ('bzrlib.merge', 'Merger.hooks', 'MergeHooks'),
 
78
    ('bzrlib.msgeditor', 'hooks', 'MessageEditorHooks'),
 
79
    ('bzrlib.mutabletree', 'MutableTree.hooks', 'MutableTreeHooks'),
 
80
    ('bzrlib.smart.client', '_SmartClient.hooks', 'SmartClientHooks'),
 
81
    ('bzrlib.smart.server', 'SmartTCPServer.hooks', 'SmartServerHooks'),
 
82
    ('bzrlib.status', 'hooks', 'StatusHooks'),
 
83
    ('bzrlib.version_info_formats.format_rio', 'RioVersionInfoBuilder.hooks',
 
84
        'RioVersionInfoBuilderHooks'),
 
85
    ('bzrlib.merge_directive', 'BaseMergeDirective.hooks',
 
86
        'MergeDirectiveHooks'),
 
87
    )
 
88
 
 
89
known_hooks = KnownHooksRegistry()
 
90
for (_hook_module, _hook_attribute, _hook_class) in _builtin_known_hooks:
 
91
    known_hooks.register_lazy_hook(_hook_module, _hook_attribute, _hook_class)
 
92
del _builtin_known_hooks, _hook_module, _hook_attribute, _hook_class
64
93
 
65
94
 
66
95
def known_hooks_key_to_object((module_name, member_name)):
70
99
        the known_hooks registry.
71
100
    :return: The object this specifies.
72
101
    """
73
 
    return registry._LazyObjectGetter(module_name, member_name).get_obj()
74
 
 
75
 
 
76
 
def known_hooks_key_to_parent_and_attribute((module_name, member_name)):
77
 
    """Convert a known_hooks key to a object.
78
 
 
79
 
    :param key: A tuple (module_name, member_name) as found in the keys of
80
 
        the known_hooks registry.
81
 
    :return: The object this specifies.
82
 
    """
83
 
    member_list = member_name.rsplit('.', 1)
84
 
    if len(member_list) == 2:
85
 
        parent_name, attribute = member_list
86
 
    else:
87
 
        parent_name = None
88
 
        attribute = member_name
89
 
    parent = known_hooks_key_to_object((module_name, parent_name))
90
 
    return parent, attribute
 
102
    return pyutils.get_named_object(module_name, member_name)
 
103
 
 
104
 
 
105
@symbol_versioning.deprecated_function(symbol_versioning.deprecated_in((2, 3)))
 
106
def known_hooks_key_to_parent_and_attribute(key):
 
107
    """See KnownHooksRegistry.key_to_parent_and_attribute."""
 
108
    return known_hooks.key_to_parent_and_attribute(key)
91
109
 
92
110
 
93
111
class Hooks(dict):
180
198
    """A single hook that clients can register to be called back when it fires.
181
199
 
182
200
    :ivar name: The name of the hook.
 
201
    :ivar doc: The docs for using the hook.
183
202
    :ivar introduced: A version tuple specifying what version the hook was
184
203
        introduced in. None indicates an unknown version.
185
204
    :ivar deprecated: A version tuple specifying what version the hook was
186
205
        deprecated or superseded in. None indicates that the hook is not
187
206
        superseded or deprecated. If the hook is superseded then the doc
188
207
        should describe the recommended replacement hook to register for.
189
 
    :ivar doc: The docs for using the hook.
190
208
    """
191
209
 
192
210
    def __init__(self, name, doc, introduced, deprecated):
277
295
 
278
296
  yyy.hooks.install_named_hook("xxx", ...)
279
297
 
280
 
See `Using hooks`_ in the User Guide for examples.
281
 
 
282
 
.. _Using hooks: ../user-guide/hooks.html
 
298
See :doc:`Using hooks<../user-guide/hooks>` in the User Guide for examples.
283
299
 
284
300
The class that contains each hook is given before the hooks it supplies. For
285
301
instance, BranchHooks as the class is the hooks class for