|
2370.4.1
by Robert Collins
New SmartServer hooks facility. There are two initial hooks documented |
1 |
# Copyright (C) 2007 Canonical Ltd
|
2 |
#
|
|
3 |
# This program is free software; you can redistribute it and/or modify
|
|
4 |
# it under the terms of the GNU General Public License as published by
|
|
5 |
# the Free Software Foundation; either version 2 of the License, or
|
|
6 |
# (at your option) any later version.
|
|
7 |
#
|
|
8 |
# This program is distributed in the hope that it will be useful,
|
|
9 |
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
10 |
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
11 |
# GNU General Public License for more details.
|
|
12 |
#
|
|
13 |
# You should have received a copy of the GNU General Public License
|
|
14 |
# along with this program; if not, write to the Free Software
|
|
15 |
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
16 |
||
17 |
||
18 |
"""Support for plugin hooking logic."""
|
|
19 |
from bzrlib.lazy_import import lazy_import |
|
20 |
lazy_import(globals(), """ |
|
21 |
from bzrlib import (
|
|
22 |
errors,
|
|
23 |
)
|
|
24 |
""") |
|
25 |
||
26 |
||
27 |
class Hooks(dict): |
|
28 |
"""A dictionary mapping hook name to a list of callables.
|
|
29 |
|
|
30 |
e.g. ['FOO'] Is the list of items to be called when the
|
|
31 |
FOO hook is triggered.
|
|
32 |
"""
|
|
33 |
||
34 |
def install_hook(self, hook_name, a_callable): |
|
35 |
"""Install a_callable in to the hook hook_name.
|
|
36 |
||
37 |
:param hook_name: A hook name. See the __init__ method of BranchHooks
|
|
38 |
for the complete list of hooks.
|
|
39 |
:param a_callable: The callable to be invoked when the hook triggers.
|
|
40 |
The exact signature will depend on the hook - see the __init__
|
|
41 |
method of BranchHooks for details on each hook.
|
|
42 |
"""
|
|
43 |
try: |
|
44 |
self[hook_name].append(a_callable) |
|
45 |
except KeyError: |
|
46 |
raise errors.UnknownHook(self.__class__.__name__, hook_name) |