upstream/mercurial-mirror Files · contrib/python-hook-examples.py

tracked-key: remove the dual write and rename to tracked-hint...

tracked-key: remove the dual write and rename to tracked-hint The dual-write approach was mostly useless. As explained in the previous version of the help, the key had to be read twice before we could cache a value. However this "read twice" limitation actually also apply to any usage of the key. If some operation wants to rely of the "same value == same tracked set" property it would need to read the value before, and after running that operation (or at least, after, in all cases). So it cannot be sure the operation it did is "valid" until checking the key after the operation. As a resultat such operation can only be read-only or rollbackable. This reduce the utility of the "same value == same tracked set" a lot. So it seems simpler to drop the double write and to update the documentation to highlight that this file does not garantee race-free operation. As a result the "key" is demoted to a "hint". Documentation is updated accordingly. Differential Revision: https://phab.mercurial-scm.org/D12201

Augie Fackler - - Load All Authors

File last commit:

r46554:89a2afe3 default


                r49644:6e559391

default

Download file

             python-hook-examples.py
        
                    27 lines
            
             | 633 B
            
                | text/x-python
            
             |
                PythonLexer
            
             / contrib / python-hook-examples.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      '''

      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)))

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				'''
				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)))