14
15
# along with this program; if not, write to the Free Software
15
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
Stores are the main data-storage mechanism for Bazaar-NG.
18
"""Stores are the main data-storage mechanism for Bazaar-NG.
20
20
A store is a simple write-once container indexed by a universally
21
unique ID, which is typically the SHA-1 of the content."""
23
__copyright__ = "Copyright (C) 2005 Canonical Ltd."
24
__author__ = "Martin Pool <mbp@canonical.com>"
24
26
import os, tempfile, types, osutils, gzip, errno
25
27
from stat import ST_SIZE
56
58
>>> st['123123'].read()
59
TODO: Atomic add by writing to a temporary file and renaming.
61
In bzr 0.0.5 and earlier, files within the store were marked
62
readonly on disk. This is no longer done but existing stores need
61
:todo: Atomic add by writing to a temporary file and renaming.
63
:todo: Perhaps automatically transform to/from XML in a method?
64
Would just need to tell the constructor what class to
67
:todo: Even within a simple disk store like this, we could
68
gzip the files. But since many are less than one disk
69
block, that might not help a lot.
66
73
def __init__(self, basedir):
74
"""ImmutableStore constructor."""
67
75
self._basedir = basedir
69
77
def _path(self, id):
70
if '\\' in id or '/' in id:
71
raise ValueError("invalid store id %r" % id)
72
78
return os.path.join(self._basedir, id)
74
80
def __repr__(self):
77
83
def add(self, f, fileid, compressed=True):
78
84
"""Add contents of a file into the store.
80
f -- An open file, or file-like object."""
81
# FIXME: Only works on files that will fit in memory
83
from bzrlib.atomicfile import AtomicFile
86
:param f: An open file, or file-like object."""
87
# FIXME: Only works on smallish files
88
# TODO: Can be optimized by copying at the same time as
85
90
mutter("add store entry %r" % (fileid))
86
91
if isinstance(f, types.StringTypes):
91
96
p = self._path(fileid)
92
97
if os.access(p, os.F_OK) or os.access(p + '.gz', os.F_OK):
93
from bzrlib.errors import bailout
94
raise BzrError("store %r already contains id %r" % (self._basedir, fileid))
98
bailout("store %r already contains id %r" % (self._basedir, fileid))
100
af = AtomicFile(fn, 'wb')
103
gf = gzip.GzipFile(mode='wb', fileobj=af)
113
def copy_multi(self, other, ids):
114
"""Copy texts for ids from other into self.
116
If an id is present in self, it is skipped. A count of copied
117
ids is returned, which may be less than len(ids).
119
from bzrlib.progress import ProgressBar
121
pb.update('preparing to copy')
122
to_copy = [id for id in ids if id not in self]
123
if isinstance(other, ImmutableStore):
124
return self.copy_multi_immutable(other, to_copy, pb)
128
pb.update('copy', count, len(to_copy))
129
self.add(other[id], id)
130
assert count == len(to_copy)
135
def copy_multi_immutable(self, other, to_copy, pb):
136
from shutil import copyfile
140
other_p = other._path(id)
144
if e.errno == errno.ENOENT:
145
copyfile(other_p+".gz", p+".gz")
150
pb.update('copy', count, len(to_copy))
151
assert count == len(to_copy)
101
f = gzip.GzipFile(p + '.gz', 'wb')
102
os.chmod(p + '.gz', 0444)
156
111
def __contains__(self, fileid):
207
162
"""Self-destructing test subclass of ImmutableStore.
209
164
The Store only exists for the lifetime of the Python object.
210
Obviously you should not put anything precious in it.
165
Obviously you should not put anything precious in it.
212
167
def __init__(self):
213
168
ImmutableStore.__init__(self, tempfile.mkdtemp())
215
170
def __del__(self):
216
171
for f in os.listdir(self._basedir):
217
fpath = os.path.join(self._basedir, f)
218
# needed on windows, and maybe some other filesystems
219
os.chmod(fpath, 0600)
172
os.remove(os.path.join(self._basedir, f))
221
173
os.rmdir(self._basedir)
222
174
mutter("%r destroyed" % self)