== SnapExtension ==

'''This extension is not distributed with Mercurial.'''

''Author: Klaus Koch''

Repository: https://bitbucket.org/kuk42/hgsnap/

Mirror: http://hg.intevation.org/mirrors/bitbucket.org/kuk42/hgsnap/

Fork: https://bitbucket.org/jksrecko/hgsnap/

=== Overview ===

snap is a Mercurial extension for storing (big) file snapshots outside a Mercurial repository.

This is useful for files which are either too big, or do not change in small enough deltas to be stored in a source revision system like Mercurial. They would increase the repository size, memory consumption, and run-time.

Read the [[http://bitbucket.org/kuk42/hgsnap/wiki/Home|documentation on the wiki]] ([[http://hg.intevation.org/mirrors/bitbucket.org/kuk42/hgsnap-wiki/|mirror]]) and use
{{{
$ hg help snap
}}}
to get further information.

The snap extension requires at least Mercurial 1.6, or TortoiseHG 1.1.4.


=== Configuration ===
Configure your .hgrc to enable the extension by adding following lines:

You enable snap like any other Mercurial extension, simply add
{{{
[extensions]
hgext.snap=/path/to/snap.py
}}}


You may also have interest in LargefilesExtension and BigfilesExtension. 

=== About the fork ===
Since Klaus never responded to patches, I created a fork to update the extension for newer Mercuruial/TortoiseHG versions.
Along the way, I squashed some bugs, and added a hook that checks that the right files have indeed been snapped (useful for centralized repository).

----
CategoryExtensionsByOthers