Bigfiles Extension
This extension is not distributed with Mercurial.
Author: Andrei Vermel
Download site: http://bitbucket.org/avermel/bigfiles/
Overview
Support versions of big files with storage outside hg repo.
Big files are not put to hg repo. They are listed in a file called '.bigfiles', which also serves as an ignore file similar to .hgignore, so they do not clutter output of hg commands. The file also stores check sums of the big files in a form of comments. File '.bigfiles' is versioned by hg, so each changeset knows which big files it uses from the names and checksums. The file can be diffed and merged, which is nice.
The versions of big files are stored in a versions directory, with checksums attached to filenames.
Usage
- The extension overrides 'hg update', so that it can compare contents of '.bigfiles' before and after the update to remove and fetch appropriate big files.
- The directory storing versions of big files can be synced with the remote one (the extension doesn't do this, but tells the list of the necessary files). The versions corresponding to old changesets can be removed to save space.
- To add a new big file, use normal 'hg add', ignoring the size warning.
- To remove a tracked big file, just delete it.
- 'hg bstatus' - to examine state of big files in working directory.
- 'hg brefresh' - to refresh '.bigfiles' and versions directory with added,
- removed and modified big files.
- 'hg bupdate' - to fetch files from versions directory as recorded in
- '.bigfiles', and get a list of necessary files missing in the version directory.
Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] bigfiles = path/to/bigfiles.py [bigfiles] repo = path/to/versions/dir