← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/hooks.txt

  • Committer: Vincent Ladeuil
  • Date: 2008-01-29 15:16:31 UTC
  • mto: (3206.1.1 trunk)
  • mto: This revision was merged to the branch mainline in revision 3207.
  • Revision ID: v.ladeuil+lp@free.fr-20080129151631-vqjd13tb405mobx6
Fix two more leaking tmp dirs, by reworking TransformPreview lock handling.

* bzrlib/tests/test_transform.py:
(TestTransformMerge): Revert previous patch and cleanly call
preview.finalize now that we can.

* bzrlib/tests/test_merge.py:
(TestMerge.test_make_preview_transform): Catch TransformPreview
leak.

* bzrlib/builtins.py:
(cmd_merge._do_preview): Finalize the TransformPreview or the
limbodir will stay in /tmp.

* bzrlib/transform.py:
(TreeTransformBase.__init__): Create the _deletiondir since it's
reffered to by finalize.
(TreeTransformBase.finalize): Delete the dir only if _deletiondir
is set.
(TreeTransform.__init__): Use a temp var for deletiondir and set
the attribute after the base class __init__ has been called.
(TransformPreview.__init__): Read locks the tree since finalize
wants to unlock it (as suggested by Aaron).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/hooks.txt
 
1
Using hooks
 
2
===========
 
3
 
 
4
What is a hook?
 
5
---------------
 
6
 
 
7
One way to customize Bazaar's behaviour is with *hooks*.  Hooks allow you to
 
8
perform actions before or after certain Bazaar operations.  The operations
 
9
include ``commit``, ``push``, ``pull``, and ``uncommit``.
 
10
 
 
11
Using hooks
 
12
-----------
 
13
 
 
14
To use a hook, you should `write a plugin <#writing-a-plugin>`_.  Instead of
 
15
creating a new command, this plugin will define and install the hook.  Here's
 
16
an example::
 
17
 
 
18
    from bzrlib import branch
 
19
 
 
20
 
 
21
    def post_push_hook(push_result):
 
22
        print "The new revno is %d" % push_result.new_revno
 
23
 
 
24
 
 
25
    branch.Branch.hooks.install_hook('post_push', post_push_hook)
 
26
    branch.Branch.hooks.name_hook(post_push_hook, 'My post_push hook')
 
27
 
 
28
To use this example, create a file named ``push_hook.py``, and stick it in
 
29
``plugins`` subdirectory of your configuration directory.  (If you have never
 
30
installed any plugins, you may need to create the ``plugins`` directory).
 
31
 
 
32
First, we define a function that will be run after ``push`` completes.  We
 
33
could also use an instance method or a callable object.  All push hooks take a
 
34
single argument, the ``push_result``.
 
35
 
 
36
Next, we install the hook.  ``'post_push'`` identifies where we want to install
 
37
the hook, and the second parameter is the hook itself.
 
38
 
 
39
Finally, we name the hook.  This is optional, but it means the hook name can
 
40
be used in progress messages and error messages.
 
41
 
 
42
That's it!  The next time you push, it should show "The new revno is...".
 
43
Of course, hooks can be much more elaborate than this, because you have the
 
44
full power of Python at your disposal.  Now that you know how to use hooks,
 
45
what you do with them is up to you.
 
46
 
 
47
Standard hooks
 
48
--------------
 
49
 
 
50
For a complete list of hooks and their parameters, see `Hooks
 
51
<../user-reference/bzr_man.html#hooks>`_ in the User Reference.