Kiln » Kiln Extensions
Clone URL:  
/ bfiles/ kbfiles
__init__.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
'''track large binary files Large binary files tend to be not very compressible, not very "diffable", and not at all mergeable. Such files are not handled well by Mercurial\'s storage format (revlog), which is based on compressed binary deltas. bfiles solves this problem by adding a centralized client-server layer on top of Mercurial: big files live in a *central store* out on the network somewhere, and you only fetch the big files that you need when you need them. bfiles works by maintaining a *standin* in .hgbfiles/ for each big file. The standins are small (41 bytes: an SHA-1 hash plus newline) and are tracked by Mercurial. Big file revisions are identified by the SHA-1 hash of their contents, which is written to the standin. bfiles uses that revision ID to get/put big file revisions from/to the central store. A complete tutorial for using bfiles is included in ``usage.txt`` in the bfiles source distribution. See http://vc.gerg.ca/hg/hg-bfiles/raw-file/tip/usage.txt for the latest version. ''' from mercurial import commands, localrepo, wireproto, util, __version__ import re from mercurial.hgweb import hgweb_mod import bfsetup import bfcommands import bfproto @apply def _HG_VERSION(): '''return the mercurial version as a tuple rather than a string Python does the right thing when comparing tuples, so the return value can be used to compare and detect versions. ''' version = [0, 0, 0] parts = [re.match(r'\d+', v).group(0) for v in __version__.version.split('.')[:3]] for i, part in enumerate(map(int, parts)): version[i] = part return tuple(version) if _HG_VERSION >= (3, 0, 0): raise util.Abort( 'kbfiles is deprecated, and does not work with recent version of Mercurial. ' 'Please use the largefiles extension instead. ' 'You will need to undo your Mercurial update and follow the directions at ' 'http://help.fogcreek.com/8168/how-to-use-the-mercurial-largefiles-extension#How_do_I_perform_the_conversion_from_KBFiles_to_LargeFiles ' 'to convert existing repositories that use kbfiles.') reposetup = bfsetup.reposetup uisetup = bfsetup.uisetup commands.norepo += " kbfconvert" cmdtable = bfcommands.cmdtable def extsetup(ui): wireproto.commands['putbfile'] = (bfproto.putbfile, 'sha') wireproto.commands['getbfile'] = (bfproto.getbfile, 'sha') wireproto.commands['statbfile'] = (bfproto.statbfile, 'sha') wireproto.commands['capabilities'] = (bfproto.capabilities, '') wireproto.commands['heads'] = (bfproto.heads, '') # make putbfile behave the same as push and {get,stat}bfile behave the same # as pull w.r.t. permissions checks hgweb_mod.perms['putbfile'] = 'push' hgweb_mod.perms['getbfile'] = 'pull' hgweb_mod.perms['statbfile'] = 'pull' # the hello wireproto command uses wireproto.capabilities, so it won't see # our bfilestore capability unless we replace the actual function as well. # we also need to save the existing function for local use. # this is really ugly. # however, the alternative would be to parse hello's output and rewrite the # capabilities line. bfproto.capabilities_orig = wireproto.capabilities wireproto.capabilities = bfproto.capabilities wireproto.dispatch = bfproto.dispatch try: localrepo.localrepository.supported |= set(['kbfiles']) except AttributeError: pass def featuresetup(ui, supported): # don't die on seeing a repo with the largefiles requirement supported |= set(['kbfiles'])