contrib/python-hook-examples.py

resolve: use the `parentchange` context manager to apply merge action

In an ideal world, we would not have to do that. However, we are miles away from
being ready to not have to do it.

So we add this context manager alongside a long comment. This will help use to
get to the point were have two distinct API with strict rules about when to call
them.

Differential Revision: https://phab.mercurial-scm.org/D11074

'''
Examples of useful python hooks for Mercurial.
'''
from __future__ import absolute_import
from mercurial import (
    patch,
    util,
)


def diffstat(ui, repo, **kwargs):
    """Example usage:

    [hooks]
    commit.diffstat = python:/path/to/this/file.py:diffstat
    changegroup.diffstat = python:/path/to/this/file.py:diffstat
    """
    if kwargs.get('parent2'):
        return
    node = kwargs['node']
    first = repo[node].p1().node()
    if 'url' in kwargs:
        last = repo.changelog.tip()
    else:
        last = node
    diff = patch.diff(repo, first, last)
    ui.write(patch.diffstat(util.iterlines(diff)))