diff --git a/contrib/python-hook-examples.py b/contrib/python-hook-examples.py
new file mode 100644
--- /dev/null
+++ b/contrib/python-hook-examples.py
@@ -0,0 +1,24 @@
+'''
+These are examples of useful hooks in Python for Mercurial.
+'''
+
+from mercurial import patch, util
+
+
+def diffstat(ui, repo, **kwargs):
+    '''Use it like:
+
+    [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].parents()[0].node()
+    if 'url' in kwargs:
+        last = repo['tip'].node()
+    else:
+        last = node
+    diff = patch.diff(repo, first, last)
+    ui.write(patch.diffstat(util.iterlines(diff)))