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):
172
127
def __len__(self):
173
128
return len(os.listdir(self._basedir))
176
130
def __getitem__(self, fileid):
177
131
"""Returns a file reading from a particular entry."""
178
132
p = self._path(fileid)
180
134
return gzip.GzipFile(p + '.gz', 'rb')
181
135
except IOError, e:
182
if e.errno != errno.ENOENT:
188
if e.errno != errno.ENOENT:
191
raise IndexError(fileid)
136
if e.errno == errno.ENOENT:
194
141
def total_size(self):
195
142
"""Return (count, bytes)
215
162
"""Self-destructing test subclass of ImmutableStore.
217
164
The Store only exists for the lifetime of the Python object.
218
Obviously you should not put anything precious in it.
165
Obviously you should not put anything precious in it.
220
167
def __init__(self):
221
168
ImmutableStore.__init__(self, tempfile.mkdtemp())
223
170
def __del__(self):
224
171
for f in os.listdir(self._basedir):
225
fpath = os.path.join(self._basedir, f)
226
# needed on windows, and maybe some other filesystems
227
os.chmod(fpath, 0600)
172
os.remove(os.path.join(self._basedir, f))
229
173
os.rmdir(self._basedir)
230
174
mutter("%r destroyed" % self)